Virtual Tomcat 0.1 review

Virtual Tomcat project is a set of scripts designed to ease administration tasks involved with hosting multiple JVM instances and dom

License: BSD License File size: 0K Developer: Derek Baillie

0

Virtual Tomcat project is a set of scripts designed to ease administration tasks involved with hosting multiple JVM instances and domains using Apache Tomcat and HTTPd.

The system (which uses jsvc to spawn instances) allows users to deploy their own applets from within their home directories, as well as allowing full access to /manager and /admin applets.

Requirements:
Tomcat 5.5(.16) is installed.
A symlink to $CATALINA_HOME exists as /usr/local/tomcat
Apache is already configured with mod_jk and uses workers.properties in the same directory as httpd.conf
Tomcat's jsvc has been compiled and placed in $CATALINA_HOME/bin

Installation and Usage:

1. Create a symlink to your Tomcat installation (ln -s /usr/local/apache-tomcat-5.5.16 /usr/local/tomcat)

2. Create a directory named 'users' in /usr/local/tomcat (mkdir /usr/local/tomcat/users)

3. Edit the TCDIR, ACONFDIR & APACHECONF variables to reflect your configuration.

4. Make sure Apache is setup for use with Virtual Hosts and mod_jk:

Example mod_jk configuration:

#------------------------------------------------------------------------
JkWorkersFile /etc/httpd/conf/workers.properties
JkLogFile /etc/httpd/logs/mod_jk.log
JkLogLevel warn
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
JkRequestLogFormat "%w %V %T"
#------------------------------------------------------------------------

5. Setup workers.properties:

Here is an example workers.properties file:

#--------------------------------------------------------------------------
workers.tomcat_home=/usr/local/tomcat
workers.java_home=/usr/local/j2sdk1.4.2_11
ps=/
worker.list=ajp13, example1, jbloggs #
/server ->
/classes
/lib
/shared ->
/classes
/lib
/temp
/work ->
/Catalina
/conf ->
/Catalina

For your reference, the username, vhost and port of the new user
will be stored in /etc/tomcatports.

* starttomcat

SYNTAX
starttomcat {username}

DESCRIPTION

This script will attempt to initialise the specified user's
Tomcat instance, using jsvc.

* stoptomcat

SYNTAX
stoptomcat {username}

DESCRIPTION

This script will stop the specified user's Tomcat instance if a
pid file is found at /usr/local/tomcat/users/{username}/jsvc.pid