# The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector ## 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.46 released The Apache Tomcat team is proud to announce the immediate availability of Tomcat Connectors 1.2.46 Stable. This release contains improvements and bug fixes for issues found in previous releases. Download the JK 1.2.46 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. Apache HTTP Server (mod_jk) Microsoft IIS (ISAPI redirector) iPlanet Web Server (NSAPI redirector)
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
Frequently asked questions Changelog This page contains the detailed list of all changes made in each version of JK. Current Tomcat Connectors bugs This is the Bugzilla Bug List related to Tomcat Connectors. Contribute documentation This page describes, how to contribute to the JK documentation. JK Status Ant Tasks This page describes ant tasks to automate JK management via the status worker. Reporting Tools This page contains information, on some report analysis scripts contained in the JK distribution. Old JK/JK2 documentation archive. Here you can find old JK and JK2 documentation.
Copyright © 1999-2018, Apache Software Foundation