Red Hat Directory Server 8.0 Administrator's Guide

7.5. Initializing Consumers Online from the Command Line
An online initialization can be initiated from the command line by adding the
nsds5replicarefresh attribute to the replication agreement entry. If the attribute is included
when the replication agreement is created, initialization begins immediately. It can be added
later to initialize the consumer at any time. This attribute is absent by default, and it will be
automatically deleted once the consumer initialization is complete.
1. Find the DN of the replication agreement on the supplier server that is for the consumer to be
initialized. For example:
ldapsearch -h supplier1.example.com -p 389 -D "cn=directory manager" -w
password -s sub
-b cn=config "(objectclass=nsds5ReplicationAgreement)"
This command returns all of the replication agreements configured on the supplier in LDIF
format. Get the DN of the replication agreement with the consumer to be initialized. This is
the replication agreement which will be edited.
2. Edit the replication agreement, and add the nsds5BeginReplicaRefresh attribute:
ldapmodify -h supplier1.example.com -p 389 -D "cn=directory manager" -w
password
dn: cn=ExampleAgreement,cn=replica,cn="dc=example,dc=com",cn=mapping
tree,cn=config
changetype: modify
replace: nsds5beginreplicarefresh
nsds5beginreplicarefresh: start
ldapmodify does not prompt for input; simply type in the LDIF statement, and then hit enter
twice when the LDIF statement is complete. Close the ldapmodify utility by hitting Ctrl+C.
When the initialization is complete, the nsds5beginreplicarefresh attribute is automatically
deleted from the replication agreement entry.
NOTE
Initializing consumers from the command line is also explained in Section 10.3,
“Initializing Consumers Online Using the Command Line”. Manually initializing
consumers is explained in Section 10.4, “Manual Consumer Initialization Using
the Command Line”. The replication monitoring attributes are described in more
detail in the Directory Server Configuration, Command, and File Reference.
To keep data integrity, initialize the consumer databases from the appropriate supplier.
the Command Line
321