Installation guide

parameters are only taken from the old instance. It is not possible to change the configuration settings,
such as the hostname or port, using the migration script.
8.3. 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 Administration 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.
8.3.1. Backing up the Directory Server Configuration
All of the configuration files for Directory Server 6.x and 7.x instances are in the /opt/redhat-
ds/slapd-serverID/config directory. Other important configuration files for the Administration 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.
8.3.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 Administration Server and Directory Server.
2. Change the adm .conf file for the Administration Server to reflect server2 Directory Servers
values:
ldapurl: ldap://server2.exam ple.com:389/o=NetscapeRoot
3. Change the dse.ldif for the Directory Server to reflect server2 Directory Servers values:
serverRoot/slapd-serverID/config/dse.ldif:nsslapd-pluginarg0:
ldap:///server2.example.com:389/o=NetscapeRoot
4. Turn off the Pass-through Authentication Plug-in on server2 by editing its dse.ldif file and
setting the nsslapd-pluginEnabled value to off.
serverRoot/slapd-serverID/config/dse.ldif
dn: cn=Pass Through Authentication,cn=plugins,cn=config
nsslapd-pluginEnabled: off
5. Restart the Directory Server and Administration Server.
8.4. Migration Scenarios
The migration scenario differs depending on the type of existing Directory Server configuration you have.
It is possible to migrate a single Directory Server instance, all Directory Server instances on a machine
or replicated servers and to migrate the Directory Server to a different machine, or to a different platform.
Red Hat Directory Server 8.0 Installation Guide
100