Installation guide

and then for the replicas.
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 Section 4.4, “Migrating a Directory Server from One Platform to
Another”. The procedure in this section 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
Migrating a Directory Server from One
117