1MIGRATE-DS.PL(8) System Manager's Manual MIGRATE-DS.PL(8)
2
6 migrate-ds.pl - Directory Server Migration script
7
9 migrate-ds.pl [--options] -- [args]
10
12 Directory Server Migration script - migrates Directory Server from
13 older releases to the current release.
14 This script will copy instances (data and configuration) from the old
16 server root directory to their new FHS locations. This script does a
17 copy only - the data in the old instances will be left untouched. The
18 old instances must be shutdown first to ensure that the databases are
19 copied safely. During migration your migrated instances will be
20 started.
21
23 A summary of options is included below:
24 --help This message
26 --version
28 Print the version and exit
29 --debug
31 Turn on debugging
32 --oldsroot
34 The old server root directory to migrate from
35 --actualsroot This is the old location of the old server root.
37 --silent
39 Use silent setup - no user input
40 --file=name
42 Use the file 'name' in .inf format to supply the default answers
43 --keepcache
45 Do not delete the temporary .inf file generated by this program
46 --logfile
48 Log migration messages to this file - otherwise, a temp file
49 will be used
50 --instance
52 By default, all directory server instances will be migrated.
53 You can use this argument to specify one or more (e.g. -i
54 slapd-foo -i slapd-bar) if you do not want to migrate all of
55 them.
56 --cross
58 See below.
59 For all options, you can also use the short name e.g. -h, -d, etc. For
61 the -d argument, specifying it more than once will increase the debug
62 level e.g. -ddddd
63 args: You can supply default .inf data in this format:
65 section.param=value
67 e.g.
69 General.FullMachineName=foo.example.com
71 or
73 "slapd.Suffix=dc=example, dc=com"
75 Values passed in this manner will override values in an .inf file given
77 with the -f argument.
78 actualsroot: This is used when you must migrate from one machine to
80 another. The usual case is that you have mounted the old server root
81 on a different root directory, either via a network mount, or by copy‐
82 ing a tarball made using a relative directory on the source machine to
83 the destination machine and untarring it.
84 For example: machineA is a 32bit machine, and you want to migrate your
86 servers to a new 64bit machine. Lets assume your old server root on
87 machineA was /opt/myds, and your new machine also wants to use a server
88 root of /opt/myds. There are a couple of different ways to proceed.
89 Either make a tarball of opt/myds from machineA using a relative path
90 (i.e. NOT /opt/myds) or use NFS to mount machineA:/opt/myds on a dif‐
91 ferent mount point (e.g. machineB:/migration/opt/myds).
92 If you do this, you should give the old "real" server root (/opt/myds)
94 as the --actualsroot argument, and use /migration/opt/myds for the
95 --oldsroot argument. That is, the oldsroot is the physical location of
96 the files on disk. The actualsroot is the old value of the server root
97 on the source machine.
98 cross: Also known as crossplatform, or 'c', or 'x'. This is when the
100 source machine is a different architecture than the destination
101 machine. In this case, only certain data will be available for migra‐
102 tion. Changelog information will not be migrated, and replicas will
103 need to be reinitialized (if migrating masters or hubs). This type of
104 migration requires that all of your old databases have been dumped to
105 LDIF format, and the LDIF file must be in the default database direc‐
106 tory (usually /var/lib/dirsrv/slapd-instance/db), and the LDIF file
107 must have the same name as the database instance directory, with a
108 ".ldif". For example, if you have
109 /var/lib/dirsrv/slapd-instance/db/userRoot/
111 and
112 /var/lib/dirsrv/slapd-instance/db/NetscapeRoot/
113 you must first use db2ldif to export these databases to LDIF e.g.
115 cd /var/lib/dirsrv/slapd-instance
117 ./db2ldif -n userRoot -a /var/lib/dirsrv/slapd-instance/ldif/userRoot.ldif and
118 ./db2ldif -n NetscapeRoot -a /var/lib/dirsrv/slapd-instance/ldif/NetscapeRoot.ldif
119 Then you must somehow make your old server root directory available on
121 the destination machine, either by creating a tar archive on the source
122 and copying it to the destination, or by network mounting the source
123 directory on the destination machine.
124
126 migrate-ds.pl was written by the 389 Project.
127
129 Report bugs to https://pagure.io/389-ds-base/new_issue
130
132 Copyright © 2017 Red Hat, Inc.
133 This manual page was written by Michele Baldessari
134 <michele@pupazzo.org>, for the Debian project (but may be used by oth‐
135 ers).
136 This is free software. You may redistribute copies of it under the
137 terms of the Directory Server license found in the LICENSE file of this
138 software distribution. This license is essentially the GNU General
139 Public License version 2 with an exception for plug-in distribution.
140 March 31, 2017 MIGRATE-DS.PL(8)