Processes stuck / hung - troubleshooting

book

Article ID: 129918

calendar_today

Updated On:

Products

Clarity PPM On Premise Clarity PPM SaaS

Issue/Introduction

This document provides some tips on troubleshooting process stuck/hung issues as well as links to KBs on known causes.

Environment

Release: All Supported Releases
Component: Clarity Process Management

Resolution

Tips for optimizing performance health of processes

  1. Delete old processes in the Done or Aborted state.
  2. Retry or Abort and Delete old processes in the Error state. See more details at How can I keep my process engine healthy?
  3. If the issue is related to a single process which performs some type of data load, it might be slow because of multiple instances of the process running at the same time. In this scenario checking the "Do not start a new process if one is already running" flag on process definition will help.

Log troubleshooting

Review of the bg-ca.logs / bg-system.logs can assist in determining a root cause / fix. Additionally, enabling process debugging (see KB :Process debugging - Enabling for Troubleshooting) may help further in troubleshooting.

If an error is found in the logs, searching our knowledgebase on that error may help in determining the root cause / fix needed.

Symptom Troubleshooting

Not Starting

  • Processes do not start intermittently - For this issue the below error message is seen in the bg-ca.logs:
    Error message: [CA Clarity][SQLServer JDBC Driver][SQLServer]Transaction (Process ID 65) was deadlocked on lock resources with another process and has been chosen as the deadlock victim. Rerun the transaction.

Stuck with Error

Gel Processes stuck

Stuck at Evaluate Pre or Post-Condition

Stuck at the Review step

Aborting / Aborted Status Issues

Fails with error

System Actions

Process Engine Down / Stuck

Check for processes in 'Aborting' status (Administration > Data Administration > Processes). If processes are stuck in aborting status, see Aborting / Aborted Status issues section above. 

Completion Message not displaying

Notifications not sent

If Broadcom support assistance is needed

The below details can aid support in troubleshooting stuck process issues:

  1. Is it just certain processes that are stuck?
  2. How long has the issue been occurring?
  3. Has there been any recent upgrade, a new patch applied or known change in the environment?
  4. Do out of the box processes run okay? 
    Tip: You can check Administration-Processes->Initiated, and filter on Status of Error in case the processes are erroring versus stuck.
    • If you click on the icon on the Messages column, it will give more details of the error, and sometimes give you the ability to correct the issue from there. (Example, if there's no one to assign an action item to in the process, it gives a reassign link).
    • Some objects give specific details as to where the issue is located, for example Timesheets.
  5. Do jobs appear to be running okay? 
  6. If On Premise, please provide a copy of the bg-ca.logs and bg-system.logs for the time frame the issue occurred. Enabling process debugging (see KB: Process debugging - Enabling for Troubleshooting) may help in further investigation
  7. Screen shots of the 2 below pages: 
    • Administration->Data Administration->Process Engine page. On Premise customers can also run the following query and send the results: 
select * from BPM_RUN_PROCESS_ENGINES order by heart_beat desc
    • From the Process Engine Page, click on the link to the process engine and take a screen shot of that page as well

Additional Information

See Process engine - keeping it healthy

See Monitoring process engine activity in Clarity

Attachments