- Product: RSA Identity Governance & Lifecycle
- Version: 7.0.x, 7.1.x, 7.2.x
- Component: Workpoint Server, Workflow Engine, Change Request Processing
- Tool: SQL Server
RSA Identity Governance & Lifecycle uses third-party software called Workpoint to manage workflow processing queues. When these queues become overloaded, workflows stall and change request processing slows or stops entirely — bringing the application to a virtual halt.
Use this article if you are observing any of the following:
- Workflow stall messages appearing in the application
- Change requests are processing significantly slower than usual or have stopped completely
- The Workpoint server has shut down
CAUTION: Do NOT cancel any change requests or clear queue entries without first following the detection steps in this article. Cancelling valid work in the Workpoint queues can cause data loss or incomplete provisioning.
This article covers two tasks. Complete them in order — Task 2 cannot be performed until Task 1 is complete.
| Task | Action | Who Performs | Tool / Method |
|---|---|---|---|
| Task 1: Detect and Terminate | Run SQL diagnostic queries to identify and terminate the aberrant change request or workflow | Customer (with RSA Support guidance if needed) | SQL as avuser |
| Task 2: Clean Up Workpoint Queues | Remove overloaded entries from Workpoint monitoring queues | RSA Support | Engaged via support case |
Shared connection details (Task 1):
| Parameter | Value |
|---|---|
| Database User | avuser |
| Tool | SQL*Plus or SQL Developer |
| Database | RSA Identity Governance & Lifecycle Oracle DB |
Task 1: Detect and Terminate the Aberrant Change Request or Workflow
CAUTION: Do NOT cancel any change requests or queue entries until you have identified the specific aberrant workflow or change request. Cancelling valid work can cause data loss or incomplete provisioning.
- Log in to your SQL tool (e.g., SQL*Plus or SQL Developer) as
avuser. - Run the following query against the Job monitor table to identify workflows or change requests overloading the queue.
SELECT * FROM ( SELECT wpi.cr_id, wpi.name, wpi.proc_state_id, job.* FROM wp_proci wpi JOIN ( SELECT proci_id, COUNT(proci_id) AS num_of_work_in_q FROM wp_JOB_monitor GROUP BY proci_id HAVING COUNT(proci_id) > 5 ORDER BY COUNT(proci_id) ) job ON wpi.proci_id = job.proci_id ) ORDER BY num_of_work_in_q DESC; - Run the same query against the Alert monitor table.
SELECT * FROM ( SELECT wpi.cr_id, wpi.name, wpi.proc_state_id, job.* FROM wp_proci wpi JOIN ( SELECT proci_id, COUNT(proci_id) AS num_of_work_in_q FROM wp_ALERT_monitor GROUP BY proci_id HAVING COUNT(proci_id) > 5 ORDER BY COUNT(proci_id) ) job ON wpi.proci_id = job.proci_id ) ORDER BY num_of_work_in_q DESC; - Run the same query against the Script monitor table.
SELECT * FROM ( SELECT wpi.cr_id, wpi.name, wpi.proc_state_id, job.* FROM wp_proci wpi JOIN ( SELECT proci_id, COUNT(proci_id) AS num_of_work_in_q FROM wp_SCRIPT_monitor GROUP BY proci_id HAVING COUNT(proci_id) > 5 ORDER BY COUNT(proci_id) ) job ON wpi.proci_id = job.proci_id ) ORDER BY num_of_work_in_q DESC; - Review the query results across all three runs.
- The
cr_idcolumn returns the internal ID of the associated change request. Ifcr_idisnull, the job is not associated with a change request — it is a standalone workflow. - Look for the change request or workflow with the highest
num_of_work_in_qvalue. - A healthy workflow job should add close to one entry per queue. Entries in double digits or higher indicate an aberrant workflow or change request.
- The
- If you identify entries in double digits or higher, contact RSA Support. Provide the
cr_id,name, andnum_of_work_in_qvalues from your query output. RSA Support will assist with identifying and terminating the aberrant change request or workflow. - Verification: After RSA Support has confirmed the termination, re-run the three queries from Steps 2–4. Confirm that the
num_of_work_in_qvalues for the previously identified change request or workflow have dropped to zero or are no longer returned in the results.
Task 2: Clean Up the Workpoint Monitoring Queues
NOTE: Task 2 must only be started after Task 1 is fully complete and RSA Support has confirmed the aberrant change request or workflow has been terminated.
- Open a support case with RSA Support and inform them that:
- The aberrant change request or workflow has been terminated (per Task 1).
- You are requesting cleanup of the Workpoint monitoring queues.
- Work with RSA Support to complete the queue cleanup. RSA Support will confirm when the cleanup is complete.
- Verification: After the cleanup is confirmed, monitor the Workpoint queues continuously for a period of time to ensure the issue does not recur. RSA Support will advise on the recommended monitoring duration based on your environment.
Related Articles
How to Update the Root (Server) and Client Certificates in RSA Identity Governance & Lifecycle 2.3KNumber of Views How to Download and Reinstall the AFX Server Archive in RSA Governance & Lifecycle 1.58KNumber of Views How to Replace the Web Server Certificate for the RSA Identity Governance & Lifecycle Web Console 3.29KNumber of Views Troubleshooting AFX Server issues in RSA Identity Governance & Lifecycle 571Number of Views Change Requests stuck in the AFX Fulfillment Handler Workflow Node and Workflows Stalled in RSA Identity Governance & Life… 1.08KNumber of Views
Trending Articles
RSA MFA Agent 2.3.6 for Microsoft Windows Installation and Administration Guide RSA MFA Agent 2.5 for Microsoft Windows Installation and Administration Guide How to manipulate imported RSA SecurID Software Token(s) on an iPhone or iPad device Download RSA SecurID Access Cloud Administration audit logs using Cloud Administration REST API CLU RSA Authentication Manager Upgrade Process