amx.bpm.app fails to start, with the component Openspace/gadgetserver in Start Failed state. Runtime state of application components/bindings can be seen from TIBCO ActiveMatrix Administrator by clicking the "Start Failed" in the Application State column.

The BPM node log shows the following error :

.. [ERROR] [amx.bpm.app] com.tibco.amx.cf.logger.lifecycle - "TIBCO-AMX-CF-000022: Error stopping ApplicationName=amx.bpm.app ComponentName=Openspace/gadgetserver Version=1.3.0.001 ComponentURI=urn:amx:BPMEnvironment/amx.bpm.app/Openspace/gadgetserver_1.3.0.001. Component caused by: Exception occurred during webApp un-deployment of component 'Openspace/gadgetserver'" (ActionID="[amxbpmadmin:Component-Start:57399]")
java.lang.IllegalArgumentException: Exception occurred during webApp un-deployment of component 'Openspace/gadgetserver'
    at com.tibco.amf.runtime.implementationtype.webapp.WebAppImplementationAdapter.destroyImplementation(WebAppImplementationAdapter.java:313)
.....
Caused by: java.lang.Exception: Could not create cache directory "/jsecurity-ehcache/ehcache_auto_created_1462385941124".
    at net.sf.ehcache.store.DiskStore.initialiseFiles(DiskStore.java:189)
    at net.sf.ehcache.store.DiskStore.<init>(DiskStore.java:164)
    ... 47 more


Cause:
Openspace gadget server creates a temporary directory named as /jsecurity-ehcache/ehcache_auto_created_<unique number> in the Java Virtual Machine's (JVM) temporary location. This error indicates the JVM temporary location is being detected as "/".

The default temporary-file directory is specified by the system property java.io.tmpdir. On UNIX, the default value of this property is typically "/tmp" or "/var/tmp". On Microsoft Windows, it is in the user's temp location (echo %TEMP%). The out of the box BPM node does not have the JVM property java.io.tmpdir explicitly set. It defaults as per the operating system (OS).

The problem here is that the BPM node's OS user does not have permissions to create a directory in the JVM's temporary location.

amx.bpm.app fails to start due to Openspace gadgetserver component

OS: All Supported Operating Systems

Check the JVM arguments using TIBCO ActiveMatrix (AMX) Administrator - Infrastructure > Nodes > BPM Node > (bottom-panel) Configuration > JVM Configuration. Check if it has a -Djava.io.tmpdir property set. The BPM node's OS user might not have permissions to write into this directory. Check with your system administrator if these permissions can be granted.

If not, follow these steps to change the temporary location -

1. Change the JVM argument (using AMX Administrator - Infrastructure > Nodes > BPM Node > (bottom-panel) Configuration > JVM Configuration) "-Djava.io.tmpdir" to a path for which the BPM node OS user has permission to write. Alternatively remove the property completely, so that it can take the default value. Repeat for each BPM Node. 

2. Save the changes and stop the BPM node(s) using AMX Administrator (Infrastructure > Nodes > BPM Node). Wait for the nodes to stop.

3. From the command line start each of the BPM nodes as :

./tibcohost startNodes -nodeName BPMNode -clean

4. Check amx.bpm.app status