JServ module

Java Servlet Support

Overview
The JServ module interfaces Zeus with the Apache JServ Servlet Server. JServ is 'Open Source' Servlet engine that is freely downloadable.

For more information look at:

Configuration
Zeus is configured to access a JServ servlet engine by specifying a 'mount point', under which any accesses are sent to the JServ engine. The JServ process can run on the same machine as the webserver, or on a remote machine, or multiple remote machines to provide load-balancing and fault tolerance.

A single mount point requires three pieces of information. The hostname of the machine running the JServ program, ('localhost' if you are running it locally), the port number the JServ program is bound to (JServ defaults to 8007), and the JServ 'zone' to use. For more information on zones, check the JServ documentation. Basically each zone has its own 'CLASSPATH' to determine where Java classes should be found, and also allows for automatic reloading of classes upon servlet recomplilation.

Usage
Once a mount point is setup, servlets are accessed via '<mountpoint>/<servletname>', e.g. http:://www.mysite.com/jserv/HelloWorld.

Servlets that are in 'subdirectories', can be accessed by putting a '.' between directories, e.g. /jserv/org.mysite.HelloWorld.

JServ itself provides a default servlet that generates information about itself, this can be accessed via a servlet called 'org.apache.jserv.JServ'. Thus if you mounted JServ on '/jserv', you can access this servlet via http://www.mysite.com/jserv/org.apache.jserv.JServ

Protocol
Zeus currently uses the AJPv1.1 protocol to communicate with the JServ servlet engine. Zeus doesn't currently support AJPv1.1 authentication. In the jserv.properties file, authentication should be disabled by adding the line security.authentication=false.