Service manual

Before You Upgrade
52 Sun ONE Directory Server Installation and Tuning Guide • June 2003
Sun ONE Directory Server 5.2 provides a script to help you migrate data for a
server instance. The migration script performs the following tasks in sequence:
1. Stops your existing server, and backs up the current configuration.
2. Checks schema configuration files, notifying you of differences between the
standard schema configuration files and those used by your existing server.
(4.x to 5.2 only)If an existing 4.x server uses custom schema not installedin the
default location, under ServerRoot
/slapd-serverID/config, you must adjust
the configuration manually before migrating directory data.
3. Creates a database for each suffix stored in the old server.
(4.x to 5.2 only) 4.x servers supported multiple suffixes per database. The
migration script creates a database for each suffix on the new server.
4. Migrates server and database configuration parameters.
4.x servers store such parameters in
slapd.conf. 5.x servers store such
parameters as entries in
dse.ldif.
(4.xto 5.2only)Themigrationscriptdoesnot migrateall4.x serverparameters.
In some cases, you must migrate 4.x attribute values manually. Refer to the
current version of the Sun ONE Directory Server Reference Manual for details.
NOTE Ensure you have sufficient disk space on the host where you run the
existing server. The upgrade process requires at least enough local
disk space to house binaries and databases for both the old and new
servers, and also enough extra space to hold LDIF files containing
the entries in all existing suffixes. You may estimate the local disk
space required as somewhat larger than:
2 * (space for existing server) + (space for LDIF files)
The upgrade process must be performed with both servers on the
same host, as data migration cannot be performed over networked
drives.
NOTE Thescriptdoesnotmigratedataunder
o=NetscapeRoot.
When deploying a server such as Sun ONE Messaging Server that
relies on data in this suffix, migrate the data in
o=NetscapeRoot
manually, or using tools provided with the server in question.