Service manual

Upgrading a Single Server
56 Sun ONE Directory Server Installation and Tuning Guide • June 2003
1. If you intend to initialize replication on the new Directory Server offline from
files, obtain the files before proceeding.
Refer to the Sun ONE Directory Server Administration Guide for instructions on
exporting Directory Server data.
2. Ensure the new Directory Server is running.
3. Work as a user having the right to start, stop, and run database export and
import onboth the old and new servers.
For example, become super user or log on as
Administrator.
4. SetenvironmentvariablesasshowninTable2-1.
5. Run the migration script under the new server instance:
#cdServerRoot/bin/slapd/admin/bin
# perl migrateInstance5 -p port52 -D "cn=directory manager" -w password -o oldServ -n newServ
Here,oldServ represents the full path to the old server instance, such as
/usr/iplanet/servers/slapd-ldap or /usr/iplanet/ds5/slapd-ldap,
and newServ represents the full path to the new server instance, such as
/var/ds/v5.2/slapd-dirserv.
The script generates output as it proceeds. You may choose to redirect this output
to a file for review after migration completes.
Retire the old server only after migrating existing data to the new server.
(4.x to 5.2) Creating Replication Agreements
If an existing 4.x server is involved in replication, upgrading involves recreating
replication agreements after migrating data. Read “(4.x to 5.2) Upgrading
Replicated Servers,” on page 57 before proceeding with the upgrade process.
Table 2-1 Environment Variables for Migration
Variable Value
PATH (UNIX) ServerRoot/bin/slapd/admin/bin:$PATH
(Windows) ServerRoot/bin/slapd/admin/bin;%PATH%
PERL5LIB ServerRoot/bin/slapd/admin/bin