Installation guide

5.2.2. Before Migration

For the safety of the Directory Server data, do these things before beginning to migrate the Directory

Server instances:

Shut down all Directory Server instances and the Admin Server.

Back up all of your databases.

For servers which have a different configuration directory, make sure that the Directory Server

Console write operations are moved from the configuration directory to the server itself.

Remove deprecated schema files, such as 10presence.ldif, from the schema/ directory for the

old instance.

5.2.2.1. Backing up the Directory Server Configuration

All of the configuration files for Directory Server 7.1 instances are in the /opt/redhat-

ds/slapd-serverID/config directory. Other important configuration files for the Admin Server and for

shared configuration are in /opt/redhat-ds/adm in-serv/config and /opt/redhat-

ds/shared/config. Make a backup of all of these files in a secure location.

5.2.2.2. Configuring the Directory Server Console

If you have a multi-master replication setup which replicates o=NetscapeRoot replicated between the

two master servers, server1 and server2. By default, writes made through server2's Directory

Server Console are written to server1, then replicated over. Modify the Directory Server Console on the

second server (server2) so that it writes its own Console instance instead of server1's.

1. Shut down the Admin Server and Directory Server.

2. Change the adm .conf file for the Admin Server to reflect server2 Directory Servers values:

ldapurl: ldap://server2.example.com:389/o=NetscapeRoot

3. Change the dse.ldif for the Directory Server to reflect server2 Directory Server's values:

vim serverRoot/slapd-serverID/config/dse.ldif

nsslapd-pluginarg0: ldap:///server2.example.com:389/o=NetscapeRoot

4. T urn off the Pass-through Authentication Plug-in on server2 by editing its dse.ldif file and

setting the nsslapd-pluginEnabled value to off.

vim serverRoot/slapd-serverID/config/dse.ldif

dn: cn=Pass Through Authentication,cn=plugins,cn=config

nsslapd-pluginEnabled: off

5. Restart the Directory Server and Admin Server.

5.2.2.3. Removing Deprecated Schema Files

The migration script may not properly remove all schema files that were deprecated between Red Hat

Directory Server 7.1 and Red Hat Directory Server 8.2. To ensure that migration completes successfully,

remove all of the deprecated schema files from the serverRoot/slapd-serverID/config/schem a/

directory. T his can be done by comparing the list of schema files in the old schema directory to the list in

the new /etc/dirsrv/schema directory. Deprecated schema files include:

Red Hat Directory Server 8.2 Installation Guide