Links Docs Home Reference Guide workers.properties uriworkermap.properties Status Worker Apache HTTP Server IIS Generic HowTo For the impatient All about workers Timeouts Load Balancing Reverse Proxy Webserver HowTo Apache HTTP Server 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 2011 2010 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-2011, Apache Software Foundation