Configuring Tomcat to work with IIS

Using Windows 2000, IIS 5.0, and Tomcat 4.1.24

This is a listing of what to do with no explination of why. These steps worked for me installing on two dissimiliar boxes. If you have any questions, I’m probably not the one to ask because I don’t really understand the details of the connector.

  1. Install IIS. Make sure it’s working.
  2. Install Tomcat. Make sure it’s working on port 8080. Don’t change anything!
  3. Download isapi_redirect.dll from the Jakarta site. I found it at http://jakarta.apache.org/builds/jakarta-tomcat/release/v3.3/bin/win32/i386/isapi_redirect.zip.
  4. Put isapi_redirect.dll in %CATALINA_HOME%/bin.
  5. In %CATALINA_HOME%/conf/server.xml, uncomment the line:

<!--

<Connector className="org.apache.ajp.tomcat4.Ajp13Connector"

port="8009" minProcessors="5" maxProcessors="75"

acceptCount="10" debug="0"/>

-->

  1. If any other connector on port 8009 is uncommented – comment it out.
  2. In conf/server.xml just under the top-level <server …> node, add the node:

<Listener className="org.apache.ajp.tomcat4.config.IISConfig" />

  1. If Tomcat is running, shut it down.
  2. Start Tomcat.
  3. Delete the listener line from %CATALINA_HOME%/conf/server.xml.
  4. I put all of my IIS files in %CATALINA_HOME%/iis. The example here does not show that but to do that you need to:
  5. Copy workers.properties, uriworkermap.properties, and isapi_redirect.dll to %CATALINA_HOME%/iis.
  6. Edit %CATALINA_HOME%/conf/auto/iis_redirect.reg to the new file location.
  7. Set %CATALINA_HOME%/iis as the virtual directory for jakarta.
  8. Select %CATALINA_HOME%/iis/ isapi_redirect.dll as the filter.
  9. Run %CATALINA_HOME%/conf/auto/iis_redirect.reg.
  10. Create the file %CATALINA_HOME%/conf/jk/workers.properties file and in it type:

workers.java_home=C:\java\j2sdk1.4

workers.tomcat_home="C:\Program Files\Apache Group\Tomcat 4.1"

ps=\

worker.list=myworker

worker.myworker.type=ajp13

worker.myworker.port=8009

worker.myworker.host=localhost

  1. Start up the IIS manager and right click on Default Web Site and then select New, Virtual Directory. Press Next and you will get:
  1. Type in jakarta as the alias and press Next and you will get:
  1. Type in the directory where isapi_redirect.dll is and press Next and you will get:
  1. Uncheck Run Scripts and check Execute and press Next and then Finish.
  2. In IIS Manager, right click on the Default Web Site, Select Properties, then select the ISAPI Filters tab. Click the Add button.
  3. Fill out the dialog box with jakarta and the location of isapi_redirect.dll.
  1. Reboot your computer. (Yes shutting down and restarting IIS and Tomcat should be sufficient – but sometimes it isn’t.)
  2. Start IIS.
  3. Start Tomcat (this step is easy to forget).
  4. Go to http://localhost/examples/servlets/index.html. It should be the tomcat servlet examples page.
  5. If this doesn’t work, buy the book Professional Apache Tomcat and read chapter 14.