Migrating Replicated Servers - Red Hat DIRECTORY SERVER 8.0 Installation Manual

of data, the index files and transaction logs can be moved to a separate disk device to
improve the Directory Server performance, especially if there are high update rates. In
this case, migration will not attempt to move the databases to the new default location,
/var/lib/dirsrv/slapd-instancename/db, but will instead assume that the
databases should be in their non-standard location and configure the new server to use
the databases in the old location.
This issue does not occur in cross-platform migrations or migrating using LDIF files
instead of the binary databases because these already work with an LDIF copy of the
database.
1. Stop all old Directory Server instances and the Administration Server.
2. Back up all the Directory Server user and configuration data.
3. On the machine where your legacy Directory Server is installed, install the Directory Server 8.0
packages.
IMPORTANT
Do not set up the new Directory Server instances with setup-ds-admin.pl before
running the migration script.
4. Run the migration script, as root.
# /usr/sbin/migrate-ds-admin.pl --oldsroot /opt/redhat-ds/
General.ConfigDirectoryAdminPwd=password
/opt/redhat-ds/ is the directory where the old Directory Server is installed.
The migration process starts. The legacy Directory Server is migrated, and a new Directory Server 8.0
instance is installed using the configuration information from the legacy Directory Server.

8.4.2. Migrating Replicated Servers

The process for migrating a replicated system is the same as for a single server, but the order in
which the Directory Server instances is important to keep from interrupting replication. First migrate all
master servers, then all hubs, and then all consumers. If any Directory Server the replicated system
will be moved to a different machine or a different platform, use the --actualsroot and --cross
parameters with migrate-ds-admin.pl, as described in
Server from One Machine to Another"
Platform to Another".
NOTE
On Red Hat Enterprise Linux and Solaris machines, the migrate-ds-admin tool is in
the /usr/sbin/ directory. On HP-UX machines, the migrate-ds-admin is in the /
opt/dirsrv/sbin/ directory.
Section 8.4.3, "Migrating a Directory
Section 8.4.4, "Migrating a Directory Server from One
and
Migrating Replicated Servers
97