5.5 Using the Client to Perform Schema Operations

The eDirectory Management Toolbox (eMBox) Client is a command line Java client that gives you remote access to DSSchema operations. You can use the DSSchema eMTool to synchronize schema, import remote schema, declare a new schema epoch, reset the local schema, and perform a global schema update (operations normally performed using DSRepair. For more information, see Maintaining the Schema.).

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.

5.5.1 Using the DSSchema 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 only need to enter java -i.)

    The Client prompt appears:

     Client>
  2. Log in to the server you want to repair 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 indicates whether the login is successful.

  3. Enter a repair command, using the following syntax:

    dsschema.task options

    For example:

    dsschema.rst requests the master replica of the root of the tree to synchronize its schema to this server.

    dsschema.irs -n MyTree imports remote schema from the tree named MyTree.

    A space must be between each switch. The order of the switches is not important.

    The Client will indicate whether the repair is successful.

    See DSSchema eMTool Options for more information on the DSSchema eMTool options.

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

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

    exit

5.5.2 DSSchema eMTool Options

The following tables lists the DSSchema eMTool options. You can also use the list -t dsschema command in the Client to list the DSSchema options with details. See Listing eMTools and Their Services for more information.

Option

Description

rst

Synchronizes the schema of the master replica of the root of the tree to this server.

irs -ntree_name

Imports remote schema from another tree.

dse

Declares a new schema epoch on the server that holds the master replica of root.

rls

Resets the local schema with a copy from the server with the master replica of the root partition.

gsu

Performs a global schema update.

scc

Adds schema circular containment rules for the Domain class.