Migrating a Directory Server from One Machine to Another
79
“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.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.
