Red Hat DIRECTORY SERVER 8.0, Administration Manual, Page: 301 / 552

Initializing Consumers Online Using the Command Line
283
To update this window, right-click the replicated database icon in the navigation tree, and choose
Refresh Replication Agreements
. When online consumer initialization finishes, the status changes
to reflect this.
For more information about monitoring replication and initialization status, see
Section 8.17,
“Monitoring Replication Status”
.
8.10.3. Initializing Consumers Online Using the Command Line
Online consumer initialization can be performed through the command line by adding the
nsds5BeginReplicaRefresh
attribute to the replication agreement entry. 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
.
To check the initialization status, do an
ldapsearch
for the replication agreement entry.
ldapsearch -h hostname -p port -D "cn=directory manager" -w password -s base
-b 'cn=ExampleAgreement,cn="dc=example,dc=com", cn=mapping tree, cn=config'
'(objectclass=*)'
If the
nsds5BeginReplicaRefresh
attribute is present, the initialization is still in progress. If the
initialization is complete, then the attribute
nsds5ReplicaLastInitStatus
shows the status. If
the initialization was successful, the value of
nsds5ReplicaLastInitStatus
is
Total update
succeeded
. If the initialization was not successful, this attribute shows information about the error;
check the error logs for both the supplier and consumer for additional information.
The replication monitoring attributes are described in more detail in the
Directory Server Configuration,
Command, and File Reference
.
8.10.4. Manual Consumer Initialization Using the Command Line
Manual consumer initialization using the command-line is the fastest method of consumer initialization
for sites that are replicating very large numbers of entries. However, the manual consumer initialization