| Red Hat Directory Server 7.1: Red Hat Directory Server Installation Guide | ||
|---|---|---|
| Prev | Chapter 6. Migrating from Previous Versions | Next |
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 should be stopped. (If you do not stop the server, the migration script stops it.)
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 directory.
Before performing the migration, check that the user-defined variables contain the following associated 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.