Service manual

Before You Upgrade
Chapter 2 Upgrading From Previous Versions 53
5. Migrates user-defined schema objects.
6. Migrates indexes.
7. Migrates standard server plug-ins.
You must migrate custom plug-ins manually. At minimum, you must
recompile all custom plug-ins. Refer to the Sun ONE Directory Server Plug-In
API Programming Guide for a detailed list of plug-in API changes.
8. (5.x to 5.2 only) Migrates replication agreements.
9. Migrates the certificate database, and SSL parameters.
10. (5.x to 5.2 only) Migrates database links.
11. (5.x to 5.2 only) Migrates replication entries.
12. Migrates the SNMP configuration.
After the migration script completes, clients may send requests to the new server.
When Upgrading Multiple Replicated Servers
Not surprisingly, upgrading multiple servers involves upgrading each server
individually. The order in which you upgrade servers depends, however, on the
software version of existing servers and on the replication topology.
For 5.x to 5.2 upgrades, the standard process is bottom up. First you migrate the
consumers. Next you upgrade the hubs. Finally you upgrade the masters. Refer to
“Example 5.x Upgrade Scenario,” on page 67 for how you might do this in a
particular instance.
For 4.x to 5.2 upgrades, you start by upgrading the 4.x master, then proceed with
each branch of consumers being replicated from the master, starting with the
consumer closest to the master interms of replication. Refer to “Example 4.x
Upgrade Scenario,” on page 60 for how you might do this in a particular instance.
NOTE Before replicating from a 5.2 Directory Server to a 5.1 server, set
nsslapd-schema-repl-useronly on cn=config to on. Otherwise
the 5.2 schema are pushed to the5.1server,preventing the 5.1 server
from restarting due to duplicate objects.