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

These instructions have been verified against BTM 1.0.

Contents

Step 1: Copy the BTM jars

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

• btm-1.0.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:

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

Now create a file named btm-config.properties with the following properties under Tomcat's conf/ directory:

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

Step 3: Configure DataSources that are transaction aware

Step 4: Configure datasources references in your web.xml