Take the 2-minute tour ×
Server Fault is a question and answer site for system and network administrators. It's 100% free, no registration required.

Firstly, I am completely new to IIS and Windows Server. Previously I used to work only on Apache and Linux.

I want to link IIS8 and Tomcat 7.0.34 under a subdomain, such that when someone visits subdom.mydomain.com then only, IIS forwards requests to tomcat

I consulted these two references:


and did exactly how they have shown. Below are the steps I have done:

  1. Downloaded windows x64 ISAPI binary from http://apache.techartifact.com/mirror//tomcat/tomcat-connectors/jk/binaries/windows/ and placed that isapi_redirect.dll in a directory name isapi created under my tomcat installation directory.

  2. I created a workers.properties file and placed it in tomcat's conf directory

worker.list= tomcatworker1
  1. Then I created a uriworkermap.properties file and placed it in tomcat's conf directory with following content(as I want tomcat's root app to run at the root path of subdomain):

Then I created a isapi_redirect.properties file and placed it in isapi directory under my tomcat installation with following content:

# Configuration file for the Jakarta ISAPI Redirector

# The path to the ISAPI Redirector Extension, relative to the website
# This must be in a virtual directory with execute privileges

# Full path to the log file for the ISAPI Redirector
log_file=C:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7_ins1\logs\isapi_redirect.log

# Log level (debug, info, warn, error or trace)

# Full path to the workers.properties file
worker_file=C:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7_ins1\conf\workers.properties

# Full path to the uriworkermap.properties file
worker_mount_file=C:\Program Files\Apache Software Foundation\Tomcat 7.0_Tomcat7_ins1\conf\uriworkermap.properties

In IIS Manager, in main server node and selected ISAPI and CGI Restrictions feature. Opened it and add a new restriction with the following information:

ISAPI or CGI path = {My Tomcat Directory Path}\isapi\isapi_redirect.dll
Description = Tomcat
Select "Allow extension path to execute"

Created a new site with binding subdom.mydomain.com and in it added a new virtual directory with the following properties:

Alias = tomcat
Physical path = {my Tomcat root directory}\isapi 

Next, ISAPI Filters feature under my new web site's node. Create a new filter with this information:

Filter name = tomcat
Executable = {my Tomcat root directory}\isapi\isapi_redirect.dll

At last, made sure that the ISAPI handler is enabled.

After doing all these things, when I accessed my subdomain, I came up with a run time error, which I don't know how to resolve. check out error at this link http://backops.cmee.in/

share|improve this question
I have not had much luck with ISAPI connector for IIS 8. I removed it and used the BonCode connector instead. It was simple. –  user160582 Feb 18 '13 at 21:20
I get it working now. It was not that much tough, I you like I could share the process. –  Abhi Feb 19 '13 at 5:59

1 Answer 1

I never had much success configuring it unless the virtual directory used the name jakarta and nothing else. The conf and logs directories needed to be subdirectories of the ISAPI installation directory.

If you created those .properties files using a right-click and New Text Document, that Windows didn't add a .txt extension to them.

Finally, use instead of localhost in your workers.properties. I don't know why but it doesn't work using localhost on Windows 2012.

share|improve this answer
I get it working now. It was not that much tough, I you like I could share the process. –  Abhi Feb 19 '13 at 5:59
Sure. I'd like to know what you did to get it working. –  mahnsc Feb 19 '13 at 12:58

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.