or to a different platform. The migration script has different options available to facilitate migration. The following sections describe the different scenarios.

•“Migrating a server or single instance” (page 50)

•“Migrating replicated servers” (page 50)

•“Migrating a Directory Server from one machine to another” (page 51)

•“Migrating a Directory Server from one platform to another” (page 52)

6.1.3.1Migrating a server or single instance

To migrate a Directory Server installation to a new one on the same machine, run the migration script, specifying the old server root directory:

#/opt/dirsrv/sbin/migrate-ds-admin.pl\ --oldsroot /var/opt/netscape/server7 \ General.ConfigDirectoryAdminPwd=password

That command automatically migrates every Directory Server instance configured.

To migrate specific instances, use the --instanceoption with the migrate-ds-adminscript. For example, to migrate the Directory Server instance named example and example3, but not example2, the migration command would be as follows:

#/opt/dirsrv/sbin/migrate-ds-admin.pl\ --oldsroot /var/opt/netscape/server7 \ --instance example --instance example3 \ General.ConfigDirectoryAdminPwd=password

The migration process starts. The legacy Directory Server is migrated, and a new Directory Server

8.1instance is installed using the configuration information from the legacy Directory Server.

6.1.3.2Migrating replicated servers

The process for migrating a replicated system is the same as for a single server, but the order in which the Directory Server instances is important to keep from interrupting replication:

•First migrate all master servers.

•Then migrate all hubs.

•Then migrate all consumers, if any

If any of the Directory Servers in the replicated system will be moved to a different machine or another platform, use the --actualsroot and --cross parameters with /opt/dirsrv/sbin/migrate-ds-admin.pl, as described in “Migrating a Directory Server from one machine to another” (page 51) and “Migrating a Directory Server from one platform to another” (page 52).

To migrate a replicated site, perform the following steps:

1.Stop all old Directory Server instances and the Administration Server.

2.Back up all the Directory Server user and configuration data.

3.Stop directory writes to the master or hub server being migrated.

4.Install the HP-UX Directory Server 8.1 package on the machine where your legacy Directory Server is located.

•Make the first migrated master the configuration instance since it is not replicated. Then, register other master and hub servers with the first master Directory Servers configuration instance.

•This instance needs to listen on your standard port, usually 389.

5.Run the migration script, as root.

50 Migrating or upgrading to HP-UX Directory Server from Netscape or Red Hat Directory Server