Red Hat DIRECTORY SERVER 8.0 Installation Manual page 109

parameters to migrate across machines and the cross parameter to signal that the migration is cross-
platform.
NOTE
On Red Hat Enterprise Linux and Solaris machines, the migrate-ds-admin tool is in
the /usr/sbin/ directory. On HP-UX machines, the migrate-ds-admin is in the /
opt/dirsrv/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:/migration/opt/redhat-ds
--actualsroot /opt/redhat-ds General.ConfigDirectoryAdminPwd=password
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. Install the Directory Server 8.0 packages on the new machine which will host Directory Server.
5. Make the old Directory Server accessible to the new machine, either through an NFS-mounted
drive or tarball.
6. 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
Migrating a Directory Server from One Platform to Another
101