Installation guide

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.

To migrate a replicated site, do the following:

1. Stop all old Directory Server instances and the Administration Server.

2. Back up all the Directory Server user and configuration data.

3. Stop directory writes to the master or hub server being migrated.

4. On the machine where your legacy Directory Server is installed, install the Directory Server

8.0 packages.

• Make the first migrated master the configuration instance since it is not replicated. Then,

instance.

• This instance needs to listen on your standard port, usually 389.

5. Run the migration script, as root.

IMPORTANT

Do not set up the new Directory Server instances with setup-ds-admin.pl

before running the migration script.

# /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.

6. 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.

7. Once the old Directory Server instance is migrated, test replication to make sure it is working

correctly.

8. After you finish this process for all of the master server, repeat the steps for the hub servers

Chapter 8. Migrating from Previous Versions

116