Installing the Tomcat Connector plugin for IIS

To install the Apache Tomcat Connector, you need to download the IIS server plugin from the Apache website and then create the required directory structure and .properties files.

Before you begin, download the isapi_redirect-1.2.40.dll file. This file enables Tomcat authentication for SPNEGO and chunked transfer encoding for preserving persistent connections.

If you are using a 32-bit operating system, get the .dll file from http://apache.mirror.iweb.ca/tomcat/tomcat-connectors/jk/binaries/windows/tomcat-connectors-1.2.40-windows-x86_64-iis.zip

If you are using a 64-bit operating system, get the .dll file from http://apache.mirror.iweb.ca/tomcat/tomcat-connectors/jk/binaries/windows/tomcat-connectors-1.2.40-windows-i386-iis.zip

To install the Tomcat Connector plugin:
  1. Create a mod_jk directory somewhere in the file system. For example, C:\Program Files\mod_jk.
  2. Copy the isapi_redirect-1.2.40.dll file into the mod_jk directory that you just created.
  3. Inside the mod_jk directory, create a new file called isapi_redirect-1.2.40.properties.
    Important: The name of the .properties file must match the name of the .dll file exactly.
  4. Inside the mod_jk directory, create a subdirectory named log.
  5. Inside the mod_jk directory, create a second subdirectory named conf.
  6. Inside the log subdirectory, create an empty text file and name it isapi_redirect.log.
  7. Inside the conf subdirectory, create the following two files:
    • uriworkermap.properties
    • workers.properties

After creating the directory structure and the configuration files, edit the uriworkermap.properties and workers.properties files to define the Tomcat workers (also known as Tomcat instances) and edit the isapi_redirect-1.2.40.properties file to configure the redirector.

If you want to configure additional ISAPI redirectors, create another directory with identical content and a different name, for example mod_jk_node2.