Links Docs Home Reference Guide workers.properties uriworkermap.properties Status Worker Apache IIS Generic HowTo For the impatient All about workers Timeouts Load Balancing Reverse Proxy Webserver HowTo Apache IIS Netscape/SunOne/Sun AJP Protocol Reference AJPv13 AJPv13 Extension Proposal Miscellaneous Documentation Frequently asked questions Changelog Current Tomcat Connectors bugs Contribute documentation JK Status Ant Tasks Reporting Tools Old JK/JK2 documentation News 2009 2008 2007 2006 2005 2004 |
# The Apache Tomcat Connector - Generic HowTo ## Quick Start HowTo | print-friendly version
Introduction
This document describes the configuration files used by JK on the Web Server side for the 'impatient': workers.properties is a mandatory file used by the webserver and which is the same for all JK implementations (Apache/IIS/NES). web server add-ons to be set on the webserver side. We'll give here minimum servers configuration and an example workers.properties to be able to install and check quickly your configuration.
Minimum workers.properties
> Here is a minimum workers.properties, using just ajp13 to connect your Apache webserver to the Tomcat engine, complete documentation is available in Workers HowTo.
>       # Define 1 real worker using ajp13
>       worker.list=worker1
>       # Set properties for worker1 (ajp13)
>       worker.worker1.type=ajp13
>       worker.worker1.host=localhost
>       worker.worker1.port=8009
Minimum Apache web server configuration
> Here is a minimum information about Apache configuration, a more complete separate HowTo for Apache is available. You should first have mod_jk.so (unix) or mod_jk.dll (Windows) installed in your Apache module directory (see your Apache documentation to locate it). Usual locations for modules directory on Unix: /usr/lib/apache/ /usr/lib/apache2/ /usr/local/apache/libexec/ Usual locations for modules directory on Windows : C:\Program Files\Apache Group\Apache\modules\ C:\Program Files\Apache Group\Apache2\modules\ You'll find a link to prebuilt binaries here Here is the minimum which should be set in httpd.conf directly or included from another file: Usual locations for configuration directory on Unix: /etc/httpd/conf/ /etc/httpd2/conf/ /usr/local/apache/conf/ Usual locations for configuration directory on Windows : C:\Program Files\Apache Group\Apache\conf\ C:\Program Files\Apache Group\Apache2\conf\
>       # Load mod_jk module
>       # Update this path to match your modules location
>       LoadModule    jk_module  libexec/mod_jk.so
>       # Declare the module for <IfModule directive> (remove this line on Apache 2.x)
>       AddModule     mod_jk.c
>       # Where to find workers.properties
>       # Update this path to match your conf directory location (put workers.properties next to httpd.conf)
>       JkWorkersFile /etc/httpd/conf/workers.properties
>       # Where to put jk shared memory
>       # Update this path to match your local state directory or logs directory
>       JkShmFile     /var/log/httpd/mod_jk.shm
>       # Where to put jk logs
>       # Update this path to match your logs directory location (put mod_jk.log next to access_log)
>       JkLogFile     /var/log/httpd/mod_jk.log
>       # Set the jk log level [debug/error/info]
>       JkLogLevel    info
>       # Select the timestamp log format
>       JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
>       # Send everything for context /examples to worker named worker1 (ajp13)
>       JkMount  /examples/* worker1
Minimum IIS web server configuration
A separate HowTo for the IIS web server is available. This paragraph has not been written yet, but you can contribute to it.
Minimum NES/iPlanet/Sun web server configuration
A separate HowTo for the Netscape/iPlanet/Sun web server is available. This paragraph has not been written yet, but you can contribute to it.
Test your configuration
(Re)start the web server and browse to the http://localhost/examples/
Copyright © 1999-2010, Apache Software Foundation