Installation guide

NOTE

On Red Hat Enterprise Linux 5 (64-bit) machines, the m igrate-ds-adm in tool is in the

/usr/sbin directory.

The command format to move from one platform to another is similar to the following:

# /usr/sbin/migrate-ds-admin.pl --cross --oldsroot server2:/m igration/opt/redhat-

ds --actualsroot /opt/redhat-ds General.ConfigDirectoryAdminPwd=password

The m igrate-ds-adm in 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:/m igration/opt/redhat-ds --

actualsroot /opt/redhat-ds --instance example

General.ConfigDirectoryAdminPwd=password

1. Stop all Directory Server instances and the Admin 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.2 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:

Red Hat Directory Server 8.2 Installation Guide