HP-UX Directory Server 8.1 installation guide

The --oldsroot option can also specify a local directory on the target machine that was created
from a tarball. In that case, create a tarball of your old server root directory, and untar it on the
target machine. In this example, a tarball was created of /var/opt/netscape/server7 on
the source machine, and it was untarred under /migration on the target machine:
# /opt/dirsrv/sbin/migrate-ds-admin.pl --oldsroot /migration/server7 \
--actualroot /var/opt/netscape/server7\ 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
option allows you to set the specific instance to migrate. For example, this command migrated
a Directory Server instance named example:
# /opt/dirsrv/sbin/migrate-ds-admin.pl \
--oldsroot /net/server2/migration/server7 \
--actualroot /var/opt/netscape/server7 --instance example \
General.ConfigDirectoryAdminPwd=password
The procedure follows:
1. Stop all Directory Server instances and the Administration Server.
2. Back up all the Directory Server user and configuration data.
3. Install the Directory Server 8.1 package on the new machine that will host Directory Server.
4. Make the old Directory Server accessible to the new machine, either through an NFS-mounted
drive or tarball.
5. Run the migration script as root. Specify the current physical location of the Directory
Server with the --oldsroot option and the location on the old machine with the
actualsroot option.
IMPORTANT:
Do not set up the new Directory Server instances with setup-ds-admin.pl before running
the migration script.
For example:
# /opt/dirsrv/sbin/migrate-ds-admin.pl \
--oldsroot /net/server2/migration/server7 \
--actualsroot /var/opt/netscape/server7 \
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.
6.1.3.4 Migrating a Directory Server from one platform to another
To migrate a Directory Server installation from one platform to another is similar to migrating
from one machine to another. The difference between a migration between platforms and other
migration scenarios is the information migrated from the old Directory Server. The databases
are in an architecture-dependent binary format and can be migrated only after they are exported
to LDIF. Other data, such as the changelog, is not migrated. As explained in “Migrating a Directory
Server from one machine to another” (page 51), the migration script uses the --actualsroot
and --oldsroot options to migrate across machines and the cross option to signal that the
migration is across-platforms.
The command format to move from one platform to another is similar to the following:
# /opt/dirsrv/sbin/migrate-ds-admin.pl --cross \
--oldsroot /net/server2/migration/server7 \
--actualroot /var/opt/netscape/server7 \
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
52 Migrating or upgrading to HP-UX Directory Server from Netscape or Red Hat Directory Server