Table 6-1 migrate-ds-admin Options and Argument (continued)

Option or argument

Alternate

Description

 

options

 

 

 

 

 

(Optional) --cross

-c

or -x

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.

 

 

 

 

(Optional) --debug

-d

[dddd]

This parameter turns on debugging information. For the -d

 

 

 

flag, increasing the number of ds increases the debug level.

 

 

 

 

(Optional) --logfilename

-l

 

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.

 

 

 

 

(Required)

 

 

This is the password for the configuration directory

General.ConfigDirectoryAdminPwd=password

 

 

administrator of the old Directory Server (the default user

 

 

 

name is admin).

IMPORTANT: This is a required argument.

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.plscript allows the password parameter to be provided on the command line, similar to the setup-ds-admin.plscript. 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 --fileoption 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 --oldsrootoption. Any other argument passed in the command line or listed in an inf file, such as those used with the setup-ds-admin.plscript, 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