
46
Chapter 6. Migrating from Previous Versions
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
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 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 will be backed up to a
directory named
serverRoot
/slapd-
serverID
/config_backup
.
•
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:
Summary of Contents for DIRECTORY SERVER 7.1
Page 1: ...Red Hat Directory Server 7 1 Red Hat Directory Server Installation Guide ...
Page 28: ...22 Chapter 2 Computer System Requirements ...
Page 36: ...30 Chapter 3 Using Express and Typical Installation ...
Page 48: ...42 Chapter 4 Silent Installation and Instance Creation DisableSchemaChecking No ...
Page 64: ...58 Chapter 6 Migrating from Previous Versions ...
Page 70: ...64 Chapter 7 Troubleshooting ...
Page 94: ...88 Glossary ...