Each custom BPM application (app) depends on the system BPM app (commonly known as amx.bpm.app). amx.bpm.app provides a set of default resource instances (RIs) and substitution variables (SVARs). Some of these default RIs use SVARs from the node scope. 

The custom BPM applications (apps) can have a need for their own set of resource instances. Also, these custom resource instances can be configured to use substitution variables (SVARs). 

When creating an additional BPM node on an existing environment, the amx.bpm.app and the custom BPM apps are deployed to the new node. However, the scripts do not handle the dependencies which the custom BPM apps require to be deployed correctly. 

This can cause the following types of issues - 

Issue 1 - Custom RIs are not installed when defined at Global or Node scope

Custom RIs, which are not at the scope amx.bpm.app, are not installed on the new node. 

After execution of the scripts, the following symptoms are seen - 

- Creation of the new node is successful
- Custom BPM apps that use such RIs will remain as Out of Sync, as they are distributed and not yet deployed on the new node. 
- System Node has an error similar to - 

com.tibco.amx.admin.api.application - TIBCO-AMX-ADMIN-012016: Deployment failed for application 'com.example.custom.app'

com.tibco.amx.admin.api.application - TIBCO-AMX-ADMIN-012062: Missing resource instance 'customRI' for node 'BPMNode'. It is used by reference 'CustomPortTypeSOAP_Consumer1' binding 'CustomPortType_EP' property 'HttpOutboundConnectionConfig' for component 'rootComposite'.

Issue 2 - Node creation script fails when Custom RIs that are defined at amx.bpm.app scope which uses a custom SVAR defined at the node scope

Custom RIs, which are defined at the scope amx.bpm.app, are installed on the new node. However, the custom SVAR is not automatically created on the new node. This causes the creation of the new node to fail.

Symptoms - 

- Creation of the new node fails with the error - 

TIBCO-AMX-CLI-000020: Error invoking bulk action deploy on Application: TIBCO-AMX-ADMIN-012354: Failed to install the resource instance for application Some substitution variables are unresolved.

Note: The term Custom RI/Custom SVARs, listed in this article mean, are those that are created for the sole purpose of deploying the custom BPM applications. These are not available on the system after the amx.bpm.app is configured.

Creation of additional BPM Nodes on an existing system fail when BPM applications have custom requirements

All Supported Operating Systems

Prior to creating additional nodes, TIBCO recommends the following steps - 

a. Change all custom RIs, which are created for the custom BPM apps, to the amx.bpm.app scope

b. Delete the custom SVAR defined at the node. Evaluate if the custom SVARs at the node scope can be re-created at any other scope. Re-configure all custom RIs / custom apps (as needed) to cope with the change in SVAR.