.TH DS-REPLCHECK 1 "Nov 26, 2018"
.SH NAME
ds-replcheck
.SH SYNOPSIS
.B ds-replcheck
[-h] [-v] {online,offline,state} ...
.SH DESCRIPTION
Replication Comparison Tool (v2.0). This script can be used to compare two
.br
replicas to see if they are in sync.
.SH OPTIONS
.SS
\fBSub-commands\fR
.TP
\fBds-replcheck\fR \fI\,online\/\fR
Compare two online replicas for differences
.TP
\fBds-replcheck\fR \fI\,offline\/\fR
Compare two replication LDIF files for differences (LDIF file generated by 'db2ldif -r')
.TP
\fBds-replcheck\fR \fI\,state\/\fR
Get the general state of replication between two replicas

.SH OPTIONS 'ds-replcheck state'
usage: ds-replcheck online [-h] -m MURL -r RURL -b SUFFIX -D BINDDN
                           [-w BINDPW] [-W] [-y PASS_FILE] [-Z CERTDIR] 

.TP
\fB\-m\fR \fI\,MURL\/\fR, \fB\-\-master\-url\fR \fI\,MURL\/\fR
The LDAP URL for the Master server

.TP
\fB\-r\fR \fI\,RURL\/\fR, \fB\-\-replica\-url\fR \fI\,RURL\/\fR
The LDAP URL for the Replica server

.TP
\fB\-b\fR \fI\,SUFFIX\/\fR, \fB\-\-suffix\fR \fI\,SUFFIX\/\fR
Replicated suffix

.TP
\fB\-D\fR \fI\,BINDDN\/\fR, \fB\-\-bind\-dn\fR \fI\,BINDDN\/\fR
The Bind DN

.TP
\fB\-w\fR \fI\,BINDPW\/\fR, \fB\-\-bind\-pw\fR \fI\,BINDPW\/\fR
The Bind password

.TP
\fB\-W\fR, \fB\-\-prompt\fR
Prompt for the bind DN password

.TP
\fB\-y\fR \fI\,PASS_FILE\/\fR, \fB\-\-pass\-file\fR \fI\,PASS_FILE\/\fR
A text file containing the clear text password for the bind dn

.TP
\fB\-Z\fR \fI\,CERTDIR\/\fR, \fB\-\-cert\-dir\fR \fI\,CERTDIR\/\fR
The certificate database directory for secure connections


.SH OPTIONS 'ds-replcheck online'
usage: ds-replcheck online [-h] -m MURL -r RURL --rid RID -b SUFFIX -D BINDDN
                           [-w BINDPW] [-W] [-y PASS_FILE] [-l LAG] [-c]
                           [-Z CERTDIR] [-i IGNORE] [-p PAGESIZE] [-o FILE]


.TP
\fB\-m\fR \fI\,MURL\/\fR, \fB\-\-master\-url\fR \fI\,MURL\/\fR
The LDAP URL for the Master server

.TP
\fB\-r\fR \fI\,RURL\/\fR, \fB\-\-replica\-url\fR \fI\,RURL\/\fR
The LDAP URL for the Replica server

.TP
\fB\-b\fR \fI\,SUFFIX\/\fR, \fB\-\-suffix\fR \fI\,SUFFIX\/\fR
Replicated suffix

.TP
\fB\-D\fR \fI\,BINDDN\/\fR, \fB\-\-bind\-dn\fR \fI\,BINDDN\/\fR
The Bind DN

.TP
\fB\-w\fR \fI\,BINDPW\/\fR, \fB\-\-bind\-pw\fR \fI\,BINDPW\/\fR
The Bind password

.TP
\fB\-W\fR, \fB\-\-prompt\fR
Prompt for the bind DN password

.TP
\fB\-y\fR \fI\,PASS_FILE\/\fR, \fB\-\-pass\-file\fR \fI\,PASS_FILE\/\fR
A text file containing the clear text password for the bind dn

.TP
\fB\-l\fR \fI\,LAG\/\fR, \fB\-\-lag\-time\fR \fI\,LAG\/\fR
The amount of time to ignore inconsistencies (default 300 seconds)

.TP
\fB\-c\fR, \fB\-\-conflicts\fR
Display verbose conflict entry information

.TP
\fB\-Z\fR \fI\,CERTDIR\/\fR, \fB\-\-cert\-dir\fR \fI\,CERTDIR\/\fR
The certificate database directory for secure connections

.TP
\fB\-i\fR \fI\,IGNORE\/\fR, \fB\-\-ignore\fR \fI\,IGNORE\/\fR
Comma separated list of attributes to ignore

.TP
\fB\-p\fR \fI\,PAGESIZE\/\fR, \fB\-\-page\-size\fR \fI\,PAGESIZE\/\fR
The paged\-search result grouping size (default 500 entries)

.TP
\fB\-o\fR \fI\,FILE\/\fR, \fB\-\-out\-file\fR \fI\,FILE\/\fR
The output file

.SH OPTIONS 'ds-replcheck offline'
usage: ds-replcheck offline [-h] -m MLDIF -r RLDIF --rid RID -b SUFFIX [-c]
                            [-i IGNORE] [-o FILE]


.TP
\fB\-m\fR \fI\,MLDIF\/\fR, \fB\-\-master\-ldif\fR \fI\,MLDIF\/\fR
Master LDIF file

.TP
\fB\-r\fR \fI\,RLDIF\/\fR, \fB\-\-replica\-ldif\fR \fI\,RLDIF\/\fR
Replica LDIF file

.TP
\fB\-\-rid\fR \fI\,RID\/\fR
The Replica Identifier (rid) for the "Master" server

.TP
\fB\-b\fR \fI\,SUFFIX\/\fR, \fB\-\-suffix\fR \fI\,SUFFIX\/\fR
Replicated suffix

.TP
\fB\-c\fR, \fB\-\-conflicts\fR
Display verbose conflict entry information

.TP
\fB\-i\fR \fI\,IGNORE\/\fR, \fB\-\-ignore\fR \fI\,IGNORE\/\fR
Comma separated list of attributes to ignore

.TP
\fB\-o\fR \fI\,FILE\/\fR, \fB\-\-out\-file\fR \fI\,FILE\/\fR
The output file

.TP
\fB\-v\fR, \fB\-\-verbose\fR
Verbose output

.SH AUTHOR
ds-replcheck was written by the 389 Project.

.SH "REPORTING BUGS"
Report bugs to https://pagure.io/389-ds-base/new_issue

.SH COPYRIGHT
Copyright \(co 2018 Red Hat, Inc.