Command-line utilities to view replication status

Edit online

To determine issues that are related to replication, it is important to view the status of a replication agreement. You can use command-line utilities to view the appropriate operational attributes that are associated with replication.

The two special attributes, +ibmrepl and ++ibmrepli, are defined to request replication-related operational attributes in a search. The + and ++ are subsets of the operational attributes. The single + is less expensive. The ++ includes all operational attributes that are shown in the + attribute list and the attributes that are listed in the ++ column as shown in the table.
Table 1. Replication-related operational attributes
Attribute "+" Attribute list "++" Attribute list
+ibmrepl

ibm-replicationChangeLDIF
ibm-replicationLastActivationTime
ibm-replicationLastChangeId
ibm-replicationLastFinishTime
ibm-replicationLastResult
ibm-replicationLastResultAdditional
ibm-replicationNextTime
ibm-replicationPendingChangeCount
ibm-replicationState
ibm-replicationFailedChangeCount
ibm-replicationperformance

++ibmrepl includes the attributes from +ibmrepl and the following attributes:

ibm-replicationPendingChanges
ibm-replicationFailedChanges
To search a specific replication agreement, issue the ldapsearch command in the following format: 
idsldapsearch -h hostname -p port -D cn=adminDN -w adminPW \
-b ReplicationAgreement objectclass=* ++ibmrepl
For example, 
idsldapsearch -h peer1 -p 1389 -D cn=root -w password -b cn=peer2:2389,\
cn=peer1:1389,ibm-replicaGroup=default,O=sample objectclass=* ++ibmrepl
To search all agreements, issue the ldapsearch command in the following format: 
idsldapsearch -h hostname -p port -D cn=adminDN -w adminPW \
-s sub -b " " objectclass=ibm-replicationagreement ++ibmrepl
For example, 
idsldapsearch -h peer1 -p 1389 -D cn=root -w password -s sub -b " " \
objectclass=ibm-replicationagreement ++ibmrepl
To know more about replication status, see Monitoring replication status in the Administering section in the IBM® Security Verify Directory documentation.