Installation guide

Chapter 5. Migrating from Previous Versions
Red Hat Directory Server 8.2 supports both a migration path and an in-place upgrade, depending on the
version of Directory Server being updated.
For Red Hat Directory Server 8.1 servers, perform an in-place upgrade. This updates all of the Directory
Server packages and then uses the setup script to update the server configuration.
Red Hat Directory Server 7.1 instances can be migrated to Directory Server 8.2. Migration carries over all
data and settings from the older Directory Server to the new Directory Server, including Admin Server
and Console information. T his is performed by running a Directory Server-specific script, m igrate-ds-
admin.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.
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.
5.1. Migration and Upgrade Overview
Moving from an older version of Directory Server to Directory Server 8.2 is a simple process.
In-place upgrades of 8.1 servers means that the packages for the server components are updated. All of
the existing databases, configuration files, and settings remain in-place and unchanged.
Migration for 7.1 servers moves all of the user data and configuration settings, such as replication and
synchronization agreements, from the older instance to the new one.
The general process is as follows:
1. Stop all of the old Directory Server and Admin 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. For Red Hat Enterprise Linux systems, install OpenJDK 1.6.0, which is required by the Directory
Server Console.
6. Install the new Directory Server packages.
7. For 7.1 systems, run the migration script, migrate-ds-adm in.pl. T he 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 runs, the Directory Server information and settings have
been moved, intact, from the old Directory Server instance to the new one.
For an in-place upgrade for 8.1 systems, re-run the setup script, setup-ds-adm in.pl, to update
the Directory Server and Admin Server configuration.
Chapter 5. Migrating from Previous Versions
63