IBM Tivoli Directory Server 6.0 - ReplicationApril 24, 2007Using the idsldapexop extended operation command
IBM Tivoli Directory Server 6.0 - Replication April 24, 2007 Using the idsldapexop extended operation command
LDAP Extended Operations - idsldapexop
LDAP Extended Operations - idsldapexop Anything that can be done from the WebAdmin can be done in some way via command line. One of the utilities we use for command line replication is: idsldapexop Documentation on the command: http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDS.doc/progref05.htm#idx65
LDAP Extended Operations
LDAP Extended Operations A very useful ldapsearch command with available replication related operational attributes: This gives the current status and info about the replication agreement. ldapsearch -h hostName -p 389 -D cn=root -w
-b objectclass=* ibm-replicationIsQuiesced ibm-replicationLastActivationTime ibm-replicationLastChangeId ibm-replicationLastFinishTime ibm-replicationLastGlobalChangeId ibm-replicationLastResult ibm-replicationLastResultAdditional ibm-replicationNextTime ibm-replicationPendingChangeCount ibm-replicationPendingChanges ibm-replicationState ibm-replicationThisServerIsMaster ibm-replicationFailedChangeCount ibm-replicationFailedChanges e.g.: You can use any of the above mentioned operational attributes as necessary. ldapsearch -h peer1 -p 389 -D cn=root -w -b cn=peer2:389,cn=peer1:389,ibm-replicaGroup=default,O=IBM,C=US objectclass=* ibm-replicationState
Queue Control with an extended op
Queue Control with an extended op ldapexop - cascading control replication extended operation: The requested action is applied to the specified server and also passed along to all replicas of the given subtree. If any of these are forwarding replicas, they pass the extended operation along to their replicas. The operation cascades over the entire replication topology. ldapexop -h hostName -D cn=root -w -op cascrepl -action {quiesce | unquiesce | replnow | wait} -rc Where can be one of the four values: quiesce - No further updates are allowed, except by replication. unquiesce - Resume normal operation, client updates are accepted. replnow - Replicate all queued changes to all replica servers as soon as possible, regardless of schedule. wait - Wait for all updates to be replicated to all replicas. e.g.: ldapexop -h hostName -D cn=root -w -op cascrepl -action quiesce -rc O=IBM,C=US
Skipping blocking entries with an extended op
Skipping blocking entries with an extended op ldapexop - control queue extended operation: ldapexop -h hostName -D cn=root -w -op controlqueue -skip {all | change-id} -ra Where "all" indicates to skip all pending changes for this agreement and "change-id" identifies the single change to be skipped. If the server is not currently replicating this change, the request fails. e.g.: ldapexop -h hostName -D cn=root -w -op controlqueue -skip all -ra cn=peer2:389,cn=peer1:389,ibm-replicaGroup=default,O=IBM,C=US
Suspending the queue
Suspending the queue ldapexop - control replication extended operation: ldapexop -h hostName -D cn=root -w -op controlrepl -action {suspend | resume | replnow} {-rc | -ra } If -rc is provided then the action is performed for all agreements for this context. e.g.: ldapexop -h hostName -D cn=root -w -op controlrepl -action suspend -ra cn=peer2:389,cn=peer1:389,ibm-replicaGroup=default,O=IBM,C=US
Controlling
Controlling ldapexop - control replication error extended operation: ldapexop -h hostName -D cn=root -w -op controlreplerr {[-delete failure-ID | all] | [-retry failure-ID | all] | [-show failure-ID]} -ra Where either of -delete, -retry or -show must be specified with appropriate failure-ID. e.g.: ldapexop -h hostName -D cn=root -w -op controlreplerr -delete all -ra cn=peer2:389,cn=peer1:389,ibm-replicaGroup=default,O=IBM,C=US
Quiesce or Unquiesce the queue
Quiesce or Unquiesce the queue ldapexop: quiesce or unquiesce subtree extended operation: ldapexop -h hostName -D cn=root -w -op quiesce [-end] -rc If -end is specified the ReplicationContext gets unquiesced. e.g.: ldapexop -h hostName -D cn=root -w -op quiesce -rc O=IBM,C=US
The ldapexop to push your replication topology
The ldapexop to push your replication topology ldapexop: replication topology extended operation - replicates the replication topology related entries under the specified context: ldapexop -h hostName -D cn=root -w -op repltopology -rc [-ra ] [-timeout secs] e.g.: ldapexop -h hostName -D cn=root -w -op repltopology -rc O=IBM,C=US -ra cn=peer2:389,cn=peer1:389,ibm-replicaGroup=default,O=IBM,C=US -timeout 60 For more details refer to Admin guide.
Copyright and trademark information
Copyright and trademark information © Copyright IBM Corporation 2000 - 2007. All rights reserved. U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. IBM web site pages may contain other proprietary notices and copyright information which should be observed. IBM trademarks http://www.ibm.com/legal/copytrade.shtml#ibm Fair use guidelines for use and reference of IBM trademarks http://www.ibm.com/legal/copytrade.shtml#fairuse General rules for proper reference to IBM product names http://www.ibm.com/legal/copytrade.shtml#general Special attributions IBM, the IBM logo and DB2 are trademarks of International Business Machines Corporation in the United States, other countries, or both. MMX, Pentium, and ProShare are trademarks of Intel Corporation in the United States, other countries, or both. Microsoft and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Other company, product or service names may be trademarks or service marks of others.