migrateinstance5(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | ATTRIBUTES | NOTES

NAME

migrateinstance5– migrates data, configuration, and schema to a new Directory Server instance

SYNOPSIS

migrateinstance5 -D rootDN {-w password | -w - | -j filename} -p port -o oldInstancePath -n newInstancePath [-t tracelevel] [-L logfile] [-noinput]

DESCRIPTION

The migrateInstance5 command migrates database content, configuration data, and schema from a Directory Server instance created using an earlier version of the product to a Directory Server instance using the current version of the product. Both instances must be installed on the same host system. For further information regarding the migration process, see Directory Server Installation and Migration Guide.

OPTIONS

The following options are supported:

-D

New 5.x Directory Server user DN with root permissions, such as Directory Manager.

-j

Specifies the file from which the new 5.x bind password is read. Used for simple authentication. If this option is specified, the -w option must not be specified.

-L

File in which to log the migration report. By default the migration report is stored under

ServerRoot/slapd-serverID/logs/Migration_ddmmyyyy_hhmmss.log

A sample log might contain:

ServerRoot/slapd-serverID/logs/Migration_20022004_153604.log

for a log created on 20 February 2004 at 15:36:04.

-n

Path to the new Directory Server instance.

-noinput

No user interventions during migration processing to solve conflicts.

-o

Path to the old Directory Server instance.

-p

New 5.x Directory Server port.

-t

Trace level of either 0 (no trace) or 1 (trace). The default level is 1.

-w

New 5.x password associated with the user DN. If you do not specify this option anonymous access is used. If you specify -w - , the utility prompts for the password. If either -w option is specified, the -j option must not be specified. For example, -wdiner892.

EXIT STATUS

The following exit values are returned:

0

Successful completion.

1

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWdsvu
Stability Level	Committed Private

NOTES

migrateInstance5 is implemented as a perl script, despite the fact that it does not have the .pl extension.

Before performing the migration, check that the user-defined variables contain the following associated values:

PERL5LIB ServerRoot/bin/slapd/admin/bin

PATH ServerRoot/bin/slapd/admin/bin

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | ATTRIBUTES | NOTES