Contact Manager II on Tomcat 5.5

This article explains how to install Contact Manager II sample, bundled in Flex Data Services 2.0 beta2, on Tomcat 5.5.19 with jotm 2.0 (Transaction Manager).

Contact Manager II sample requires a transaction manager to use two-phase commit capability, but Tomcat of course doesn't have its own transaction manager so we need to install one.

Since jotm (transaction manager) is introduced in "Additional configuration for Tomcat" in Flex:Install Instructions at Adobe labs, I will use it, but unfortunately the oreilly's article, which is really old (2003/07/30), didn't work for me.
Fortunately, I've found a good article to install jotm on Tomcat.
(NOTE: although the article says JOTM doesn't seem to work with JDK 5, it's working on my tomcat using jdk1.5.0_06. Probably, Contact Manager II sample is not using the feature having a bug.)

In this page, I will explain how to setup jotm 2.0 on Tomcat 5.5.19 as described in the article above. Once jotm 2.0 is successfully installed, you can play with Contact Manager II.

If you haven't installed Flex Data Services 2.0 Beta2 and Tomcat 5.5.19, please consult Flex JMS Chat on Tomcat 5.5 to install them first.

We need the following jotm library.

• jotm 2.0.10
  
  • Get jotm-2.0.10.tgz from forge.objectweb.org, and unpack it.
    Assume the extracted directory is C:\jotm-2.0.10
    
    

Copy all jar files in C:\jotm-2.0.10\lib to C:\apache-tomcat-5.5.16\webapps\samples\WEB-INF\lib.
( commons-logging.jar will be overwritten but it's fine. )

And please download the following files as well.

• carol.properties
  
  • Save it in the samples webapp's classes directory. (C:\apache-tomcat-5.5.16\webapps\samples\WEB-INF\classes)
    
    
• context.xml
  
  • Save it in the samples webapp's META-INF directory. (C:\apache-tomcat-5.5.16\webapps\samples\META-INF)
    
    

That's it !

Now you can start Tomcat, open multiple browsers and access http://localhost:8080/samples/dataservice/contact/contactmgr.mxml