Migrating A Directory Server From One Machine To Another - Red Hat DIRECTORY SERVER 8.0 Installation Manual

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 and
then for the replicas.

8.4.3. Migrating a Directory Server from One Machine to Another

To migrate a Directory Server installation from one machine to a new Directory Server instance on
a new machine of the same platform, run the migration script (migrate-ds-admin) with options
specifying the physical, network-accessible old server root directory (oldsroot), such as tarball
or network drive, and specifying the actual directory name of the server root on the old machine
(actualsroot), such as /opt/redhat-ds. In this case, actualsroot names the original absolute
installation directory, which oldsroot gives the path to access that directory.
NOTE
If the new machine has a different architecture than the old machine, such as moving from
i386 to x86_64, you must perform a cross platform migration, described in
"Migrating a Directory Server from One Platform to
assumes that the Directory Server is being migrated from one machine to another of the
same architecture, such as i386 to i386.
WARNING
Migration cannot change the hostname used by the Directory Server and Administration
Server. The old machine must have the same hostname as your new machine. If you are
going to commission a new machine on which to run Directory Server 8.0, first rename the
old machine (for example, change ldap.example.com to ldap_old.example.com),
then give the new machine the original name of the old machine (ldap.example.com).
Because the large number of configuration issues based on the Directory Server's
hostname — including the Console, replication, TLS/SSL, and Kerberos — it is extremely
difficult to rename the server with the migration script. Red Hat strongly recommends that
you do not attempt to change the Directory Server hostname.
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.
For example, this script migrates a Directory Server on server1 to server2, using an NFS-mounted
directory:
# /usr/sbin/migrate-ds-admin.pl --oldsroot server2:/migration/opt/redhat-ds
--actualsroot /opt/redhat-ds General.ConfigDirectoryAdminPwd=password
Migrating a Directory Server from One Machine to Another
Another". The procedure in this section
Section 8.4.4,
99