Sun ONE Directory Server Resource Kit 5.2 Tools Reference |
Chapter 26
The Schema Migration ToolThe migrateSchemaTo5.pl tool helps automate the process of updating a custom Sun ONE schema for deployment with Sun ONE Directory Server 5.x. This chapter provides instructions on how to use migrateSchemaTo5.pl. It contains the following sections:
OverviewMost custom schema files defined for, and used in, version 4.x Sun ONE Directory Servers can be fully updated using the migrateSchemaTo5.pl tool, thus requiring no manual editing.
Tip
For more information about migrating to versions 5.x Directory Servers, see Chapter 6, “Migrating from Previous Versions” in the Sun ONE Directory Server Installation and Tuning Guide.
The DSRK includes the tool in the DSRK_base/perl directory.
Note
This script requires Perl version 5.005_03 or later. See Third-Party Sources of Information for links to Perl resources.
Command UsageThe migrateSchemaTo5.pl tool is designed to convert all of the custom schema files used by your previous versions of Directory Server to the format required by versions 5.x. For example, all attribute and object class definitions now require a value for the X-ORIGIN field, and this tool will generate one automatically using either a default value or a user-specified value.
Syntax
The syntax of migrateSchemaTo5.pl on the command-line takes the following form:
migrateSchemaTo5.pl -o 4xInstancePath -s newSchemaFile [ options ]
Where:
- 4xInstancePath is the location of the old 4.x server installation. The tool will automatically locate all schema files defined in the slapd.conf file under the userat and useroc headings.
Note
Schema files specified in INCLUDE statements with the 4.x slapd.conf file are not converted automatically. You must convert these files separately using the -i option described in Table 26-1.
- newSchemaFile is the name of the file where the equivalent 5.x schema will be written.
- options are the command-line options and their parameters described in Options.
Options
The migrateSchemaTo5.pl options and parameters are described in Table 26-1.