Description:
While upgrading a distributed BPM environment from v2.1 to v3.1, the upgrade BPM fails with a NullPointerException. This only occurs on Windows platform.

Symptoms:
The following error is seen in the TCT logs (located at CONFIG_HOME/tct/bpmupgrade/<timestamp>/logs).

[propertyfile] Creating new property file: Y:\deployment\remote_props.properties
     [echo]
     [echo] =================================================================
     [echo] Task:   Uninstall Resource Instances on all AMX BPM Nodes
     [echo] =================================================================
     [echo]
01 Apr 2015 12:14:34  INFO - Initializing JSSE's crypto provider class com.sun.net.ssl.internal.ssl.Provider in default mode

BUILD FAILED
C:\tibco\bpm_config_home\tibco\data\tct\bpmupgrade\2015-04-01-12-11-28\scripts\build.xml:48: The following error occurred while executing this line:
C:\tibco\bpm_config_home\tibco\data\tct\bpmupgrade\2015-04-01-12-11-28\scripts\build.xml:14: The following error occurred while executing this line:
C:\tibco\bpm_home\bpm\3.1\scripts\upgrade\build.xml:628: The following error occurred while executing this line:
C:\tibco\bpm_home\bpm\3.1\scripts\instance-mgmt.xml:740: The following error occurred while executing this line:
C:\tibco\bpm_home\bpm\3.1\scripts\instance-mgmt.xml:586: The following error occurred while executing this line:
C:\tibco\bpm_home\bpm\3.1\scripts\instance-mgmt.xml:563: The following error occurred while executing this line:
C:\tibco\bpm_home\bpm\3.1\scripts\deployer\upgrades\upgrade.xml:160: The following error occurred while executing this line:
C:\tibco\bpm_home\bpm\3.1\scripts\deployer\upgrades\upgrade.xml:52: The following error occurred while executing this line:
C:\tibco\bpm_home\bpm\3.1\scripts\deployer\upgrades\upgrade_1.6.0_build.xml:42: The following error occurred while executing this line:
C:\tibco\bpm_home\bpm\3.1\scripts\deployer\amx-admin-macros.xml:390: java.lang.NullPointerException
    at com.tibco.n2.common.installer.ant.AmxBpmPerNodeAdminTask.execute(AmxBpmPerNodeAdminTask.java:131)
    at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:291)
    at sun.reflect.GeneratedMethodAccessor22.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
    at java.lang.reflect.Method.invoke(Unknown Source)
    at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:106)
    at org.apache.tools.ant.Task.perform(Task.java:348)
    at org.apache.tools.ant.taskdefs.Sequential.execute(Sequential.java:68)
    at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:291)
    at sun.reflect.GeneratedMethodAccessor22.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
    at java.lang.reflect.Method.invoke(Unknown Source)

Cause:
BPM Upgrade fails when upgrading from pre-2.2 to v2.2 or higher, when the BPM shared folder has been directly mounted as a network drive. For e.g. Y:\.

This defect has been reported to Engineering. Contact TIBCO to get the latest status of this defect.

Workaround - Reconfigure the BPM Shared folder to include an additional directory, prior to running the BPM upgrade. For example, Y:\bpm_share instead of Y:\. Use the following to reconfigure a BPM shared folder.

 

1). Stop amx.bpm.app .
2). Create a new directory on the shared folder.
3). Copy all contents from the existing BPM shared folder to the new directory.
4). Change the property - n2.config.location to include the new directory - In AMX Administrator > Infrastructure > BPMNode > Configuration > JVM Configuration
5). Repeat for each BPMNode.
6). Ensure all BPMNodes are In Sync and start amx.bpm.app .

TIBCO ActiveMatrix BPM Upgrade in a distributed BPM environment fails with a NullPointerException.