11.4 Using the Client to Merge Trees

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 Section 22.1, Using the Command Line Client.

11.4.1 Using the DSMerge eMTool

  1. 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>
    
  2. 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.

  3. 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.

  4. Log out from the Client by entering the following command:

    logout
    
  5. Exit the Client by entering the following command:

    exit
    

11.4.2 DSMerge eMTool Options

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