Installation guide

NOTE
If the new machine has a different architecture than the old machine, such as moving from x86 to
x86_64, you must perform a cross platform migration, described in Section 5.2.6, “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
x86 to x86.
WARNING
Migration cannot change the hostname used by the Directory Server and Admin Server. T he 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.2, first rename the old machine (for example,
change ldap.exam ple.com to ldap_old.exam ple.com ), then give the new machine the
original name of the old machine (ldap.exam ple.com ). Because of 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 5 (64-bit) machines, the m igrate-ds-adm in tool is in the
/usr/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
The oldsroot can also specify a local directory on the target machine that was created from a tarball. In
that case, create a tarball of your old server root directory, and untar it on the target machine. In this
example, a tarball was created of /opt/redhat-ds on the source machine, and it was untarred under
/migration on the target machine:
# /usr/sbin/migrate-ds-admin.pl --oldsroot /migration/opt/redhat-ds --actualsroot
/opt/redhat-ds General.ConfigDirectoryAdminPwd=password
The m igrate-ds-adm in command automatically migrates every Directory Server instance configured.
As with migrating Directory Server on the same machine, using the instance parameter allows you to
set the specific instance to migrate. For example, this command migrated a Directory Server instance
named example:
# /usr/sbin/migrate-ds-admin.pl --oldsroot server2:/migration/opt/redhat-ds --
actualsroot /opt/redhat-ds --instance example
General.ConfigDirectoryAdminPwd=password
Red Hat Directory Server 8.2 Installation Guide
72