tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <>
Subject [Tomcat Wiki] Update of "Tomcat_and_IIS_Howto" by LiamLeane
Date Thu, 23 Sep 2010 11:20:46 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Tomcat Wiki" for change notification.

The "Tomcat_and_IIS_Howto" page has been changed by LiamLeane.
The comment on this change is: Added permissions and IIS7 howto.


+ === Permissions ===
+ The official documentation lacks a few important bits around file permissions  that must
be set if the application pool identity the connector is running under  does not have global
permissions to the servers file system:
+  * The directory with your isapi_redirect.dll and associated .properties files  must be
at least read only to the application pool identity account
+  * If you have logging enabled  for the filter then the application pool  identity must
have read & write access to the log file
+  * If you use the registry for the configuration then the application pool  identity must
have read access to the keys If you miss any of the above then the filter simply will not
work and you  will not receive any form of error messages to tell you it has not  worked.
+ === Windows 2008 / IIS 7 Step by Step ===
+ The following steps detail setting up IIS to function correctly with the  connector, it
assumes you have already completed the .properties or registry  configuration:
+ '''Allow ISAPI Filter to run:'''
+  * In the IIS Manager console select the computer node
+  * Open the "ISAPI and CGI" restrictions panel
+  * Click the "Add" button
+  * Under "ISAPI or CGI path" enter the full path to the Connector ISAPI  dll
+  * Under "Description" add something meaningful such as "Tomcat"
+  * Check "Allow extension path to execute"
+  * Click "Ok"
+ '''Enable ISAPI Filter for individual  sites:'''
+  * In the IIS Manager console open the computer node and select the website to  add the
ISAPI filter to
+  * Right click on the website node and add a new virtual directory pointing to  the directory
containing the dll and associated .properties files
+  * Open the "ISAPI Filters" panel
+  * Click the "Add" button
+  * Under "Filter Name" add something meaningful such as "Tomcat"
+  * Under "Executable" enter the full path to the Connector ISAPI dll
+  * Click "Ok"
+ If you are using the website for hosting other technologies (such as  the order
of execution for the filters may have to be changed for everything to  work as expected. In
order to do this click "View Ordered List" in the "ISAPI  Filters" panel for a website and
then use the "Move Up" and "Move Down" buttons  to reorganise the execution order. If you
would like to handle cases  such as 404's then the Tomcat filter should appear BEFORE
those for .net. If you  are using specialist authentication filters (such as CA SiteMinder)
then these  should appear before Tomcat so that requests are correctly authenticated prior
 to being received by the connector.
+ === Setup ===
  Configuring Tomcat and IIS is documented at [[|the
IIS Howto page]] . The instructions there work fine, but there is a [[|setup
program]] which allows you to skip steps 1 through 7 in the "Configuring the ISAPI Redirector"
section of this page. Also, step 8 can be done using a VBScript file like this:

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message