What is the JTSA? 

The JTSA is a small web app which shows the nGenera Reference Architecture Toolkit for Java in action. It contains a sample service and a few sample transforms that should help a first-time toolkit developer get started. We'll add examples to it as time goes on.

Downloading the source code for the JTSA

The JTSA is comingled with the JT codebase: 

svn co svn://72.249.82.8/bsgra_java_toolkit/trunk

Deploying JTSA for the first time

Check out the latest application:

cd /usr/local

svn co svn://72.249.82.8/bsgra_java_toolkit/trunk/deploy

If you don't have Tomcat installed, then run the following commands:

tar zxvf deploy/apache-tomcat-5.5.25.tar.gz

mv apache-tomcat-5.5.25 tomcat

mv tomcat/common/endorsed/xml-apis.jar tomcat/common/endorsed/xml-apis.jar.bak

rm -Rf tomcat/webapps/ROOT

Deploy the application:

cp deploy/bsgra_java_sample.war tomcat/webapps/ROOT.war

Clean up after ourselves:

rm -Rf deploy

Restart Tomcat:

/etc/init.d/tomcat start

Assuming that monit is configured: 

monit start tomcat

 

Updating JTSA

To update to a more recent version of the JTSA, follow these instructions:

Stop tomcat. I use both monit and the init.d script to stop tomcat because I like the feedback I get from the script, but I need to be sure that monit doesn't restart tomcat halfway through my deployment:

monit stop tomcat

/etc/init.d/tomcat stop

Change directories to the parent of TOMCAT_HOME:

cd /usr/local/

Check out the latest application:

svn co svn://72.249.82.8/bsgra_java_toolkit/trunk/deploy

Remove the existing application from Tomcat:

rm -f tomcat/webapps/javatoolkit/ROOT.war
rm -Rf tomcat/webapps/javatoolkit/ROOT

Deploy the new WAR:

cp deploy/bsgra_java_sample.war tomcat/webapps/javatoolkit/ROOT.war

Restart Tomcat:

/etc/init.d/tomcat start

monit start tomcat

Clean up after ourselves:

rm -Rf deploy