Migration Prerequisites; Migration Procedure - Red Hat DIRECTORY SERVER 7.1 Installation Manual

46

6.2. Migration Prerequisites

This section lists the prerequisites that your system must meet before you can consider beginning the
migration process.
You must be using Directory Server 6.x. When you run the migration script, the legacy server
•
process
ns-slapd
Your legacy Directory Server and your new Directory Server must be installed on the same host;
•
migration cannot occur over networked drives.
Do not install the new Directory Server on top of an existing Directory Server installation. Install
•
your new Directory Server in a separate directory. Migrate your legacy directory data into your new
directory, and, when you are satisfied with the result of the migration, remove your legacy Directory
Server.
If you want to continue to run your legacy Directory Server, choose different ports for LDAP traffic
•
and for secured connections than the ones used by your legacy Directory Server when you install
the new Directory Server.
If you are not going to run your legacy Directory Server, use the same port numbers to ensure that
any directory clients that have static configuration information (including Directory Server port
numbers) continue to work.
Your new Directory Server must be running when you execute the migration script.
•
Any custom schema that you created in a 6.x Directory Server must be stored in an LDIF file in the
•
serverRoot/slapd-serverID/config/schema
Before performing the migration, check that the user-defined variables contain the following associ-
•
ated values, where server7Root is the path to where your new Directory Server 7.x is installed:
Set the following environment variables:
PERL5LIB=server7Root/bin/slapd/admin/bin
PATH=server7Root/bin/slapd/admin/bin:$PATH
When you run the migration script, it migrates the configuration files or configuration entries,
•
database instances, and schema with minimum manual intervention. For complete information on
the configuration parameters and attributes that are migrated, refer to the section on migrating from
earlier versions in the Red Hat Directory Server Configuration, Command, and File Reference.
Check the command syntax for the migration script in the section on command-line scripts of the
•
Red Hat Directory Server Configuration, Command, and File Reference.

6.3. Migration Procedure

Before you start with migration process, ensure the following:
Read sections Section 6.1 Migration Overview and Section 6.2 Migration Prerequisites.
•
The migration script will automatically back up your Directory Server configuration if it is in the
•
default location.
If you are migrating from Directory Server 6.x, all of the configuration files in the
•
/opt/redhat-ds/servers/slapd-serverID/config
directory named
If your configuration files are stored in non-default locations, before you migrate your server,
•
copy them to a secure place.
This section contains the following information:
should be stopped. (If you do not stop the server, the migration script stops it.)
serverRoot/slapd-serverID/config_backup
Chapter 6. Migrating from Previous Versions
directory.
directory will be backed up to a
.