Red Hat DIRECTORY SERVER 8.1 - INSTALLATION GUIDE 11-01-2010 Installation Manual

Also see for 8.1: Release note Deployment guide Using instruction Reference Using instructions

Contents

Red Hat DIRECTORY SERVER 8.1 - INSTALLATION GUIDE 11-01-2010 Installation Manual Manual pdf 81 page image

Chapter 6.71Migrating from Previous VersionsRed Hat Directory Server 8.1 supports both a migration path and an in-place upgrade, depending onthe version of Directory Server being updated.For Red Hat Directory Server 8.0 servers, perform an in-place upgrade. This updates all of theDirectory Server packages and then uses the setup script to update the server configuration.Red Hat Directory Server 7.1 instances can be migrated to Directory Server 8.1. Migration carriesover all data and settings from the older Directory Server to the new Directory Server, includingAdministration 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 anarray of migration options, including migrating instances to new platforms and to migrate instancesselectively or to migrate all installed instances simultaneously.The migration script is silent, meaning that there are no prompts and the user is not required to enterany information or approve any step in the process. After it run, the Directory Server informationand settings have been moved, intact, from the old Directory Server instance to the new one. Forthe simplest migration scenario, the migration script only requires two pieces of information with thecommand: the old server root path and the password for the directory administrator./usr/sbin/migrate-ds-admin.pl --oldsroot /opt/redhat-dsGeneral.ConfigDirectoryAdminPwd=passwordThe different migration scenarios and migration script options are described in this chapter.6.1. Migration and Upgrade OverviewMoving from an older version of Directory Server to Directory Server 8.1 is a simple process.In-place upgrades of 8.0 servers means that the packages for the server components are updated. Allof the existing databases, configuration files, and settings remain in-place and unchanged.Migration for 7.1 servers moves all of the user data and configuration settings, such as replication andsynchronization agreements, from the older instance to the new one.The general process is as follows:1. Stop all of the old Directory Server and Administration Server instances.2. Back up the old Directory Server databases.3. For a multi-master replication environment. Edit the Directory Server Console used by themigrated server to control directory writes.4. For supplier and hub servers in a replicated environment. Stop directory writes.5. For Red Hat Enterprise Linux systems, install OpenJDK 1.6.0, which is required by the DirectoryServer Console.6. Install the new Directory Server packages.7. Run the migration script, migrate-ds-admin.pl, for 7.1 systems.