# The Apache Tomcat Connector - Generic HowTo

## Quick Start HowTo

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).
> - 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 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 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 complete documentation is available in IIS HowTo.

> This paragraph has not been written yet, but you can contribute to it.

Minimum NES/iPlanet web server 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