IBM Support

Deploying a snapshot for IBM Business Process Manager (BPM) fails with a branch not found error

Troubleshooting


Problem

When you deploy a snapshot for IBM Business Process Manager, it fails to install. When you check the SystemOut.log file for the target Process Server, you see the following error: com.ibm.bpm.pal.PALException: Branch with ID Branch.f976ded0-3eb5-486f-a530-645a90b5337c not found.

Symptom

The two main factors for this issue are:

  • This issue generally does not occur on the first installation attempt after you restart the server.
  • In the error stack, during the installation process, you can see text that is similar to the following messages:
    CWLLG2229E: An exception occurred in an EJB call.  Error: Branch with ID Branch.1c965df4-3789-4712-aa1d-0194421e6b07 not found.
    com.ibm.bpm.pal.PALException: Branch with ID Branch.1c965df4-3789-4712-aa1d-0194421e6b07 not found.
    at com.ibm.bpm.pal.Container.<init>(Container.java:63)
    at com.lombardisoftware.core.deployment.InstallmentStateMachine$5.call(InstallmentStateMachine.java:380)
    at com.lombardisoftware.core.deployment.InstallmentStateMachine$5.call(InstallmentStateMachine.java:330)
    at com.lombardisoftware.server.ejb.persistence.versioning.BranchManager$5.call(BranchManager.java:582)
    ...
    at com.lombardisoftware.server.ejb.persistence.versioning.BranchManager.mutateInSingleTransaction(BranchManager.java:577)
    at com.lombardisoftware.core.deployment.InstallmentStateMachine.installPackage(InstallmentStateMachine.java:330)

Cause

The cache that is used to store the snapshot details has become corrupted. This situation occurs because the snapshot exists in the cache, but it is not in the Process Server database. This corruption can be caused by previous installation failures or product defects. Although this issue should not occur in most versions, you might see this problem after deleting a snapshot if the cache is not properly cleared.

The problems described in the following documents can also cause this issue:

Resolving The Problem

To work around the issue, you can restart the target Process Server (application cluster).
Also, you need to investigate any previous failures that have occurred when you have installed the same snapshot. If there are previous failures, then these issues need to be resolved to prevent the branch errors.


This issue also can be caused by duplicate deployment attempts for the snapshot running concurrently. If this issue occurs, then restart the server and ensure that only one deployment attempt is triggered. You can look for the following messages that refer to the start and end of a deployment on the Process Center to determine whether you have concurrent deployment attempts:
CWLLG0146I: Beginning export install for snapshot MySnapshot to server MyBPMServer.
CWLLG0156I: MySnapshot Install succeeded

[{"Product":{"code":"SSFTDH","label":"IBM Business Process Manager Standard"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Application Deployment","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF002","label":"AIX"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0.1;8.0;7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Application Deployment","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"","label":"Linux zSeries"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"8.0.1;8.0;7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTBX","label":"IBM Business Process Manager Express"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Application Deployment","Platform":[{"code":"PF016","label":"Linux"},{"code":"","label":"Linux zSeries"},{"code":"PF033","label":"Windows"}],"Version":"8.0.1;8.0;7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

BPM

Document Information

Modified date:
15 June 2018

UID

swg21632938

Page Feedback