HP-UX Directory Server 8.1 installation guide

IMPORTANT:
Do not set up the new Directory Server instances with setup-ds-admin.pl before running
the migration script.
# /opt/dirsrv/sbin/migrate-ds-admin.pl\
--oldsroot /var/opt/netscape/server7/ \
General.ConfigDirectoryAdminPwd=password
Where /var/opt/netscape/server7 is the directory where the old Directory Server is
installed.
6. The migration process starts.
The legacy Directory Server is migrated, and a new Directory Server 8.1 instance is installed
using the configuration information from the legacy Directory Server.
7. After the old Directory Server instance is migrated, test the replication to make sure it works
correctly.
8. After you finish this process for all the master server, repeat the steps for the hub servers,
then for the replicas.
6.1.3.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
(/opt/dirsrv/sbin/migrate-ds-admin.pl) with options specifying:
• The physical, network-accessible old server root directory, such as tarball or network drive,
(specified with the --oldsroot option).
• The actual directory name of the server root on the old machine (specified with the
--actualsroot option), such as /var/opt/netscape/server7. In this case, the
--actualsroot option names the original absolute installation directory, which the
--oldsroot option gives the path to access that directory.
CAUTION: Migration cannot change the host name used by the Directory Server and
Administration Server. The old machine must have the same host name 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 host name,
including the Console, replication, TLS/SSL, and Kerberos, it is extremely difficult to rename the
server with the migration script. HP strongly recommends that you do not attempt to change
the Directory Server host name.
NOTE:
If the new machine has a different architecture from 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 another” (page 52). 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.
For example, this script migrates a Directory Server on server1 to server2, using an
NFS-mounted directory:
# /opt/dirsrv/sbin/migrate-ds-admin.pl --oldsroot /net/server2/migration/server7 \
--actualroot /var/opt/netscape/server7 General.ConfigDirectoryAdminPwd=password
6.1 Migrating from Netscape Directory Server 6.x, or from Red Hat Directory Server 7.1 51