Note: This Article only applies to systems being upgraded from BPM 3.x to the following BPM versions:
- 4.2 GA, HF1 or HF2 - 4.1 GA - 4.0 GA or HF1
During BPM 4.x upgrade process, the task "Wait for empty queues" can fail if
BPM Environment's Messaging Bus configuration is wrong in AMX Admin; or
BPM Environment is not named BPMEnvironment
Symptoms
TCT log (for Upgrade BPM) will show stacktraces in the "Wait for empty queues" task, followed by:
WARN - Failed getting queue details null
TCT will proceed with the upgrade. TCT may loop (or even timeout) with an unchanging "pending tasks" count, because BPM Nodes have hang during shutdown/startup. The upgrade may end with BUILD SUCCESSFUL - but this could give false confidence: upgrading BPM DB schema with a non-empty workqueue may cause database corruption/inconsistency, which can manifest as a variety of seemingly-unrelated errors in the BPM/Node logs.
If your upgrade from 3.x exhibits any of these symptoms:
Revert system to the pre-upgrade backup
Apply the fix described below
Retry the BPM upgrade using TCT
Environment
BPM 3.x, any OS/DB combination
upgrading from BPM 3.x to 4.2, or 4.1 (GA), or 4.0 (GA, HF1)
Resolution
To avoid the problem when upgrading to BPM 4.0 or 4.1, install the latest Hotfix (of the target BPM version) before performing BPM Upgrade using TCT.
Note: The fix for issue WRM-9149 is not included in BPM 4.2 GA, Hotfix 1 or Hotfix 2. Upgrading to 4.2 from BPM 3.x (or earlier) will encounter this problem, whenever the BPM Environment is not named BPMEnvironment
To avoid this problem, edit the following file before running Upgrade BPM wizard in TCT: