Chapter 8. Migrating from Previous Versions
92
the format in such a way that you cannot use the older version of the Directory Server.
Therefore, make a database backup using
db2bak
and an LDIF dump using
db2ldif
of
the databases to make sure everything can be recovered.
The most common reason for using a non-default database location is the performance
for large databases. For example, if a Directory Server instance has several gigabytes
of data, the index files and transaction logs can be moved to a separate disk device to
improve the Directory Server performance, especially if there are high update rates. In
this case, migration will not attempt to move the databases to the new default location,
/var/lib/dirsrv/slapd-instancename/db
, but will instead assume that the
databases should be in their non-standard location and configure the new server to use
the databases in the old location.
This issue does not occur in cross-platform migrations or migrating using LDIF files
instead of the binary databases because these already work with an LDIF copy of the
database.
8.2. About migrate-ds-admin.pl
The migration script,
migrate-ds-admin.pl
, has flexible options that allow a variety of different
migration scenarios, including migrating between different different platforms. This options are listed in
Table 8.1, “migrate-ds-admin Options”
.
There is one required option with the migration script,
oldsroot
, which gives the directory path to the
old Directory Server. There is also one required argument,
General.ConfigDirectoryAdminPwd
,
which gives the password of the directory administrator for the old Directory Server. If either of these
are not supplied, the migration script will exit.
/usr/sbin/migrate-ds-admin.pl --oldsroot /opt/redhat-ds
General.ConfigDirectoryAdminPwd=password
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.
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 6.x or 7.x Directory Server
installation. The default path in
6.x and 7.x servers is
/opt/
redhat-ds/
.
