5.6. Migrating the Configuration Directory Server

The Configuration Directory Server is the Directory Server instance that maintains the o=netscaperoot subtree that is used by the Admin Server and Console.
Before you begin, install the Admin Server and Configuration Directory Server. Make sure to configure the Admin Server the same way as you configured the previous Admin Server, the Directory Server, TLS, and so on.
The next steps differ based on whether the Directory Server 10 system will use the same host name as the previous Configuration Directory Server, or not.

5.6.1. Using the Same Host Name as the Previous Configuration Directory Server

This section describes the scenario when the Directory Server 10 system uses the same host name as the previous Configuration Directory Server.

5.6.1.1. Migrating from Red Hat Directory Server 9

In case you migrating from Directory Server 9 and using the replication migration method as described in Section 5.3.2, “The Replication Migration Method”:
  1. Install the new Admin Server and Configuration Directory Server.
  2. Set up the Configuration Directory Server as a dedicated replication consumer.
  3. On the previous Configuration Directory Server (on the Directory Server 9), enable replication for the o=netscaperoot back end as a master/supplier.
  4. Create a replication agreement to the new Configuration Directory Server (on the Directory Server 10).
  5. Initialize that replication agreement.
This method also assumes that all the previously registered instances are going to use the same host names. If host names are going to change, then you either need to unregister the old instances, or skip the replication step and manually register the new Directory Server 10 instances.

5.6.1.2. Migrating from Red Hat Directory Server 8 or Earlier

In case you are migrating from Red Hat Directory Server 8 or earlier, the replication option is not available as it is not supported for older Red Hat Directory Server releases.
Each Directory Server instance must be registered using the register-ds-admin.pl script after the Admin Server and Configuration Directory Server are installed.
For more information on using register-ds-admin.pl, see Section 4.4, “Registering Servers Using register-ds-admin.pl”.

5.6.2. Not Using the Same Host Name as the Previous Configuration Directory Server

If the Directory Server 10 system does not use the same host name as the previous Configuration Directory Server, then no migration is possible.
The new Admin Server and Configuration Directory Server will need to have all the Directory Server instances reregistered using the register-ds-admin.pl script as described in Section 4.4, “Registering Servers Using register-ds-admin.pl”.