Set up a gateway topology

Before starting to set up your replication topology, make a backup copy of your original ibmslapd.conf file. You can use this backup copy to restore your original configuration if you encounter difficulties with replication.

To set up a gateway using the complex topology with peer replication from the procedure in Promote a server to be a peer, you must complete the following steps:

• Convert an existing peer server (peer 1) to a gateway server to create replication site 1.
• Create a new gateway server for replication site 2 and agreements with peer 1.
• Create the topology for replication site 2 (not illustrated in this example).
• Copy the data from the master to all the machines in the topology.

Convert an existing peer server to a gateway server

1. Use the Web administration tool to log in to the master (server1).
2. Expand the Replication management category in the navigation area and click Manage topology.
3. Select the subtree that you want to replicate and click Show topology.
4. Click the arrow next to the Replication topology selection to expand the list of servers.
5. To convert an existing server to a gateway server, select server1 or its peer server5. For this example use server1.
6. Click Edit server.
7. Verify that Server is a master is checked and then select Server is a gateway.
8. Click OK.
   Note:
   If the server you want to use as a gateway is not already a master, it must be a leaf replica with no subordinate replicas that you can first promote to be a master and then designate as a gateway.

Create a gateway server and copy data from the master to all machines in the topology

1. Select server1 and click Add replica.
2. Create the new replica, server9. See Create a replica server for information about creating replicas, adding credentials, and supplier information.
3. Select server9 and click Move.
4. Select Replication topology to promote the replica to a master. Click Move.
5. The Create additional supplier agreements panel is displayed. In this panel, ensure that the supplier agreement boxes are checked for server1 only.

   	Supplier	Consumer
   X	server9	server1
   	server9	server2
   	server9	server4
   	server9	server5

   Click Continue.
   Note:
   In some cases the Select credentials panel is shown asking for a credential that is located in a place other than cn=replication,cn=localhost. In such situations you must provide a credential object that is located in a place other than cn=replication,cn=localhost. Select the credentials the subtree is going to use from the existing sets of credentials or create new credentials. See Create credentials.
6. Click OK.
7. Select server9 and click Edit server.
8. Verify that Server is a master is checked and then select Server is a gateway.
9. Click OK. The server roles are represented by icons in the Web administration tool. Your topology is now:
   • server1 (master-gateway for replication site1)
     • server2 (forwarder)
       • server3 (replica)
       • server6 (replica)
     • server4 (forwarder)
       • server7 (replica)
       • server8 (replica)
     • server5 (master)
     • server9 (master-gateway for replication site 2)
   • server5 (master)
     • server1 (master)
     • server2 (forwarder)
     • server4 (forwarder)
   • server9 (master-gatway)
     • server1 (master-gateway)
10. Add replica servers to server9 to create the topology for replication site 2.
11. Repeat this process to create additional replication sites. Remember to create only one gateway server per replication site.
12. When you have finished creating the topology, copy the data from server1 to all the new servers in all the replication sites and add the supplier information to all the new servers. See Copy data to the replica and Add the supplier information to the replica for information on how to do that.