Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java(TM) System Directory Server 5 2004Q2 Installation and Migration Guide 

Chapter 6
Migrating a Replicated 5.x Topology

When upgrading replicated 5.x servers, you typically start with the consumers, continue with the hubs, and finish with the masters. This bottom-up approach involves interrupting only one server at a time, rather than interrupting an entire branch of the replication topology. The approach also helps you avoid potential custom schema synchronization issues between masters and consumers.


The procedure described here applies the standard approach to upgrading a 5.x topology.

If, however, this bottom up approach fails to meet your specific requirements, then plan a different approach.

This chapter includes the following sections:

Upgrading 5.x Servers

  1. For each consumer in the existing topology, proceed according to the instructions under Chapter 4, "Upgrading and Migrating Data for a Single Directory Server Installation" or follow the links in Chapter 3, "Finding Patch Update Instructions" to upgrade the consumer.
  2. For each hub in the existing topology, proceed according to the same instructions to update the hub.
  3. For each master in the existing topology, proceed according to the same instructions to update the master.

Adding Additional Servers

After completing the upgrade from the 5.x topology to the 5.2 topology, you may add additional masters, hubs, and consumers as required for the new topology.

Perform the following steps for each additional server.

  1. Follow the links in Chapter 1, "Finding Installation Instructions" to determine how to install the new server.
  2. Adjust replication agreements on the new server to fit the planned topology.
  3. Initialize replication on the new server.

Refer to the Directory Server Administration Guide for instructions on configuring replication agreements and initializing replication.

Upon completion of this procedure, the update process is complete. Clients may begin using servers in the upgraded replication topology.

Example 5.x Upgrade Scenario

Consider an upgrade for 5.x dual masters replicating to two hubs supplying two consumers. This section shows the steps performed to upgrade the topology to use 5.2 servers.


In the figures that follow, solid arrows represent active replication. Dotted and dashed arrows represent interrupted replication. Dashed arrows alone represent instances being migrated.

Figure 6-1 shows the 5.x topology before the upgrade.

Figure 6-1  Existing 5.x Topology Example

Existing 5.x topology

The first step involves upgrading consumers. Figure 6-2 shows the resulting topology.

Figure 6-2  Example 5.x Consumer Upgrade Step

5.x consumers are upgraded first.

The next step involves upgrading hubs. Figure 6-3 shows the results.

Figure 6-3  Example 5.x Hub Upgrade Step

5.x hubs are upgraded next.

The next step involves upgrading masters. Figure 6-4 shows the results.

Figure 6-4  Example 5.x Master Upgrade - Step 3

5.x masters are then upgraded.

Figure 6-5 shows the 5.2 topology following the upgrade. At this point, servers in the old topology may be retired, and new servers added to the 5.2 topology.

Figure 6-5  Example 5.2 Topology after Upgrading

The new topology replaces the old.

Client requests are now directed to the 5.2 topology.

Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.