Apache Software Foundation | Jakarta Project | Apache Tomcat
Installation

The actual build mechanism creates the dso files in the build/jk2/${servername} subdirectory of the jakarta-tomcat-connectors/jk. When configure --with-jni is used 2 dso files are created. These files have to be copied in the right location of the web server installation.

Apache 1

Apache 2

In the following example Apache-2.0 is installed in /home/apache20/apache40 and the commands are excuted in the jakarta-tomcat-connectors directory.

Copy the dso files in the modules location:
[user@host] ~ $ cp jk/build/jk2/apache2/mod_jk2.so /home/apache20/apache40/modules
[user@host] ~ $ cp jk/build/jk2/apache2/jkjni.so /home/apache20/apache40/modules
Add mod_jk2 loading in the httpd.conf:
LoadModule jk2_module modules/mod_jk2.so


IIS

A pre-built version of the ISAPI redirector server plugin, isapi_redirector2.dll, is available under the win32/i386 directory of jakarta-tomcat-connectors distribution. You can also build a copy locally from the source present in jakarta-tomcat-connectors distribution.
The Tomcat redirector requires three entities:

  • isapi_redirector2.dll - The IIS server plugin, either obtain a pre-built DLL or build it yourself (see the build section).
  • workers2.properties - A file that describes the host(s) and port(s) used by the workers (Tomcat processes). A sample workers2.properties can be found under the conf directory.
  • jk2.properties - A configuration file used by mod_jk2 on the Tomcat side.

  1. In the registry, create a new registry key named "HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\2.0"
  2. Add a string value with the name serverRoot and a value which is a full path to your Tomcat installation (for example c:\jakarta-tomcat )
  3. Add a string value with the name extensionUri and a value of /jakarta/isapi_redirector2.dll
  4. Add a string value with the name workersFile and a value which is the full path to your workers2.properties file (for example c:\jakarta-tomcat\conf\workers2.properties )
  5. Add a string value with the name logLevel and a value for your log level (can be DEBUG, INFO or ERROR).
  6. Using the IIS management console, add a new virtual directory to your IIS web site. The name of the virtual directory must be jakarta. Its physical path should be the directory where you placed isapi_redirector2.dll While creating this new virtual directory assign it with execute access.
  7. Using the IIS management console, add isapi_redirector2.dll as a filter in your IIS web site. The name of the filter should reflect its task (I use the name jakarta), its executable must full path to the isapi_redirector2.dll.

That's all, you should now start Tomcat and ask IIS to serve you the /examples context. Try http://localhost/examples/jsp/index.html for example and execute some of the JSP examples.