dsrepair

repair replicated directory entries

Synopsis

install-path/bin/support_tools/dsrepair  
subcommand [options] arguments

Description

The dsrepair command makes it possible to repair entries that prevent replication from preceeding normally. You must enable the replication repair plug-in to use the dsrepair command.

Use the dsrepair command only under the supervision of qualified support personnel.

The dsrepair command functions only in non-secure mode, with simple authentication.

The dsrepair command is not available on Windows systems, though it can be run against a Directory Server instance on a Windows system.

Subcommands

The following subcommands are supported:

dsrepair add-entry [options] suffix entry.ldif

Adds the entry specified in the entry.ldif file to the specified suffix.

If an entry or tombstone entry having the same DN or nsUniqueID already exists, or if the parent entry does not exist, add-entry fails.

dsrepair begin-repair-mode [options] suffix

Puts the specified suffix in repair mode such that the only modify operations allowed are those performed using the dsrepair command.

Read operations continue normally while the suffix is in repair mode.

dsrepair delete-entry [options] suffix entry.ldif

Deletes the entry specified in the entry.ldif file from the specified suffix, and any tombstone associated with the entry.

If no entry or tombstone entry having the same DN or nsUniqueID already exists, or the specified entry has child entries, delete-entry fails.

dsrepair end-repair-mode [options] suffix

Returns the specified suffix from repair mode to its normal replication mode.

dsrepair replace-entry [options] suffix entry.ldif

Replaces an entry in the directory with the content specified in the entry.ldif file.

If no entry having the DN or nsUniqueID exists, or the entries returned for based on the DN and nsUniqueID are different, replace-entry fails.

dsrepair update-ruv [options] suffix csn

Replaces the maximum change sequence number (CSN) in a replication update vector (RUV) element with the specified csn string.

Options

The following options are supported:

-D bindDN

--bind-dn bindDN

Use the specified bind DN to authenticate to the directory server.

The default is cn=Directory Manager.

-h host

--hostname host

Contact the LDAP server on the specified host, which may be a host name or an IP address.

For example, when mapping the IPv4 address 192.168.0.99 to IPv6, pass the -h option with its argument as -h ::ffff:192.168.0.99.

The default is localhost.

-p port

--port port

Contact the LDAP server on the specified port.

The default is 389.

-w file

--pwd-file file

Use the bind password in the specified file.

If this option is not specified, the dsrepair command prompts for the password.

Exit Status

The following exit values are returned:

0: Successful completion.
non-zero: An error occurred.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWdsee7
Stability Level	Evolving