Creating a master server (replicated subtree)

You can issue the commands provided here to create a master server (replicated subtree).

About this task

Note: The server must be running to perform this task.

This task designates an entry as the root of an independently replicated subtree and creates an ibm-replicasubentry entry under it representing this server as the single master for the subtree. To create a replicated subtree, you must designate the subtree that you want the server to replicate.

Note: On Linux™ operating systems, if a client hangs while chasing referrals, ensure that the environment variable LDAP_LOCK_REC has been set in your system environment. No specific value is required.

set LDAP_LOCK_REC=anyvalue

Procedure

Use the Web Administration Tool to log on to the master server.
Expand the Replication management category in the navigation area of the Web Administration Tool and click Manage topology.
Click Add subtree.
Enter the DN of the subtree that you want to replicate or click Browse to expand the entries to select the entry that is to be the root of the subtree. For this example, use o=sample.
Note: If you are replicating a subtree, and the subtree is not a suffix, you must replicate the parent of the subtree on the replica first.
The master server referral URL is displayed in the form of an LDAP URL, for example:
For non-SSL:
```
ldap://<myservername>.<mylocation>.<mycompany>.com:<port>
```
For SSL:
```
ldaps://<myservername>.<mylocation>.<mycompany>.com:<port>
```
The default URL is ldap://localhost:389.
Note: The master server referral URL is optional. It is used only:
- If the server contains (or will contain) any read-only subtrees.
- To define a referral URL that is returned for updates to any read-only subtree on the server.
Click OK.
The new subtree is displayed on the Manage topology panel under the heading Replicated subtrees.
Select the subtree from the Replicated subtrees table and click Show topology. The topology is displayed under the Topology for selected subtree heading. By default, if subtrees are available in the Replicated subtrees table, the topology of the first subtree in the table is displayed under the Topology for selected subtree heading.
Depending on the selection of the node in the topology tree, the operations allowed on the node vary. Some of the operations are applicable only when a node other than the root is selected. Also, some operations are specific to the type of node, such as master server, forwarding server, replica server, and gateway server.