Using ndsmerge for Linux or Solaris

You can use the ndsmerge utility on Linux or Solaris systems to combine two eDirectory trees so that the combined tree can be accessed by the clients of both the trees. The ndsmerge options lets you:

Merge two trees

Check the time synchronization of all the servers hosting the root replica of the tree

Change the name of the source tree to the name of the target tree

List all the servers hosting the root replica present in the tree, along with the time synchronization status

The following sections provide information that help you perform ndsmerge operations on Linux or Solaris:

Prerequisites for Performing ndsmerge Operations

Merging eDirectory Trees on Linux or Solaris Systems

Prerequisites for Performing ndsmerge Operations

Meet the following prerequisites before merging two eDirectory trees:

Identify the source and destination trees. While merging, servers on the source tree will combine with the target tree and the source tree will cease to exist. If a target-container is not specified, the trees will be merged at the Tree object level by default. This may affect users logging in, if the preferred tree is specified in the configuration file.

Ensure that both the trees are operating properly and that the replicas are synchronizing without any errors.

Ensure that all servers in the tree are synchronizing from the same time source.

Trees cannot be merged if the schema on the source and target tree do not match. If you have installed an application that modified the schema on a tree, install the same application on the other tree so that the schema on both trees match. Alternatively, you can use the Import Remote Schema option of the ndsrepair utility to adjust the schema between two trees. To do so, run the following command on both the trees:

ndsrepair - S -Ad

Run ndsrepair -U on both the trees before starting the merge operation. This operation verifies that all replicas in a tree are synchronizing properly, identifies synchronization errors, and corrects them.

Merging eDirectory Trees on Linux or Solaris Systems

To merge two eDirectory trees:

Use the following syntax:

ndsmerge [-m target-tree target-admin source-admin [target_container]] [-c] [-t] [-r target-tree source-admin]

Table 61. ndsmerge Options

Option	Description
-m	Merges two trees. You need to specify the following attributes with this option: target-tree Name of the target tree. target-admin Name with full context of the user with administration rights to the target tree. source-admin Name with full context of the user with administration rights to the source tree. target-container Name with full context of the container object on the target tree to which the Tree object of the source tree has to be combined. If you choose to specify a value to this parameter, ensure that the source tree has a single server.
-c	Lists all the servers present in the tree with the synchronization status. This option can be used before merging trees to detect any problems before starting the merge operation.
-t	Checks the time synchronization of all the servers in the tree. Use this option on the server having the master of the Tree partition. This will list the servers in the tree, along with the time synchronization status.
-r	Changes the name of the source tree to the name of the target tree. Use this option when you are merging two trees with the same name. You have to log in to the tree to change the name of the tree. For this operation to succeed, ensure that you run ndsmerge on the server having the master of the tree's Tree partition. All the servers in the tree will merge with the new tree name. You need to specify the following attributes with this option: target-tree The new name for the tree. source-admin The name with full context of the user with administration rights to the tree.

After the merge operation is completed, ndsmerge waits for the new replica of the root partition to synchronize with the root server of the source tree. If any synchronization problems are reported, you need to run the ndsrepair utility to rectify synchronization problems. For more information, see Using ndsrepair.