Skip Headers
Oracle® Fusion Middleware Man Page Reference for Oracle Directory Server Enterprise Edition
11g Release 1 (

Part Number E28967-01
Go to Documentation Home
Go to Table of Contents
Go to Index
Go to Feedback page
Contact Us

Go to previous page
Go to next page
PDF · Mobi · ePub


diagnose and repair some replication failures


subcommand options


The replcheck command allows you to diagnose and repair a replication halt. Use the replcheck command with one of the options described in this man page.

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


The following subcommands are supported:

replcheck diagnose [-D DN] [-w PW_FILE] [-L LOG_DIR] [-v] TOPOLOGY_FILE

Diagnoses the cause of the replication breakage and summarizes the proposed repair actions.

replcheck fix [-D DN] [-w PW_FILE] [-L LOG_DIR] [-v] TOPOLOGY_FILE

Fixes the replication breakage.

Global Options

The following options are global, and are applicable to all commands and subcommands.


Displays help information for a command or subcommand.


Displays the current version of replcheck. The version is provided in the format year.monthday.time. So version number 2007.1204.0035 was built on December 4th, 2007 at 00h35. If the components used by replcheck are not aligned, the version of each individual component is displayed.

Subcommands Options

The following options are applicable to the subcommands where they are specified.

-D bindDN
--bind-dn bindDN

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

The default is cn=Directory Manager.

-L dir-path
--log-dir dir-path

Creates a replcheck.log log file in this directory.

If this option is not specified, the replcheck.log log file will be created in the home directory.


Displays additional information.

-w password-file
--pwd-file file

Use the bind password in the specified password-file.

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


The following operands are supported:


Specifies the path to the file that describes the replication topology.

This file contains one record for each line in the following format: hostname:port:suffix_dn[:label]. The optional label field provides a name that appears in any messages that are displayed or logged. If you do not specify a label, the hostname:port are used instead.

For example, the following topology file describes a replication topology consisting of two hosts:

host2:489:dc=example,dc=com:New York


The replcheck command must access the servers in the topology using their non-secure ports. The topology file can not specify an SSL port.

Extended Description


The replcheck command diagnoses and repairs a replication halt. The replcheck diagnose subcommand compares the RUVs for each of the servers in your replication topology to determine if the masters are synchronized. If the search results show that all of the consumer replica in-memory RUVs are evolving on time or not evolving but equal to those on the supplier replicas, the tool will conclude that a replication halt is not occurring.

However, if the command determines that the consumer RUVs do not change at all over time, then the replcheck diagnose subcommand displays the repair operation it would do and exits without making the repair. Then, you can launch the replcheck fix subcommand to repair the replication halt. For example, the command determines that replication is blocked on the entry associated with CSN 24 if a supplier has a CSN of 40, while the consumer has a CSN of 23 that does not evolve at all over time.

The replcheck command can repair two types of replication halt:

Exit Status

The following exit status values are returned:


Successful completion.


An error occurred.


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




Stability Level