HP-UX Directory Server 8.1 installation guide

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.1 Migrating 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 --instance option with the migrate-ds-admin script.

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.1 instance is installed using the configuration information from the legacy Directory Server.

6.1.3.2 Migrating 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,

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