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 Waveset 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 Waveset users claim to own an account on the reconciled resource queued |
ReconTask$WorkerThread#findClaimants |
3 |
All Waveset 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 Waveset 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 |
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.