Installation guide

Chapter 8. Migrating from Previous Versions
Red Hat Directory Server 6.x and 7.x instances can be migrated to Directory Server 8.0. Migration carries
over all data and settings from the older Directory Server to the new Directory Server, including
Administration Server and Console information. T his is performed by running a Directory Server-specific
script, m igrate-ds-adm in.pl. m igrate-ds-adm in.pl is flexible enough to allow an array of
migration options, including migrating instances to new platforms and to migrate instances selectively or
to migrate all installed instances simultaneously.
Unlike previous versions of Directory Server, the migration script is silent, meaning that there are no
prompts and the user is not required to enter any information or approve any step in the process. After it
run, the Directory Server information and settings have been moved, intact, from the old Directory Server
instance to the new one. For the simplest migration scenario, the migration script only requires two
pieces of information with the command: the old server root path and the password for the directory
administrator.
/usr/sbin/migrate-ds-admin.pl --oldsroot /opt/redhat-ds
General.ConfigDirectoryAdminPwd=password
The different migration scenarios and migration script options are described in this chapter.
8.1. Migration Overview
Migrating from a 6.x or 7.x version of Directory Server to Directory Server 8.0 is a simple process.
Migration moves all of the user data and configuration settings, such as replication and synchronization
agreements, from the older instance to the new one. T he general process is as follows:
1. Stop all of the old Directory Server and Administration Server instances.
2. Back up the old Directory Server databases.
3. For a multi-master replication environment. Edit the Directory Server Console used by the
migrated server to control directory writes.
4. For supplier and hub servers in a replicated environment. Stop directory writes.
5. Install the new Directory Server packages.
6. Run the migration script, m igrate-ds-adm in.pl.
The migration script is silent, meaning that there are no prompts and the user is not required to
enter any information or approve any step in the process. After it run, the Directory Server
information and settings have been moved, intact, from the old Directory Server instance to the
new one.
Red Hat Directory Server 8.0 Installation Guide
96