Understanding the CLI action copyPFUComponents

The various entities used as part of the CLI action copyPFUComponents are:

  1. Source Node: this is the existing TIBCO ActiveMatrix BPM Node that contains the PFU Components. The PFU Components should be copied from the Source Node.
  2. Target Node: this is the newly created TIBCO ActiveMatrix BPM Node on which all the existing BPM user applications exists, except for their PFU Components. The PFU Components should be copied to the Target Node.
  3. AMX Environment: this is the name of TIBCO ActiveMatrix Environment where both the Source Node and Target Node belongs to. Both the BPM Nodes must belong to same AMX Environment.
Note: The processes that are involved in the copyPFUComponents action are the TIBCO ActiveMatrix Administrator (System Node), and the two TIBCO Hosts that are managing the Source and Target Nodes. The processes of the Nodes do not participate in this process.
Note: It is the BPM user's responsibility to ensure that the Source Node and the Target Node must be of the same BPM Node type in terms of 'Full BPM Node' vs. 'Logical BPM Node'.
Note: The BPM user must be aware that both Source Node and Target Node are restarted as part of the ' copyPFUComponents ' action, which impacts other applications running on the Nodes. A dry run mode has been provided for the BPM user to assess the impact of the ' copyPFUComponents ' action without altering the state of the system that is Source Node and Target Nodes are not restarted in the dry run mode. For more details, see, Running the CLI action copyPFUComponents.

The user running this CLI action must be a super user. Here is a high-level summary of the steps carried out by the TIBCO ActiveMatrix Administrator layer as part of the copyPFUComponents Action:

  1. Stop the Source Node.
  2. Start the Target Node.
  3. Connect to the TIBCO Host that is managing the Source Node. Export (as a .zip file) all the PFU Components from the Source Node that should be copied to the Target Node.
  4. Enable the necessary BPM Features on the Target Node required to execute the PFU Components.
  5. Stop the Target Node.
  6. Connect to the TIBCO Host that is managing the Target Node, provide the .zip file (created in step 3) and import all the PFU Components to the Target Node.
  7. After successful import, restart both Source Node and Target Node