Skip Headers
Oracle® Identity Management User Reference
10g Release 2 (10.1.2)
B15883-01
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

5.2 hiqpurge.sh

When a replication conflict arises, the Oracle Internet Directory replication server places the change in the retry queue and tries to apply it from there for a specified number of times. If it fails after that specified number, then the replication server puts the change in the human intervention queue. From there, the replication server repeats the change application process at less frequent intervals while awaiting your action.

At this point, you need to:

  1. Examine the change in the human intervention queue.

  2. Reconcile the conflicting changes using the Oracle Internet Directory Reconciliation Tool (see "oidreconcile").

  3. Either place the change back into the retry queue (see "hiqretry.sh") or into the purge queue (using hiqpurge.sh).

5.2.1 Syntax for hiqpurge.sh

hiqpurge.sh -connect connect_string {{-start change_number -end change_number }| {-equal change_number }} -supplier supplier_node

5.2.2 Arguments for hiqpurge.sh

-connect connect_string

Required. The directory database connect string. If you already have a tnsnames.ora file configured, then this is the net service name specified in that file, which is located in $ORACLE_HOME/network/admin.

-start change_number

When specifying a range of change numbers to move from the human intervention queue into the purge queue, this argument specifies the starting change number. If you skip this argument, then the tool moves all the changes with change numbers less than or equal to the specified end change number to the purge queue.

-end change_number

When specifying a range of change numbers to move from the human intervention queue into the purge queue, this argument specifies the ending change number. If you skip this argument, then the tool moves all the changes with change numbers greater than or equal to the specified start change number to the purge queue.

-equal change_number

This argument specifies a single change number to move from the human intervention queue to the purge queue. This argument cannot be used with the -start or -end arguments.

-s supplier_node

Required. Specifies the supplier node where the changes originate.

5.2.3 Tasks and Examples for hiqpurge.sh

Using the hiqpurge.sh command-line tool, you can perform the following tasks:

5.2.3.1 Discarding a HIQ Change Log

The following example shows how to move a single replication change log conflict from the human intervention queue (HIQ) into the purge queue. It moves the change numbered 10519 coming from the supplier node ldap_rep1.

Example:

hiqpurge.sh -connect oiddb1 -equal 10519 -supplier ldap_repl

5.2.3.2 Discarding a Range of HIQ Change Logs

The following example shows how to move a range of replication change log conflicts from the human intervention queue (HIQ) into the purge queue. It moves changes numbered between 10324 to 10579 coming from the supplier node ldap_rep1.

Example:

hiqpurge.sh -connect oiddb1 -start 10324 -end 10579 -supplier ldap_repl

5.2.3.3 Discarding all HIQ Change Logs from a Supplier

The following example shows how to move all replication change log conflicts originating from a certain supplier from the human intervention queue (HIQ) into the purge queue. It moves changes coming from the supplier node ldap_rep1.

Example:

hiqpurge.sh -connect oiddb1 -supplier ldap_repl

5.2.4 Related Command-Line Tools for hiqpurge.sh