home > Dependencies > Tomcat Install

Tomcat download and install

Go to the Apache Tomcat download site and download the core distribution that matches your hosting environment. Extract the tar or zip file into the directory from which you want to run the Tomcat server. Set the evironment variable CATALINA_HOME to the extracted directory.
e.g. if you untarred apache-tomcat-5.5.26.tar in /usr/local, CATALINA_HOME should be set to /usr/local/apache-tomcat-5.5.26.

Tomcat Configuration

Complete Tomcat documentation can be found at Tomcat 5-5 doc. The things you may need to do for OSCARS are itemized below.

$CATALINA_HOME/conf

$CATALINA_HOME/common

Classes and libraries shared by the Tomcat server and all the webapps.  We added common/classes/log4j.properties and common/lib/log4j.jar and commons-logging.jar in order to get Tomcat to do log4j logging. By default it just uses commons logging.

$CATALINA_HOME/shared

Contains classes and libraries shared by all the webapps but not the Tomcat server. This has been where we have put files that can't seem to be found from the axis2.war or the OSCARS.aar. The ant task setupServer will populate the classes directory and deploylibs will polulate the lib directory. Currently the contents are:

 $CATALINA_HOME/webapps

Contains all the user provided war files. In our case this is OSCARS.war and axis2.war. When a war file is put in this directory it will be automatically deployed by the Tomcat server and its contents will be extracted into a directory with the name of the war.
Every Tomcat webapp has a WEB-INF/web.xml that defines the service name and methods.

$CATALINA_HOME/bin - startup scripts