Sun Microsystems 8190994 - Manual (Page 30)

Prerequisites for Running dsmig
In this section, old instance refers to the 5.2 instance and new instance refers to the Directory
Server 6.0 instance.
Before you use dsmig to migrate an instance, ensure that the following tasks have been
performed:
■ The Directory Server 6.0 packages (either zip, or native packages) have been installed.
The Directory Server 6.0 packages can be installed on the same machine that holds the
Directory Server 5.2 instance, or on a different machine.
■ The old instance must have been stopped correctly.
A disorderly shutdown of the old instance will cause problems during the migration. Even if
the old and new instance are on different machines, the old instance must be stopped before
the migration is started.
■ dsmig has access to the old instance files.
■ If the old and new instances are on different machines, a complete image of the old instance
must be created on the machine that hosts the new instance.
The complete image includes all the files required for migration of the instance (schema,
configuration, security and database files). The complete image files must be located in the
same directories as they were under the original Server Root. You can run cp -r to achieve
this, provided none of the files have been relocated outside the Server Root.
You can create and start the new instance manually, but is not mandatory to create the new
instance before running dsmig. dsmig checks whether a new Directory Server instance exists in
the specified path. If a new instance exists, the commands are carried out on this instance. If a
new instance does exist, the instance is created automatically.
The new instance can be created anywhere except for the exact location of the old instance.
Using dsmig to Migrate the Schema
Directory Server 5.2 schema files are located in
serverRoot/slapd-instance-path/config/schema. Directory Server 6.0 schema files are located
in INSTANCE-PATH/config/schema.
Directory Server 6.0 provides a new schema file, 00ds6pwp.ldif, that contains new password
policy attributes. In addition, certain configuration attributes have been added to 00core.ldif.
Apart from these files, the standard schema files provided with Directory Server 6.0 are identical
to those provided in 5.2.
To migrate the schema automatically, run the following command:
$ dsmig migrate-schema old-instance-path new-instance-path
Prerequisites for Running dsmig
Sun Java System Directory Server Enterprise Edition 6.0 Migration Guide • March 2007 30
Sun Confidential: Registered