HP-UX Directory Server 8.1 installation guide

Table 6-1 migrate-ds-admin Options and Argument (continued)
DescriptionAlternate
options
Option or argument
This parameter is used when the Directory Server is being
migrated from one machine to another machine that has a
different architecture. For cross-platform migrations, only
certain data are migrated. This migration action takes
database information exported to LDIF and imports LDIF
data into the new 8.1 databases. Changelog information is
not migrated. If a supplier or hub is migrated, then all its
replicas must be reinitialized.
-c or -x(Optional) --cross
This parameter turns on debugging information. For the -d
flag, increasing the number of ds increases the debug level.
-d [dddd](Optional) --debug
This parameter specifies a log file to which to write the
output. If this is not set, then the migration information is
written to a temporary file, named
/tmp/migrateXXXXX.log.
To disable logging, set /dev/null as the logfile.
-l(Optional) --logfilename
This is the password for the configuration directory
administrator of the old Directory Server (the default user
name is admin).
IMPORTANT: This is a required argument.
(Required)
General.ConfigDirectoryAdminPwd=password
If you do not specify the required items for the migration script (oldsroot) and
General.ConfigDirectoryAdminPwd), the migration script exits.
The following is an example using the required option and argument:
# /opt/dirsrv/sbin/migrate-ds-admin.pl\
--oldsroot /var/opt/netscape/server7 General.\
ConfigDirectoryAdminPwd=password
The migrate-ds-admin.pl script allows the password parameter to be provided on the
command line, similar to the setup-ds-admin.pl script. The arguments set the section,
parameter, and value of parameters of the .inf file in the following form:
section.parameter=value
To avoid displaying this password on the command line, you can invoke the migration script
with the --file option to refer to an .inf file that specifies the administrator's password:
# /opt/dirsrv/sbin/migrate-ds-admin.pl --oldsroot /var/opt/netscape/server7 \
--file=/opt/dirsrv/example.inf
The .inf file would have the following two lines:
[General]
ConfigDirectoryAdminPwd=password
The migration script takes all the other settings from the old configuration files in the old server
root, specified with the --oldsroot option. Any other argument passed in the command line
or listed in an inf file, such as those used with the setup-ds-admin.pl script, is ignored. The
Directory Server configuration parameters are only taken from the old instance. It is not possible
to change the configuration settings, such as the host name or port, using the migration script.
6.1.3 Migration scenarios
The migration scenario differs depending on the type of existing Directory Server configuration
you have. You can migrate a single Directory Server instance or all Directory Server instances
on a machine or all replicated servers. You can migrate the Directory Server to a different machine
6.1 Migrating from Netscape Directory Server 6.x, or from Red Hat Directory Server 7.1 49