IBM Support

Workflow transfer failed in a side by side container and traditional Content Platform Engine deployment environment

Troubleshooting


Problem

In a Content Platform Engine (CPE) environment, where CPE deployment on a traditional WebShere Application Server (tWAS) and a CPE container deployment on a Kubernetes or OpenShift cluster are running side by side, a workflow transfer operation can fail.
When a transfer fails, an error is captured in Process Engine (PE) log, for example,
FNRPE2130670002E Failed API_TransferConfig operation.
Exception==[FNRPE2130670002E]Exception encountered executing RPC: http://10.135.23.566:42131/peserverapi?name=jpe_rpc_RemoteLockSingleRegionForModify.
....
Caused by: java.net.ConnectException: http://10.135.23.566:42131/peserverapi?name=jpe_rpc_RemoteLockSingleRegionForModify
....
Note:  10.135.23.566:42131 is internal network of the CPE container.

Cause

A workflow transfer operation requires the communication between all PE servers in a PE cluster or farm in order to acquire exclusive region lock.

Because the container has its own internal private network, e.g. IP 10.135.23.566 in the error message, the PE servers in traditional CPE deployment are not able to communicate with the containerized PE running in the CPE container. Therefore, the error occurs during the transfer when a PE server in tWAS attempts to reach a PE server in container.

Resolving The Problem

In a side by side traditional and container environment, any PE-related operations that require PE to PE communication like workflow transfer must be initiated from the container deployment.

To perform a workflow transfer operation, use the URL with a hostname to the CPE container cluster to log on to Administration Console for Content Platform Engine, Content Navigator, or Process Designer.
 
Alternatively, stop all CPE containers and then perform the workflow transfer from a traditional CPE deployment.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSP11B","label":"FileNet Business Process Manager"},"ARM Category":[{"code":"a8m0z000000cvrSAAQ","label":"Process Engine-\u003ETransfer"}],"ARM Case Number":"TS010706021","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
02 November 2022

UID

ibm16832472