Apache 2 with Tomcat 6

How To Configure Tomcat to work with Apache

How to Connect Tomcat 6 to Apache HTTP Server 2

Tomcat can be run as a standalone server. Tomcat can also be run as an add-on to the Apache HTTP Server (or Microsoft IIS) - as the Java servlet/JSP container. In this combination, Tomcat executes the Java servlets and JSPs, the Apache serves the static HTML pages and performs other server-side functions such as CGI, PHP, SSI, etc. Read "Why should I integrate Apache with Tomcat? (or not)" at Tomcat FAQ (http://wiki.apache.org/tomcat/FAQ/Connectors#Q3).

To configure Tomcat to work with Apache HTTP Server, you should first read the documentation provided in Tomcat thoroughly, and read the "Tomcat Connector" documents @ http://tomcat.apache.org/connectors-doc.

To run Tomcat together with Apache:

There are a few adapter modules available, such as Apache JServ Protocol (AJP) v1.2 "JServ" module (outdated), AJP v1.3 "JK 1.2" module (in use) and "JK 2" module (deprecated). I will only describe the JK1.2 module with Apache 2 here.

The step-by-step procedure is as follow:

Step 0.1: Install Apache HTTP Server - Refer to "Apache HTTP Server - How To". I shall assume that Apache is installed in directory "d:\myproject\apache", and runs on port 7000. I shall denote the apache installed directory as $APACHE_HOME.

Step 0.2: Install Tomcat - Refer to "Tomcat - How To". I shall assume that Tomcat is installed in directory "d:\myproject\tomcat", runs on port 8080. Tomcat's shall contains two web contexts: "/examples" (Tomcat's servlets and JSP examples) and "/ws" (to be created by you). I shall denote Tomcat's installed directory as $CATALINA_HOME (Catalina is the code name for Tomcat 5 and above).

Step 1: Download the Apache-Tomcat Connector Module - An Apache-Tomcat connector - JK1.2 module - which is an adapter module used by Apache to communicate with Tomcat (using AJP v1.3 protocol through TCP port 8009), can be downloaded from Tomcat mother site @ tomcat.apache.org (⇒ Download ⇒ Tomcat Connectors ⇒ JK 1.2 ⇒ JK 1.2 Binary Releases ⇒ win32 ⇒ jk-1.2.xx ⇒ "mod_jk-1.2.xx-httpd-2.2.x.so").

Rename the downloaded module to "mod_jk.so" and move into directory "d:\myproject\apache\modules".

Step 2: Configure Apache - We need to configure the Apache HTTP Server to load and initialize the JK module.

Create a configuration file called "mod_jk.conf" as follows and place it in "d:\myproject\tomcat\conf":

# Load mod_jk module
# Update this path to match your modules location
LoadModule jk_module modules/mod_jk.so

# Where to find workers.properties
# Update this path to match your conf directory location
JkWorkersFile d:/myproject/tomcat/conf/workers.properties

# Where to put jk logs
# Update this path to match your logs directory location
JkLogFile d:/myproject/tomcat/logs/mod_jk.log

# Set the jk log level [debug/error/info]
JkLogLevel info

# Select the log format
JkLogStampFormat "[%a %b %d %H:%M:%S %Y]"

# JkOptions indicate to send SSL KEY SIZE,
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories

# JkRequestLogFormat set the request format
JkRequestLogFormat "%w %V %T"

# Send everything for context /ws to worker ajp13
JkMount /ws ajp13
JkMount /ws/* ajp13 

# Send everything for context /examples to worker ajp13
JkMount /examples ajp13
JkMount /examples/* ajp13

For each web context that is to be forwarded from Apache to Tomcat, include two JKMount statements as shown. In the above configuration, Apache forwards all requests to web contexts "/examples" and "/ws" to Tomcat, via a "worker" called "ajp13". (Check the URL of the Tomcat's servlet and JSP examples from the Tomcat's welcome page! It may move!)

Include the above configuration directives into the Apache's configuration by adding the following include statement at the end of "d:\myproject\apache\conf\httpd.conf":

include d:/myproject/tomcat/conf/mod_jk.conf

Note: Unix's forward slash is used as the directory separator instead of backward slash (because Apache was originally built for Unix). The include statement simply appends all the statements from the file "d:\myproject\tomcat\conf\mod_jk.conf" into "httpd.conf". (You can of course add those statements into "httpd.conf" directly.)

Next, observe that the configuration refers to a worker file called "workers.properties", and forward certain requests to a JK worker called "ajp13". Create the "workers.properties" file and place it in "d:\myproject\tomcat\conf" as follows:

# Define 1 real worker named ajp13
worker.list=ajp13

# Set properties for worker named ajp13 to use ajp13 protocol,
# and run on port 8009
worker.ajp13.type=ajp13
worker.ajp13.host=localhost
worker.ajp13.port=8009
worker.ajp13.lbfactor=50
worker.ajp13.cachesize=10
worker.ajp13.cache_timeout=600
worker.ajp13.socket_keepalive=1
worker.ajp13.socket_timeout=300

Note: The JKMount statements forward the requests to a worker called "ajp13", which is defined in this "workers.properties".

Step 3: Configure Tomcat - The default configuration in Tomcat's "conf\server.xml" starts the AJP1.3 service via the following configuration, on TCP port 8009 (remove the comments if these lines are commented out).

<!-- Define an AJP 1.3 Connector on port 8009 -->
<Connector port="8009" enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />

Step 4: Start the Apache with the JK module

D:\myproject\apache\bin> httpd -k install
D:\myproject\apache\bin> httpd -k start

Check the Apache's log "logs\errors.log" to confirm that JK module was started:

Starting the Apache2.2 service
The Apache2.2 service is running.
Apache/2.2.xx (Win32) mod_jk/1.2.xx configured -- resuming normal operations

Step 5: Start the Tomcat server

D:\myproject\tomcat\bin> startup

Observe that AJP1.3 service is initiated and the ajp13 worker is listening at port 8009.

....
Oct 1, xxxx 9:44:05 PM org.apache.jk.common.ChannelSocket init
INFO: JK: ajp13 listening on /0.0.0.0:8009
Oct 1, xxxx 9:44:05 PM org.apache.jk.server.JkMain start
INFO: Jk running ID=0 time=0/18  config=null
....

The order of starting up Tomcat and Apache is NOT important. Either apache or tomcat can be restarted at any time.

Step 6: Verify the Installation - Issue the following URLs to access the web contexts "/examples" and "/ws", that are defined in Tomcat (running in port 8080), but accessed via the Apache (running in port 7000).

http://hostname:7000/examples/servlets
http://hostname:7000/examples/jsp
http://hostname:7000/examples
http://hostname:8080/ws
http://hostname:7000/ws
Try Tomcat's servlet examples via Apache
Try Tomcat's JSP examples via Apache
Try Tomcat's examples via Apache
Access ws from Tomcat directly
Access ws via Apache

 

REFERENCES & RESOURCES

Latest version tested: Apache 2.2.16 / Tomcat 7.0.2 / JK 1.2.30
Last modified: October, 2010