If you are looking for instructions on how to integrate IIS with DocTera click here.

This document assumes:

• Knowledge of IIS administration.
• Knowledge of Windows administration and configuration.
• That Java is installed in C:\j2sdk1.4
• That tomcat is installed in C:\jakarta-tomcat\.

Step 1
Download an install Web Server Connector. These can be found here. Please download the most recent connector.

If the link above doesn't work, visit Tomcat Connector Downloads. Make sure that you go to, JK 1.2 Binary Releases - Win32 - jk-1.2.XX where XX is the highest listed number and download isapi_redirect.msi
MSI is a self installing archive for Windows.
* Once you have downloaded the msi file, run it. It will ask you where to install the connector files, specify c:\Isapi-Redirector

Step 2
MSI installer will automatically configure worker.properties.minimal and uriworkermap.properties in c:\Isapi-Redirector\conf
Both files are important because they control, what tomcat contexts can be connected to IIS. To add your own context (for example /files2u) edit uriworkermap.properties with Notepad and add the following lines (near line 12):

...
/files2u*=wlb
/files2u/*=wlb
...

Make sure that you get familiar with those files, you may have to modify them later.

Step 3
Registry Configuration
The MSI file modified your Registry. In order for the ISAPI Redirector to function properly, several settings must be setup in the Registry.

Here is an example of what MSI installer added to your registry:

[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation]
@=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector]
@=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0]
@=""
"extension_uri"="/jakarta/isapi_redirect.dll"
"log_file"="C:\\Isapi-Redirector\\log\\isapi_redirect.log"
"log_level"="info"
"worker_file"="C:\\Isapi-Redirector\\conf\\workers.properties.minimal"
"worker_mount_file"="C:\\Isapi-Redirector\\conf\\uriworkermap.properties"

Make sure that the registry was modified properly.

Step 4
MSI install script also modified your IIS configuration
Make sure that the installer changed all of the following in IIS Configuration:

1. Added a virtual directory
   You will need to open up the IIS Management Console (typically there is a shortcut under "Control Panel -> Administrative Tools -> Internet Information Services that will open the IIS Management Console). First make sure that a virtual directory named jakarta was createded which points to the directory you placed the isapi_redirect.dll (which should be C:\Isapi-Redirector\bin\win32\i386). Make sure that this virtual directory has "execute" access.
   
   
2. Make sure that the DLL is on the list of ISAPI Filters in IIS.
   The image below will give you a good idea as to how to check filter settings.
   
   
   
   
3. Also IIS 6.0 has to be in "IIS 5.0 Isolation Mode"
   Make sure that "IIS 5.0 Isolation mode." is enabled. (In the management console go to: Web Site Properties -> Service -> Isolation Mode - see image below).
   
   
   
   Please note that turning on this "isolation mode" more than likely disables some of the additional functionality added to IIS in the 5 -> 6 upgrade.
   
   
4. Make sure that Tomcat's Redirector DLL in Web Service Extensions is Allowed
   The image below will give you a good idea as to how to set permissions to the filter.
   
   
   

For more information on Tomcat IIS integration visit:
http://www.ozibug.com/doc/howto/iis-integration-howto.html

http://tomcat.apache.org/connectors-doc/config/iis.html

Test your configuration
Using a web browser go to http://localhost:8080/files2u/ and make sure that you get to the login page of Files2U.
Then attempt the same via http://localhost/files2u/ If you see the same screen that you saw on port 8080 then it means that your IIS Tomcat integration worked. Congratulations!