Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

The Jakarta Tomcat Connector mod_jk module is provided as a connector from Apache Tomcat source. Both Jetty and Tomcat are fully compatible with this connector. This module is available when you download the Tomcat source, but you can also download it separately. See http://tomcat.apache.org/download-connectors.cgiImage Removed for the proper version for your system.

In addition to mod_jk, you will require a workers.properties file, also available with the Apache Tomcat source distribution. This properties file tells the mod_jk plugin how to connect to the Geronimo server. For a detailed explanation on all the available options for configuring the Jakarta Tomcat Connector, visit http://tomcat.apache.org/connectors-doc/config/workers.htmlImage Removed.

Info

For practical purposes, the module mod_jk-apache-2.2.3.so for Windows and the workers.properties are included in the Attachments section in this article.

...

Edit the httpd.conf file located in the <httpd_home>\conf directory to load the Jakarta Tomcat Connector mod_jk module. Add the following lines at the end of the httpd.conf file.

borderStyle
No Format
solidtitleExcerpt from httpd.conf
borderStylesolid
LoadModule jk_module modules/mod_jk.so			
# Loads the Jakarta Tomcat Connector module

JkWorkersFile <httpd_home>\conf\workers.properties
# Tells the module the location of the workers.properties file

JkLogFile     <httpd_home>\logs\mod_jk.log
# Specifies the location for this module's specific log file

JkLogLevel    info
# Sets the module's log level to info

JkMount /console/* ajp13
# Sets a mount point from a context to a Tomcat worker. In this case will allow access (forward the request) to the console.

...

Edit the workers.properties file located in the <httpd_home>\conf directory to match your environment. The following example is an excerpt from the workers.properties file with just the variables you should focus on.

No Format
borderStylesolid
titleMinimum requirements for the workers.properties
borderStylesolid
worker.ajp13.type=ajp13
# Sets the version of AJP used. The AJP listeners defined in Geronimo are AJP v13.

worker.ajp13.host=localhost
# Specifies the location of the Geronimo server. Use default localhost for single-tier scenarios. Specify the
# hostname of the Geronimo server for multi-tier environments.

worker.ajp13.port=8009
# Both Tomcat and Jetty come with a predefined AJP13 listener on port 8009

...

  1. Check Geronimo connectivity by accessing http://localhost:8080/consoleImage Removed , you should see the Geronimo Administration Console.
  2. Check HTTPd connectivity by accessing http://localhostImage Removed , you should see the Apache HTTPd welcome page.
  3. Check the HTTPd - Geronimo request forwarding by accessing http://localhost/console/Image Removed , you shoud be redirected to the Geronimo Administration Console. Note that at the end of the URL, there is a "/", failing to include this / will result in a Not Found error triggered by the Jakarta Tomcat Connector module.

...