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