Resolution:
Description:
==========
Error in sw_warn reads:
2010/05/26 12:07:57.789476(RPCBG:1:13424:2::::pro:/proeai.c:80293:2531): 1867-'EAIJAVA' EAI Run-Time Plug-In failed to initialize, error EAI_JAVA: EAIRun_Init()
- Initialise method failed in Loader!


Environment:
==========
TIBCO iProcess Engine (iPE) 11.0.1 SPARC Solaris Oracle 10g
TIBCO iProcess Technology Plug-in


Symptoms:
=========
iPE background process are suspended upon start up.


Cause:
======
A sw_warn entry indicates that a JVM is created, however the plug-in failed to load.

The error in the eaijava logs reads:

2010-05-26 13:49:51,940 [ERROR] SWDBPool - Failed to load driver

java.lang.ClassNotFoundException: $DRIVERNAME$
    at java.net.URLClassLoader$1.run(Unknown Source)
    at java.security.AccessController.doPrivileged(Native Method)
    at java.net.URLClassLoader.findClass(Unknown Source)
    at java.lang.ClassLoader.loadClass(Unknown Source)
    at java.lang.ClassLoader.loadClass(Unknown Source)
    at com.staffware.eaijava.bootstrap.library.SWSelectiveDelegatingClassLoader.loadClass(SWSelectiveDelegatingClassLoader.java:58)
    at java.lang.ClassLoader.loadClassInternal(Unknown Source)
    at java.lang.Class.forName0(Native Method)
    at java.lang.Class.forName(Unknown Source)
    at com.staffware.integration.dbpooling.library.SWDBPool.start(SWDBPool.java:274)
    at com.staffware.integration.dbpooling.library.mbean.DBPoolMBean.start(DBPoolMBean.java:51)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
    at java.lang.reflect.Method.invoke(Unknown Source)
    at mx4j.AbstractDynamicMBean.invokeMethod(AbstractDynamicMBean.java:395)
    at mx4j.AbstractDynamicMBean.invoke(AbstractDynamicMBean.java:351)
    at mx4j.AbstractDynamicMBean.invoke(AbstractDynamicMBean.java:229)
    at com.sun.jmx.mbeanserver.DynamicMetaDataImpl.invoke(Unknown Source)
    at com.sun.jmx.mbeanserver.MetaDataImpl.invoke(Unknown Source)
    at com.sun.jmx.interceptor.DefaultMBeanServerInterceptor.invoke(Unknown Source)
    at com.sun.jmx.mbeanserver.JmxMBeanServer.invoke(Unknown Source)
    at mx4j.tools.config.DefaultConfigurationBuilder$Call.configure(DefaultConfigurationBuilder.java:640)
    at mx4j.tools.config.DefaultConfigurationBuilder$Startup.configure(DefaultConfigurationBuilder.java:296)
    at mx4j.tools.config.DefaultConfigurationBuilder$Configuration.startup(DefaultConfigurationBuilder.java:170)
    at mx4j.tools.config.DefaultConfigurationBuilder$Configuration.configure(DefaultConfigurationBuilder.java:153)
    at mx4j.tools.config.ConfigurationLoader.startup(ConfigurationLoader.java:93)
    at com.staffware.eaicommon.runtime.library.jmx.SWJMXUtils.loadConfiguration(SWJMXUtils.java:465)
    at com.staffware.eaicommon.runtime.library.jmx.SWJMXUtils.initialise(SWJMXUtils.java:321)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
    at java.lang.reflect.Method.invoke(Unknown Source)
    at com.staffware.eaijava.bootstrap.library.SWEAIJavaClassLoader.initialiseJMX(SWEAIJavaClassLoader.java:443)
    at com.staffware.eaijava.bootstrap.library.SWEAIJavaClassLoader.initialize(SWEAIJavaClassLoader.java:339)


The error relates to the TIBCO iProcess BusinessWorks Server Plug-in and the configuration file $SWDIR/eaijava/jmx/config.xml .The TIBCO iProcess Technology Plug-in installer failed to substitute tokens for actual values causing the iPE Background processes to be unable to initialize the plug-in resulting in their suspension.

Resolution:
==========
Three tokens still remained in the config.xml file - these values must be amended with the correct values for the iPE environment. The tokens were in relation to the database configuration for the TIBCO iProcess BusinessWorks Server Plug-in. Edit the file $SWDIR/eaijava/jmx/config.xml and make the following modifications:

Substitute the token $DRIVENAME$ with -  oracle.jdbc.driver.OracleDriver
Substitute the token $HEARTBEAT$ with - Select count(*) from Nodes
Substitute the token $DBTYPE$     with -  Oracle

Restart iPE after making the above changes.