Merge branch 'master' into erp5-component
[slapos.git] / software / maarch / migration.txt
1
2 **************************************************************************
3 This howto is for private networks only, in case the customer is migrating
4 from a previously installed Maarch.
5 **************************************************************************
6
7
8 Hot to install Maarch with SlapOS
9 =================================
10
11  1) Require the right Software Release ({insert SR number/URL here})
12
13  2) Request an instance of that Software Release.
14     Since we need to provide a parameter (type=resilient) that is not available through
15     the SlapOS web site, it must be done at command line.
16
17     If you are migrating data from an existing Maarch installation:
18
19     2.1) copy a 'data only' SQL dump - no schema - to the server that contains
20          the instance. Let's say it is /tmp/data.sql
21          The file must be readable by world, because we don't know yet the number
22          of the partition that will need to access it.
23          Remember to remove it afterwards.
24
25      The command line to request a partition is:
26
27      slapos request /etc/opt/slapos/slapos-client.cfg maarch-instance-name \
28             http://git.erp5.org/gitweb/slapos.git/blob_plain/refs/tags/slapos-0.159:/software/maarch/software.cfg \
29             --type=resilient --configuration maarch-sql-data-file=/tmp/data.sql
30
31      If you are not migrating data, don't provide the maarch-sql-data-file parameter.
32      A minimal working database will be created.
33
34  3) deploy the instance.
35     You should be able to connect to both Maarch (user 'superadmin')
36     and Postgres (user 'postgres') with the (very long)
37     passport reported in the connection parameters of the partition 'apache0'.
38
39     NB: even if you copied the SQL data from a previous installation, the 'superadmin' password
40         is set from the published connection parameter. If there are other admin accounts,
41         their password is not changed.
42
43  4) Again, only if you are migrating:
44     connect to the server, inside the partition of type apache-export
45     copy the docservers data inside the folders:
46         srv/docservers/ai
47         srv/docservers/manual
48         srv/docservers/OAIS_main
49         srv/docservers/OAIS_safe
50         srv/docservers/offline
51         srv/docservers/templates
52
53     also, change the owner and group of the copied files to the user that owns the partition.
54