Using the eMBox Client to Repair a Database

The eDirectory Management Toolbox (eMBox) Client is a command line Java client that gives you remote access to DSRepair. Because the eMBox Client can be run in batch mode, you can use it to do unattended repairs using the eDirectory DSRepair eMTool.

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.


Using the DSRepair eMTool

  1. 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 only need to enter java embox -i.)

    The eMBox Client prompt appears:

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

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

    dsrepair.task options

    For example:

    dsrepair.ufr performs an unattended full repair.

    dsrepair.rld -a -v repairs the local database using the Repair All Local Replicas and Check Local References options.

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

    The eMBox Client will indicate whether the repair is successful.

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

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

    logout

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

    exit


DSRepair eMTool Options

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

Option Description

rso
-o
-d

Single object repair
Object ID in hex
Object DN

rts

Time synchronization

rss

Report synchronization status of all partitions

rld
-l
-t
-d
-p
-i
-f
-e
-c
-o
-a
-m
-v

Repair local database
Lock eDirectory database during entire repair
Use temporary eDirectory database during repair
Maintain original unrepaired database
Perform database structure check
Perform database structure and index check
Reclaim database free space
Rebuild the entire database
Perform tree structure check
Rebuild operational schema
Repair all local replicas
Validate mail directories and stream files
Check local references

ufr

Unattended full repair

rsn
-o
-d

Repair selected server's network address
Object ID in hex
Object DN

ran

Repair all network addresses

rsr
-p
-d

Repair selected replica
Partition ID
Partition DN

rer

Repair every replica

ror
-p
-d

Repair selected replica ring
Partition ID
Partition DN

rar

Repair replica ring, all replicas

ssa
-p
-d

Report the replica synchronization status of all servers
Partition ID
Partition DN

cer

Check external references

rao
-p
-d
-s
-d

Receive all objects for this replica
Partition ID
Partition DN
Server ID
Server DN

sao
-p
-d
-s
-d

Send all objects to every replica in the ring
Partition ID
Partition DN
Server ID
Server DN

dne
-p
-d

Repair time stamps and declare a new epoch
Partition ID
Partition DN

sri
-p
-d

Schedule immediate synchronization
Partition ID
Partition DN
Server ID
Server DN

sks
-p
-d
-s
-d

Synchronize the replica on the selected server
Partition ID
Partition DN
Server ID
Server DN

ske
-p
-d

Synchronize the replica on all servers
Partition ID
Partition DN

dsr
-p
-d

Destroy the selected replica on this server
Partition ID
Partition DN

xsr
-p
-d
-s
-d

Remove this server from the replica ring
Partition ID
Partition DN
Server ID
Server DN

dnm
-p
-d

Designate this server as the new master replica
Partition ID
Partition DN

dul

Delete unknown leaf objects