Chapter 8. Migrating from Previous Versions

Chapter 8. Migrating from Previous Versions

8.1. Migration Overview
8.2. About migrate-ds-admin.pl
8.3. Before Migration
8.3.1. Backing up the Directory Server Configuration
8.3.2. Configuring the Directory Server Console
8.4. Migration Scenarios
8.4.1. Migrating a Server or Single Instance
8.4.2. Migrating Replicated Servers
8.4.3. Migrating a Directory Server from One Machine to Another
8.4.4. Migrating a Directory Server from One Platform to Another

Red Hat Directory Server 6.x and 7.x instances can be migrated to Directory Server 8.0. Migration carries over all data and settings from the older Directory Server to the new Directory Server, including Administration Server and Console information. This is performed by running a Directory Server-specific script, migrate-ds-admin.pl. migrate-ds-admin.pl is flexible enough to allow an array of migration options, including migrating instances to new platforms and to migrate instances selectively or to migrate all installed instances simultaneously.

Unlike previous versions of Directory Server, the migration script is silent, meaning that there are no prompts and the user is not required to enter any information or approve any step in the process. After it run, the Directory Server information and settings have been moved, intact, from the old Directory Server instance to the new one. For the simplest migration scenario, the migration script only requires two pieces of information with the command: the old server root path and the password for the directory administrator.

/usr/sbin/migrate-ds-admin.pl --oldsroot /opt/redhat-ds General.ConfigDirectoryAdminPwd=password

The different migration scenarios and migration script options are described in this chapter.


Note: This documentation is provided {and copyrighted} by Red Hat®, Inc. and is released via the Open Publication License. The copyright holder has added the further requirement that Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. The CentOS project redistributes these original works (in their unmodified form) as a reference for CentOS-5 because CentOS-5 is built from publicly available, open source SRPMS. The documentation is unmodified to be compliant with upstream distribution policy. Neither CentOS-5 nor the CentOS Project are in any way affiliated with or sponsored by Red Hat®, Inc.