Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

How to use BTM as the transaction manager in Tomcat 5.5.x

These instructions have been verified against BTM 1.1.

titleThis is for BTM 1.2 and earlier

These instructions are for BTM 1.2 and earlier only. BTM 1.3 instructions are here.


Table of Contents

Step 1: Copy the BTM jars

Copy the following jars from the BTM distribution to the Tomcat common/lib/ directory:

  • btm-1.1.jar
  • geronimo-spec-jta-1.0.1B-rc4.jar
  • slf4j-jdk14.jar (or any other one available here)

Step 2: Configure BTM as the transaction manager

Windows: Create a file named setenv.bat with the following commands under Tomcat's bin/ directory:


Finally, create an empty file named under Tomcat's conf/ directory.

Step 3: Configure datasources that are transaction aware

You have to put your datasources configurations in Tomcat's conf/ file. Here's an example of using BTM with a DataSource that implements javax.sql.XADataSource:


Again, we've used Derby as an example, but as the LrcXADataSource uses only the class name and url of a java.sql.Driver, you can use it with any database providing a JDBC driver.

Step 4: Configure transaction manager and datasources initialization in your META-INF/context.xml

In the web application where you want one or more datasource to be used, you have to create a META-INF/context.xml file.


The <Transaction> tag will just bind the transaction manager at the standard JNDI location java:comp/UserTransaction.

Step 5: Configure datasources references in your web.xml

Before your code can access configured datasources via JNDI ENC URLs, you need to declare resource references in your web.xml: