JAX-RPC 2.0 EA on Tomcat 5.x - Install instructions

JAX-RPC 2.0 EA was released few days ago and was supported only on Sun Java System App Server 8.1 container. I posted instructions on how to install JAX-RPC 2.0 EA over JWSDP 1.5. This blog tells you how to install JAX-RPC 2.0 EA over a standalone Tomcat 5.x. I tested these instructions with Tomcat 5.5.9.

Lets say JAX-RPC 2.0 EA bundle is installed in JAXRPC_HOME directory, Ant is installed in ANT_HOME directory, and Tomcat is installed in TOMCAT_HOME directory.

Make sure TOMCAT_HOME environment variable is set to your Tomcat installation directory. Here are the steps involved to install JAX-RPC 2.0 on Tomcat 5.5.x:

1. Download this script in JAXRPC_HOME.
2. Go to JAXRPC_HOME directory and invoke

   ANT_HOME/bin/ant -f istackontomcat.xml install

That is all it takes to install JAX-RPC 2.0 EA over a standalone Tomcat container.

Now that the Tomcat container is all ready to roar with JAX-RPC 2.0 binaries, there is a slight tweak required to run the samples bundled along with JAX-RPC 2.0 EA distribution. You need to change the deploy target in JAXRPC_HOME/samples/etc/common-targets.xml so that the created WAR file is now deployed to the Tomcat container instead of the Application Server. Just change the target to:

<target name="deploy">
	<!-- copy file="${build.war.home}/jaxrpc-${ant.project.name}.war"
           todir="${as.home}/domains/${domain}/autodeploy"/ -->
	<copy file="${build.war.home}/jaxrpc-${ant.project.name}.war"
           todir="${env.TOMCAT_HOME}/webapps"/>
</target>

Start the Tomcat container by invoking TOMCAT_HOME/bin/startup.[sh or bat], and follow the rest of instructions from the samples documentation. All your samples can now be deployed on Tomcat container, in addition to Sun's Application Server.

In order to run them on Application Server again, you need to revert the change made above in the deploy target. Hope you find this useful.