Red Hat DIRECTORY SERVER 8.1 - INSTALLATION GUIDE 11-01-2010 Installation Manual page 89

"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.1, 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 5 (32-bit) 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
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 migrate-ds-admin 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
1. Stop all Directory Server instances and the Administration Server.
2. Back up all the Directory Server user and configuration data.
3. Install the Directory Server 8.1 packages on the new machine which will host Directory Server.
Migrating a Directory Server from One Machine to Another
Another". The procedure in this section
79