Documentation Overview

Introduction

The Apache Tomcat Connectors project is part of the Tomcat project and provides web server plugins to connect web servers with Tomcat and other backends.

The supported web servers are:

  • the Apache HTTP Server with a plugin (module) named mod_jk.
  • Microsoft IIS with a plugin (extension) named ISAPI redirector (or simply redirector).
  • the iPlanet Web Server with a plugin named NSAPI redirector. The iPlanet Web Server was previously known under various names, including Netscape Enterprise Server, SunOne Web Server and Sun Enterprise System web server.

In all cases the plugin uses a special protocol named Apache JServ Protocol or simply AJP to connect to the backend. Backends known to support AJP are Apache Tomcat, Jetty and JBoss. Although there exist 3 versions of the protocol, ajp12, ajp13, ajp14, most installations only use ajp13. The older ajp12 does not use persistent connections and is obsolete, the newer version ajp14 is still experimental. Sometimes ajp13 is called AJP 1.3 or AJPv13, but we will mostly use the name ajp13.

Most features of the plugins are the same for all web servers. Some details vary on a per web server basis. The documentation and the configuration is split into common parts and web server specific parts.

down to the more detailed documentation that is available. Each available manual is described in more detail below.

Headlines

  • JK-1.2.48 released

    The Apache Tomcat team is proud to announce the immediate availability of Tomcat Connectors 1.2.48 Stable. This release contains improvements and bug fixes for issues found in previous releases.

    Download the JK 1.2.48 release.

  • Download previous releases from the archives.

Reference Guide

  • workers.properties

    A Tomcat worker is a Tomcat instance that is waiting to execute servlets on behalf of some web server. For example, we can have a web server such as Apache forwarding servlet requests to a Tomcat process (the worker) running behind it.

    This page contains detailed description of all workers.properties directives.

  • uriworkermap.properties

    The forwarding of requests from the web server to tomcat gets configured by defining mapping rules. The so-called uriworkermap file is a mechanism of defining those rules.

  • Status Worker

    The status worker is a builtin management worker. It displays state information and can also be used to dynamically reconfigure JK.

  • Apache HTTP Server (mod_jk)

    This page contains detailed description of all directives of mod_jk for the Apache HTTP Server.

  • Microsoft IIS (ISAPI redirector)

    This page contains detailed description of all directives of the ISAPI redirector for Microsoft IIS.

Common HowTo

  • Quick Start

    This page describes the configuration files used by JK on the web server side for the 'impatient'.

  • All about workers

    This page contains an overview about the various aspects of defining and using workers.

  • Timeouts

    This page describes the possible timeout settings you can use.

  • Load Balancing

    This page contains an introduction on load balancing with JK.

  • Reverse Proxy

    This page contains an introduction to reverse proxies, how JK handles this situation and how you can influence the JK proxying behaviour.

Webserver HowTo

These pages contain detailed descriptions of how to build and install JK for the various web servers.

AJP Protocol Reference

  • AJPv13

    This page describes the Apache JServ Protocol version 1.3 (hereafter ajp13).

  • AJPv13 Extension Proposal

    This page describes an extension proposal for ajp13.

Miscellaneous documentation

Comments

Notice: This comments section collects your suggestions on improving documentation for Apache Tomcat.

If you have trouble and need help, read Find Help page and ask your question on the tomcat-users mailing list. Do not ask such questions here. This is not a Q&A section.

The Apache Comments System is explained here. Comments may be removed by our moderators if they are either implemented or considered invalid/off-topic.