Chapter 26 The Schema Migration Tool

The 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:

Overview

Most 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.


Note	This script requires Perl version 5.005_03 or later. See Third-Party Sources of Information for links to Perl resources.

Command Usage

The 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

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

Table 26-1 Command-Line Options for migrateSchemaTo5.pl
Option	Parameter	Purpose
-o	4xInstancePath	Specify the path of the 4.x Directory Sever instance that uses a custom schema you wish to migrate. The command will automatically convert all custom schema files found in the slapd.conf file under the userat and or useroc headings. However, schema files specified in INCLUDE statements are not converted automatically. This parameter has no effect when the -i option is used.
-i	oldSchemaFile	Specify the full path and filename of a 4.x schema file to convert for use with Directory Server 5.x. This option will override the -o parameter.
-s	newSchemaFile	Specify the path and filename of the converted custom schema.
-x	"X-ORIGIN"	Specify a value for the X-ORIGIN field for attributes and object classes in the converted schema file. Use double quotes ("") to include any space in this value on the command-line. The default string value is "user defined".
-t	traceLevel	Specify the level of trace, from 0 to 4, for reporting actions performed during the schema file migration.
-L	logFile	Specify a file in which to log the migration report.

Previous Contents Index Next
Sun ONE Directory Server Resource Kit 5.2 Tools Reference