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

The migrate-ds-admin command automatically migrates every Directory Server instance
configured. As with migrating Directory Server on the same machine, using the instance parameter
allows you to set the specific instance to migrate. For example, this command migrated a Directory
Server instance named example:
/usr/sbin/migrate-ds-admin.pl --oldsroot server2:/migration/opt/redhat-ds --actualsroot /opt/
redhat-ds --instance example General.ConfigDirectoryAdminPwd=password
1. Stop all Directory Server instances and the Administration Server.
2. Back up all the Directory Server user and configuration data.
3. Export all of the database information to LDIF. The LDIF file must be named the name of the
database with .ldif appended. For example:
cd /opt/redhat-ds/slapd-instance
./db2ldif -n userRoot -a /opt/redhat-ds/slapd-instance/db/userRoot.ldif
./db2ldif -n NetscapeRoot -a /opt/redhat-ds/slapd-instance/db/NetscapeRoot.ldif
4. Make sure all of the LDIF files are readable by the setup script.
chmod 444 /opt/redhat-ds/slapd-instance/db/userRoot.ldif
chmod 444 /opt/redhat-ds/slapd-instance/db/NetscapeRoot.ldif
5. Install the Directory Server 8.1 packages on the new machine which will host Directory Server.
6. Make the old Directory Server accessible to the new machine, either through an NFS-mounted
drive or tarball.
7. Run the migration script as root. Specify the current physical location of the Directory Server with
the oldsroot parameter and the location on the old machine with the actualsroot parameter.
IMPORTANT
Do not set up the new Directory Server instances with setup-ds-admin.pl before
running the migration script.
For example:
/usr/sbin/migrate-ds-admin.pl --cross --oldsroot server2:/migration/opt/redhat-ds --
actualsroot /opt/redhat-ds General.ConfigDirectoryAdminPwd=password
The migration process starts. The legacy Directory Server is migrated, and a new Directory Server 8.1
instance is installed using the configuration information from the legacy Directory Server.
IMPORTANT
Always verify the Directory Server configuration after migrating from 7.1 to 8.1. Some
configuration settings, like passwordMinLength for a global password policy, are not
migrated.
Migrating a Directory Server from One Platform to Another
81