Replication status
You can use the idsldapsearch command to get replication status information. Use the operational attributes to search for various details that can help you monitor the replication status.
Note: The following idsldapsearch examples are
based on the sample replication topology that is provided in the topic, Sample replication topology.
There are many operational attributes that provide replication
status information when explicitly requested on a search. One of these
attributes is associated with the entry that is the base of the replicated
subtree, that is, the entry that the
ibm-replicationContext object
class was added to. If you do a base search of that entry and request
that the ibm-replicationIsQuiesced attribute
is returned, the return attribute indicates whether the subtree was
quiesced; for example: idsldapsearch -h hostname -p port -b "o=sample" -s "base"
"objectclass=ibm-replicationContext" ibm-replicationIsQuiesced The remainder of the status-related operational attributes is
all associated with a replication agreement object. These attributes
are only returned when explicitly requested on the search; for example,
the following idsldapsearch example requests replication
agreement status information that indicates the replication state
for all the replication agreements:
idsldapsearch -h hostname -p port -b "o=sample" -s "sub"
"objectclass=ibm-replicationAgreement" ibm-replicationState- ibm-replicationLastActivationTime
- The time that the last replication session started between this supplier and consumer.
- ibm-replicationLastFinishTime
- The time that the last replication session finished between this supplier and consumer.
- ibm-replicationLastChangeId
- The change ID of the last update that is sent to this consumer.
- ibm-replicationLastGlobalChangeId
- The change ID of the last update to a global entry sent to this consumer. Global entries are things like cn=schema or cn=pwdpolicy that apply to the entire contents of a DIT.
- ibm-replicationState
- The current state of replication with this consumer. Possible
values are:
- Ready
- In immediate replication mode, ready to send updates as they occur.
- Retry
- An error exists, and an update to correct the error is sent every 60 seconds.
- Waiting
- Waiting for next scheduled replication time.
- Binding
- In the process of binding to the consumer.
- Connecting
- In the process of connecting to the consumer.
- OnHold
- This replication agreement is suspended or "held".
- Error log full
- The replication errors that occurred are more than can be logged.
The number of errors that can be logged is based on the configured
value for
ibm-slapdReplMaxErrors.
- ibm-replicationLastResult
- The results of the last attempted update to this consumer, in
the form:
This attribute is available only if the replication method is single threaded.timestamp change ID result code operation entry DN - ibm-replicationLastResultAdditional
- Any additional error information that is returned from the consumer for the last update. This attribute is available only if the replication method is single threaded.
- ibm-replicationPendingChangeCount
- The number of updates queued to be replicated to this consumer.
- ibm-replicationPendingChanges
- Each value of this attribute gives information about one of the
pending changes in the form:
Requesting this attribute might return many values. Check the change count before you request this attribute.change ID operation entry DN - ibm-replicationChangeLDIF
- Gives the full details of the last failing update in LDIF. This attribute is available only if the replication method is single threaded.
- ibm-replicationFailedChangeCount
- Indicates the total number of failed changes that are logged for the specified replication agreement.
- ibm-replicationFailedChanges
- Lists the IDs, DNs, update types, result codes, timestamps, numbers of attempts for failures that are logged for a specified replication agreement.
- ibm-replicationperformance
- Give the operation counts per connection for multi-threaded replication.