Configure IIS 8 and Tomcat Connector ISAPI Filter on Windows Server 2012

We are going to configure IIS 8 as a frond-end for Apache Tomcat.

Instructions should also work on Windows Server 2008 R2 with IIS7.5.

Step 1

If on IIS 8, install ISAPI extensions and ISAPI Filters first thing in the Add Roles and Features of Server Roles as below screenshot:

Step 2

Download the isapi_redirect.dll from the Tomcat site:

Unzip the file and copy the isapi_redirect.dll into the Tomcat’s installation directory:

C:\Program Files (x86)\Dashboard\Dashboard\tomcat\bin\

Be advised that Tomcat path may differ depending on your installation.

Step 3

Run Regedit as Administrator and backup the registry hive!

Create the following entry:

HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0

If Apache Software Foundation folder does not exist in the hierarchy mentioned above, then create the path manually. So, the hierarchy will resemble the following:

[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0]

Add the following registry keys with values (all strings):

extension_uri = /jakarta/isapi_redirect.dll
log_file = C:\Program Files (x86)\Dashboard\Dashboard\tomcat\logs\isapi_redirect.log
log_level = error
worker_file = C:\Program Files (x86)\Dashboard\Dashboard\tomcat\conf\
worker_mount_file = C:\Program Files (x86)\Dashboard\Dashboard\tomcat\conf\

See the image below for more info.

Step 4

Setup isapi and CGI restriction on IIS server.

Open IIS Manager and Select Your Server. From the features view open ISAPI and CGI Restrictions, click Add from the Actions bar.

For ISAPI or CGI Path click the … Button and choose isapi_redirect.dll file at the tomcat installation folder (C:\Program Files (x86)\Dashboard\Dashboard\tomcat\bin\).

In the Description Field write isapi_redirect.

Tick the Allow extension path to execute and click OK.

Step 5

Add a new IIS web site with the following details:

Site name:
Physical path: C:\inetpub\wwwroot\tomcat
Host name:
Start website immidiately: untick

Add an HTTPS binding on port 443 and pick a suitable SSL certificate.

At this point we should have a new site created with bindings on ports 80 and 443. We can test the site by putting a blank index.html file to C:\inetpub\wwwroot\tomcat\.

Now, select the site we just created and double click the ISAPI Filters icon to open it. Click Add.

Type jakarta in the filter name And click … Button to to select the isapi_redirect.dll.

Click open to select the dll file and OK to close the window when done.

Step 6

Right click to the site created in step #5 and choose Add Virtual Directory.

Type jakarta in the Alias field and choose the path of the isapi_redirect.dll file (C:\Program Files (x86)\Dashboard\Dashboard\tomcat\bin\) as the Physical path. Click OK when done.

Open Handler Mappings by selecting the virtual directory Jakarta.

Select Edit Feature Permissions from the Actions bar and Check All (Read, Script, and Execute) and click OK.

Step 7

Configure Tomcat redirection.

Copy C:\Program Files (x86)\Dashboard\Dashboard\tomcat\conf\ to C:\Program Files (x86)\Dashboard\Dashboard\tomcat\conf\ Do not modify the content of the file.

Restart the Tomcat service. Test the configuration by opening the IIS site.


Leave a Reply

Your email address will not be published. Required fields are marked *