The eDirectory Management Toolbox (eMBox) Client is a command line Java client that gives you remote access to DSMerge. The emboxclient.jar file is installed on your server as part of eDirectory. You can run it on any machine with a JVM. For more information on the Client, see Using the Command Line Client.
Run the Client in interactive mode by entering the following at the command line:
java -cp path_to_the_file/emboxclient.jar -i
(If you have already put the emboxclient.jar file in your class path, you need to enter only java -i.)
The Client prompt appears:
Client>
Log in to the server that will run DSMerge (this will be the source tree) by entering the following:
login -sserver_name_or_IP_address -pport_number -uusername.context -wpassword -n
The port number is usually 80 or 8028, unless you have a Web server that is already using the port. The -n option opens a nonsecure connection.
The Client will indicate whether the login is successful.
Enter a merge command, using the following syntax:
dsmerge.task options
For example, dsmerge.m -uadmin -ptest -TApple -Uadmin -Ptest merges the target tree Apple (with target tree user name Admin and user password test) with the source tree you are currently logged in to (with source tree user name Admin and user password test).
dsmerge.g -uadmin -ptest -TOrange -Uadmin -Ptest -CFruit grafts the source tree you are currently logged in to (with source tree user name Admin and user password test) into the Fruit container in the target tree Orange (with target tree user name Admin and user password test).
A space must be between each switch. The order of the switches is not important.
The Client will indicate whether the DSMerge operation was successful.
See DSMerge eMTool Options for more information on the DSMerge eMTool options.
Log out from the Client by entering the following command:
logout
Exit the Client by entering the following command:
exit
The following tables lists the DSMerge eMTool options. You can also use the list -t dsmerge command in the Client to list the DSMerge options with details. See Listing eMTools and Their Services for more information.
|
Merge Operation |
Client Command |
|---|---|
|
Check whether the tree can be renamed |
dsmerge.pr -uUser -pUser_password -nNew_tree_name |
|
Rename the tree |
dsmerge.r -uUser -pUser_password -nNew_tree_name |
|
Check whether two trees can be merged |
dsmerge.pm -uSource_tree_user-pSource_tree_user_password -TTarget_tree_name -UTarget_tree_user -PTarget_tree_password |
|
Merge two trees |
dsmerge.m -uSource_tree_user-pSource_tree_user_password -TTarget_tree_name-UTarget_tree_user -PTarget_tree_password |
|
Check whether the source tree can be grafted into the target tree container |
dsmerge.pg -uSource_tree_user -pSource_tree_user_password -TTarget_tree_name -UTarget_tree_user -PTarget_tree_password -CTarget_tree_container |
|
Graft the source tree into the container in the target tree |
dsmerge.g -uSource_tree_user -pSource_tree_user_password -TTarget_tree_name -UTarget_tree_user -PTarget_tree_password -CTarget_tree_container |
|
Cancel the running DSMerge operation |
cancel |