logo reynir.net


Tomcat and IIS Installation process.


This procedure seems to cause many people problems, it's simple though.

First of all, download the component needed to do the connection isapi_redirect.dll (this version is from tc.3.3), and save it under $tomcat_home\bin\native\

Note : replace $tomcat_home with your tomcat installation directory.

Now, create the workers.properties file where you define the worker "main".

worker.tomcat_home=C:\$tomcat_home
worker.java_home=C:\jdk1.3.1
ps=\
worker.main.type=ajp13
worker.main.lbfactor=1
worker.loadbalancer.type=lb
worker.loadbalancer.balanced_workers=main
worker.list=main
worker.main.port=8009
worker.main.host=www.domain.com

You should enter the value for the www.domain.com that you want to use (the name of the virtual host this should work for), here the first 3 lines are system declarations. the next lines define one worker called main, and list it up in the loadbalancing line.
Save this file into c:\$tomcat_home\conf\worker.properties

You will also need uriworkermap.properties

/servlet/*=main
*.jsp=main

Save this file into c:\$tomcat_home\conf\uriworkermap.properties
That should do for all the usual mappings, if you have any other servlet mappings, you should add it to the file.

You need to create a registry mergable file such as the one below , and merge it into the registry.

REGEDIT4
[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0]
"extension_uri"="/jakarta/isapi_redirect.dll"
"log_file"="C:\\$tomcat_home\logs\\iis_redirect.log"
"log_level"="debug"
"worker_file"="C:\\$tomcat_home\\conf\\worker.properties"
"worker_mount_file"="C:\\$tomcat_home\\conf\\uriworkermap.properties"

You must be sure these values are correctly spelled, and you must check if these files exist.
Ok, now you must open the Internet Information Server Management Console, accessable through:
- [start]->settings->control panel->Administrative tools->Internet Services Manager
Select the Host you are working with.
"Right click" it and open it's properties dialog.
Select the ISAPI Filters tab.
Click Add
type in filtername : jakarta
type in Executable : $tomcat_home\bin\native\isapi_redirect.dll (or browse to it).

click OK.
Next create a new virtual directory, named jakarta. It's "Local path" should be C:\$tomcat_home\bin\native

Now, open the services dialog (from control panel-> administrative tools -> services).
restart the "World Wide Web Publishing Service".
now go back to the Internet service manager, and check if the arrow in the ISAPI Filter dialog has turned green.
If it has not turned green one or more of the paths in the registry-file you merged to the registry (in above step) is incorrect.
You must run regedit (from start -> run -> regedit) and browse to HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0.
Now review the paths, the redirector not finding the configuration files is the only reason for a red arrow.