Resolution:
Description:
= = = = = = =
BusinessConnect (BC) 5.3.x will fail to start unable to acquire a lock.

Environment:
= = = = = = =
This applies to all environments.


Symptoms:
= = = = = =
The BusinessConnect log will show exceptions such as the following:

java.lang.reflect.InvocationTargetException
        at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
        at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:39)
        at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:27)
        at java.lang.reflect.Constructor.newInstance(Constructor.java:494)
        at com.tibco.ax.fw.db.DbAccessFactory.a(DbAccessFactory.java:629)
        at com.tibco.ax.fw.db.DbAccessFactory.getDbAccessHandle(DbAccessFactory.java:205)
        at com.tibco.ax.fw.db.DbAccessFactory.getDbAccessHandle(DbAccessFactory.java:185)
        at com.tibco.ax.fw.runtime.impl.RuntimeBootstrap.initDBLock(RuntimeBootstrap.java:789)
        at com.tibco.ax.fw.runtime.impl.RuntimeBootstrap.sInit(RuntimeBootstrap.java:371)
        at com.tibco.plugin.gateway.GatewayBootstrap.init(GatewayBootstrap.java:38)
        at com.tibco.plugin.gateway.GatewayBootstrap.&ltinit>(GatewayBootstrap.java:32)
        at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
        at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:39)
        at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:27)
        at java.lang.reflect.Constructor.newInstance(Constructor.java:494)
        at com.tibco.plugin.java.JavaGlobalServiceAgent.for(JavaGlobalServiceAgent.java:94)
        at com.tibco.plugin.java.JavaGlobalServiceAgent.init(JavaGlobalServiceAgent.java:272)
        at com.tibco.pe.core.AgentJobCreator.init(AgentJobCreator.java:86)
        at com.tibco.pe.core.JobPoolConfigurator.if(JobPoolConfigurator.java:436)
        at com.tibco.pe.core.JobPoolConfigurator.a(JobPoolConfigurator.java:190)
        at com.tibco.pe.core.JobPoolConfigurator.do(JobPoolConfigurator.java:100)
        at com.tibco.pe.core.JobPool.&ltinit>(JobPool.java:313)
        at com.tibco.pe.core.JobPoolCreator.init(JobPoolCreator.java:81)
        at com.tibco.pe.core.JobPoolCreator.&ltinit>(JobPoolCreator.java:73)
        at com.tibco.pe.PEMain.do(PEMain.java:386)
        at com.tibco.pe.PEMain.a(PEMain.java:197)
        at com.tibco.pe.PEMain.&ltinit>(PEMain.java:184)
        at com.tibco.pe.PEMain.main(PEMain.java:122)
Caused by: Lock creation failed for't3Vkuwmds3gMtB2ubxpfGAuW73Y='
        at com.tibco.ax.fw.util.flock.FLock.a(FLock.java:173)
        at com.tibco.ax.fw.util.flock.FLock.a(FLock.java:119)
        at com.tibco.ax.fw.util.flock.FLock.for(FLock.java:208)
        at com.tibco.ax.fw.util.flock.FLock.&ltinit>(FLock.java:42)
        at com.tibco.ax.fw.util.flock.FLockFactory.getInstance(FLockFactory.java:47)
        at com.tibco.ax.fw.util.flock.FLockFactory.getInstance(FLockFactory.java:31)
        at com.tibco.ax.fw.util.DBLock.&ltinit>(DBLock.java:110)
        ... 28 more
2011 Apr 04 09:46:51:696 GMT +2 BW.BusinessConnect-Interior_Server-2 Debug [bw.logger] BW-EXT-LOG-300002  Exception occured during runtime initialization: Error during registering access to DBLock resources.: Error creating db handle.

2011 Apr 04 09:46:51:698 GMT +2 BW.BusinessConnect-Interior_Server-2 Error [bw.logger] BW-EXT-LOG-100000  Error during registering access to DBLock resources.: Error creating db handle.

Cause:
= = = =
BusinessConnect server is not able to obtain a lock on &ltBC-Shared> directory..

Resolution:
= = = = = =
The shared directory (or &ltBC-Shared>//flock) should have enough permissions so BC user can fetch a lock.