Resolution:

Description:

========

How to configure XA Arjuna/JBOSS transaction manager with BW.

Resolution:

=======

JBOSS transaction manager can be downloaded from link http://www.jboss.org/jbosstm. Tested with jbossts-full-4.2GA, downloaded from http://www.jboss.org/jbosstm/downloads/4-2

Follow the steps below to configure JBOSS transaction manager.

1). Unzip jbossts-full-4.2GA.zip into an external directory.

2). Open the ATS properties file (<ATS_HOME> \etc\arjunajts-properties.xml) and make sure that the properties com.arjuna.ats.jta.jtaTMImplementation and com.arjuna.ats.jta.jtaUTImplementation are set to the following values:

<property name="com.arjuna.ats.jta.jtaTMImplementation" value="com.arjuna.ats.internal.jta.transaction.arjunacore.TransactionManagerImple"/>
<property name="com.arjuna.ats.jta.jtaUTImplementation" value="com.arjuna.ats.internal.jta.transaction.arjunacore.UserTransactionImple"/>

3). ATS provides two recovery modules for XA resources. One for local transaction recovery and one for distributed transaction recovery. In TIBCO ActiveMatrix BusinessWorks, local transaction recovery is used. By default, the ATS properties file may be configured to enable both the local transaction recovery (<property name="com.arjuna.ats.arjuna.recovery.recoveryExtension5" 

value="com.arjuna.ats.internal.jta.recovery.arjunacore.XARecoveryModule"/>) and distributed transaction recovery (<property name="com.arjuna.ats.arjuna.recovery.recoveryExtension6" value="com.arjuna.ats.internal.jta.recovery.jts.XARecoveryModule"/>).TIBCO ActiveMatrix BusinessWorks uses the local transaction recovery, therefore the distributed transaction recovery property must be commented out or removed from the ATS properties file.

4). By default, object store is created in current directory. To change the object store's location, set the value for the following property in the ATS properties file to your directory’s location: <property name="com.arjuna.ats.arjuna.objectstore.objectStoreDir" value="your directory location" />

5). The classpath for TIBCO Designer and TIBCO ActiveMatrix BusinessWorks must be modified to include the ATS property file and JAR files. To accomplish this, the following directories must be included in classpath properties in the designer.tra and bwengine.tra files:

<ATS_HOME>\etc
<ATS_HOME>\lib
<ATS_HOME>\lib\ext

6). It is observed that the following exception is encountered while starting Designer in debug mode in BW 5.9 or higher. If this is the case remove xercesImpl.jar from ATS_HOME\lib\ext folder else the Designer Tester will not work.

Trampoline error: com.tibco.ae.tools.palettes.processpalette.debug.DebugHandler@166fad9 reallyStart
java.lang.reflect.InvocationTargetException
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
    at java.lang.reflect.Method.invoke(Method.java:597)
    at com.tibco.util.Trampoline.invoke(Trampoline.java:136)
    at com.tibco.ui.BusyWait.run(BusyWait.java:428)
    at java.lang.Thread.run(Thread.java:662)
Caused by: javax.xml.parsers.FactoryConfigurationError: org.xml.sax.SAXNotRecognizedException: http://javax.xml.XMLConstants/feature/secure-processing
    at com.tibco.xml.parsers.xmlfactories.SAXParserFactory.<init>(SAXParserFactory.java:62)

7). For more details, refer to XATransaction section of Chapter11->Transactions in tib_bw_process_design.pdf .

How to configure XA Arjuna/JBOSS transaction manager with BW.