Red Hat 8.1 - Manual (Page 230)

IMPORTANT
Do not run setup-ds-admin.pl for the new Directory Server 8.1 instance before running the
migration script if you are migrating from a 7.1 server.
If you are upgrading from a Directory Server 8.0 server, do not run migrate-ds-admin.pl.
Run setup-ds-admin.pl -u instead.
Information can be passed with the script or in an .inf file, same as the setup scripts.
Both the .inf parameters and command-line arguments are described in the silent configuration
section of the Installation Guide.
Syntax
m igrate-ds-adm in.pl --oldsroot=server_directory [ --actualsroot=server_directory ] [ --
instance=instance_name ] [ --file=name ] [ --cross ] [ --debug ] [ --log=name ]
General.ConfigDirectoryAdminPwd=password
Options
Option Alternate
Options Description
General.ConfigDirectoryAdminPwd=password Required. This is the password for the
configuration directory administrator of the
old Directory Server (the default username
is admin).
--oldsroot -o Required. This is the path to the server root
directory in the old 7.1 Directory Server
installation. The default path in 7.1 servers
is /opt/redhat-ds/.
--actualsroot -a This is used for migrating between two
machines to specify the real path to the
current server root directory in the old 7.1
Directory Server installation if that directory
is mounted on a networked drive or
tarballed and moved to a relative directory.
In that case, the oldsroot parameter sets
the directory from which the migration is run
(such as
m achine_new:/m igrate/opt/redhat-
ds/), while the actualsroot parameter
sets the server root, (/opt/redhat-ds/).
--instance -i This parameter specifies a specific
instance to migrate. This parameter can be
used multiple time to migrate several
instances simultaneously. By default, the
migration script migrates all Directory
Server instances on the machine.
--file=name -f name This sets the path and name of the .inf
file provided with the migration script. The
only parameter is the
General.ConfigDirectoryAdminPwd
parameter, which is the configuration
directory administrator's password. Any
other configuration setting is ignored by the
migration script.
--cross -c or -x This parameter is used when the Directory
Server is being migrated from one machine
to another with a different architecture. For
cross-platform migrations, only certain data
are migrated. This migration action takes
database information exported to LDIF and
imports 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.
--debug -d[dddd] This parameter turns on debugging
information. For the -d flag, increasing the
230
Chapter 7. Command-Line Scripts