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 eMBox Client, see Using the eMBox Command Line Client.
Run the eMBox Client in interactive mode by entering the following at the command line:
java -cp path_to_the_file/emboxclient.jar embox -i
(If you have already put the emboxclient.jar file in your class path, you need to enter only java embox -i.)
The eMBox Client prompt appears:
eMBox 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 8008, unless you have a Web server that is already using the port. The -n option opens a nonsecure connection.
The eMBox 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 username Admin and user password test) with the source tree you are currently logged in to (with source tree username 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 username Admin and user password test) into the Fruit container in the target tree Orange (with target tree username Admin and user password test).
A space must be between each switch. The order of the switches is not important.
The eMBox 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 eMBox Client by entering the following command:
logout
Exit the eMBox Client by entering the following command:
exit
The following tables lists the DSMerge eMTool options. You can also use the list -tdsmerge command in the eMBox Client to list the DSMerge options with details. See Listing eMTools and Their Services for more information.