Tracing Reconciliation (Sun Identity Manager 8.1 System Administrator's Guide)

Sun Identity Manager 8.1 System Administrator's Guide

Tracing Reconciliation

If you are having problems with a reconciliation task, you can use the standard tracing facility on com.waveset.task.Reconciler to trace the Reconciler.

Use either of the following methods to enable tracing:

Open the Waveset Properties page (debug/Show_WSProp.jsp) in the Identity Manager Administrator interface. Locate the exception.trace key and change the Value to true.
Open the config/Waveset.properties file in a text editor, and change the exception.trace key value to true.

You can also enable tracing from the System Settings page and trace the following reconciliation methods, at the Method/Class trace Levels noted, to view useful debugging information.

Table 5–4 Reconciliation Methods/Classes to Trace


Trace this `com.waveset.recon.Method/Class`	At this Trace Level	To See
`ReconTask$WorkerThread#reconcileAccount`	2	The individual account being reconciled
`ReconTask$WorkerThread#performResponse`	2	The individual account and user during response
`ReconUtil#deleteAccountIndex`	2	User information to be deleted from the account index
`UserContext#aquireRepoLock`	2	The user who is being locked for update
`UserContext#releaseRepoLock`	2	The user who is being unlocked in the repository
`ReconUtil#deleteAccountIndex`	2	User information to be deleted from the account index
`UserContext#aquireRepoLock`	2	The user who is being locked for update
`ReconTask$WorkerThread#failUserExamination`	2	All user examination requests that failed with the error
`ReconTask$WorkerThread#failUserResponses`	2	All user response requests that failed with the error
`UserContext#releaseRepoLock`	2	The user who is being unlocked in the repository
`ReconTask$ResourceThread#examineResource`	3	How many accounts read from the resource
`ReconTask$ResourceThread#queueAccountReconciles`	3	Information about each account read from the resource such as `accountId`, `accountGUID`, `accountDisabled`
`ReconTask$ResourceThread#examineLighthouse`	3	How many Identity Manager users claim to own an account on the reconciled resource queued
`ReconTask$WorkerThread#findClaimants`	3	All Identity Manager users who claim to have an account on the resource
`ReconTask$WorkerThread#confirmPossibleOwners`	3	A list of all confirmed owners of resource accounts
`ReconTask$WorkerThread#applyResponse`	3	The response list that is being applied
`AccountContext#processAttributeWorkflow`	3	The attribute changes and the formatted changes during the launch of the attribute change workflow
`ReconUtil#getRuleState`	3	Full User view with the user’s attribute during rule processing
`ReconUtil#evaluateCorrelationRule`	3	The value of the correlation rule state and result for examination
`ReconUtil#confirmPotentialOwners`	3	A list of users who have been confirmed using the confirmation rule
`ReconUtil#getIfExistsAccountIndexEntry`	3	To output info related to examination of the account index for a specified entry
`ReconUtil#launchWorkflow`	3	The task instance and task definition information when launched
`ReconUtil#indexFoundAccount`	3	The account and situation recorded during a create or update of the index for an account known to exist
`ReconUtil#indexMissingAccount`	3	The account and situation recorded during a create or update of the index for an account NOT known to exist
`ReconUtil#listAccountsIndexSaysExist`	3	Account information that the index says exists
`ReconTask$ResourceThreadwaitForLighthouseWorkItems#`	4	How many users queued and processed during the Identity Manager user examination process
`ReconTask$ResourceThread#waitForReconcileWorkItems`	4	How many reconciles and responses queued and processed for the specified resource
`ReconTask$WorkerThread#correlateUsers`	4	A list of correlated/confirmed users
`ReconTask$WorkerThread#respondOrRequeue`	4	The error message if there is a problem performing the previous response method for an account
`Response#perform`	4	The user, response, and the user’s resource info XML before and after the modifications took place
`Response#perform`	4	A summary of the response action on the user
`Response#createNewUserFromAccount`	4	Full details of the response action on the user
`ReconUtil#evaluateConfirmationRule`	4	The value of the confirmation rule state and result for examination
`ReconUtil#getCorrelatedUsers`	4	A list of correlated users matching the specified rule result

Note –

Remember, the higher the tracing level, the larger the trace file. Also tracing all of these methods at the same time will create a very large trace file.

When you are finished troubleshooting, remember to disable tracing by setting the exception.trace key value back to false.