Lucee Developer

After finding out how I could use mod_jk for my Apache and Tomcat install, I found out that using mod_proxy does almost the same (it also uses AJP13). This last one is much more easy to setup, but it is only available for Apache 2.2 and later.

So here you will find the instructions for setting up mod_jk, even though I would suggest to just use the mod_proxy code if you are on Apache 2.2. I also included that setup underneath.

Prerequisites

You need to know and change a few variables:

• {Apache-root}: this is the Apache install directory
• What files do you want to be served by Tomcat? In the code underneath, I assume cfm and cfc files, which are the extensions for Coldfusion / Railo.
• {Tomcat-root}: the Tomcat installation directory

Use mod_proxy if you have Apache 2.2 or later

In Apache's httpd.conf, you need to add the following:

# Tomcat for Railo configuration with proxy+ajp13:
<IfModule !proxy_module>
    LoadModule proxy_module {APACHE-ROOT}/modules/mod_proxy.so
</IfModule>
<IfModule !rewrite_module>
    LoadModule rewrite_module {APACHE-ROOT}/modules/mod_rewrite.so
</IfModule>
ProxyPreserveHost On
ProxyPassMatch ^/(.+\.cf[cm])$ ajp://localhost:8009/$1
ProxyPassMatch ^/(.+\.cf[cm])(/.*)$ ajp://localhost:8009/$1?path_info=$2
ProxyPassMatch ^/((flashservices/gateway|messagebroker/|flex2gateway/|openamf/gateway/).*) ajp://localhost:8009/$1

All Apache versions: Tomcat must be setup to handle AJP

The following xml must be available / has to be added in tomcat's /conf/server.xml:

<Server>
  [...]
  <Service name="Catalina">
    [...]
    <!-- Define an AJP 1.3 Connector on port 8009 -->
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

Connect Apache 2.0 with Tomcat by using mod_jk

For Apache 2.0, AJP is only available via mod_jk. It can be quite easily configured, although it is more work to do.

In Apache's httpd.conf, you need to add the following:

# Load mod_jk module, if not yet loaded
<IfModule !jk_module>
    LoadModule jk_module {APACHE-ROOT}/modjk/mod_jk.so
</IfModule>
# Where to find workers.properties
JkWorkersFile {APACHE-ROOT}/workers.properties
# Where to put jk shared memory
JkShmFile {APACHE-ROOT}/modjk/mod_jk.shm
# Where to put jk logs
JkLogFile {APACHE-ROOT}/modjk/mod_jk.log
# Set the jk log level [debug/error/info]
JkLogLevel    error
# Select the timestamp log format
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
# Send every request for .cfm and .cfc files to tomcat
JkMount /*.cfm worker1
JkMount /*.cfc worker1
# These SES links do not work on tomcat6 :-/
# JkMount /*.cfm/* worker1
# JkMount /*.cfc/* worker1
# Send every request for blazeDS to tomcat
JkMount /flashservices/gateway* worker1
JkMount /messagebroker* worker1
JkMount /flex2gateway* worker1
JkMount /openamf/gateway* worker1
## This setting makes sure that the above JK settings are propagated into all virtual hosts
JkMountCopy All

Tomcat must be configured for mod_jk

The following xml must be available / has to be added in tomcat's /conf/server.xml:

<Server>
  [...]
  <Service name="Catalina">
    [...]
    <Engine name="Catalina" defaultHost="localhost">
      <Listener className="org.apache.jk.config.ApacheConfig"
        modJk="{APACHE-ROOT}/modjk/mod_jk.so"
        workersConfig="{APACHE-ROOT}/workers.properties"/>

Create the directory {Apache-root}/modjk/

Necessary for the config files for mod_jk, and the module itself. It looked handy to me to put all the mod_jk stuff in one directory.

Create the workers.properties file

Create a file called "workers.properties" in the Apache root directory, with the following content:

workers.tomcat_home={TOMCAT-ROOT}
workers.java_home={PATH-TO-JAVA-INSTALLATION} (i.e. the Railo jre directory?)
worker.list=worker1
worker.worker1.type=ajp13
worker.worker1.host=localhost
worker.worker1.port=8009 (THIS PORT MUST MATCH THE TOMCAT SETUP)

If you haven't got a java installation already, you can download and install the latest jdk from sun.com (make sure you choose the JDK version)

Add the mod_jk.so module to the Apache install

Since this module is not part of the default Apache install, you need to download a compiled version here: http://tomcat.apache.org/download-connectors.cgi
If you are running on mac OSX 10.6 like me, then I already compiled the module for you :-)

Done!

When you now restart Apache and Tomcat, everything should work! if it doesn't, then take a log at the log files:

• {APACHE-ROOT}/logs/ (or another log location; see your httpd.conf for that)
• {TOMCAT-ROOT}/logs/catalina.out (and other logs)
• Or first stop Apache, and then enter the following command in a console window:
  • Windows: {apache-root}/bin/httpd.exe start -e debug
  • Mac: sudo apachectl -k start -e debug
• {APACHE-ROOT}/modjk/*.log

Good luck with it!