Tomcat Connector - Quick Start HowTo

Links Docs Home Generic Howto For the impatient All about workers Load Balancing Webservers Apache IIS Domino SunOne (Netscape) Get Involved Contribute documentation |
# Tomcat Connector ## Quick Start HowTo | print-friendly version
Introduction
This document describes the configuration files used by JK on the Web Server side for the 'impatients': workers.properties is a mandatory file used by the webserver and which is the same for all JK implementations (Apache/IIS/NES). WebServers 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
>       worker.worker1.lbfactor=50
>       worker.worker1.cachesize=10
>       worker.worker1.cache_timeout=600
>       worker.worker1.socket_keepalive=1
>       worker.worker1.recycle_timeout=300
Minimum Apache WebServer configuration
> Here is a minimun informations about Apache configuration, a complete documentation is available in Apache HowTo. 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 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 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 /examples to worker named worker1 (ajp13)
>       JkMount  /examples/* worker1
Minimum Domino WebServer configuration
A complete documentation is available in Domino HowTo. This paragraph has not been written yet, but you can contribute to it.
Minimum IIS WebServer configuration
A complete documentation is available in IIS HowTo. This paragraph has not been written yet, but you can contribute to it.
Minimum NES/iPlanet WebServer configuration
A complete documentation is available in Netscape/iPlanet HowTo. 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-2005, Apache Software Foundation