Prerequisites:Prior to configuring IIS with Tomcat, ensure that IIS is installed and working and Tomcat has been installed and configured to work with AppServer Internet Adapter (AIA). For information on how to configure the AIA with Tomcat, see Solution
P21274, How to setup TOMCAT and AIA.Part 1: Configuring the Tomcat components1. Download the appropriate isapi_redirect.dll file from Apache web site for the version of Tomcat.
2. Copy the isapi_redirector.dll file to the %TOMCAT_HOME%\conf\ntiis directory. If the directory does not exist create it.
3. Copy the %TOMCAT_HOME%\conf\jk\workers.properties file to %TOMCAT_HOME%\conf\ntiis.
4. Create a uriworkermap.properties file in %TOMCAT_HOME%\conf\ntiis that contains the following:
# Default worker to be used through our mappings
default.worker=ajp13
# Sites to be redirected to Tomcat
/examples=$(default.worker)
/examples/*=$(default.worker)
/webdav=$(default.worker)
/webdav/*=$(default.worker)
/tomcat-docs=$(default.worker)
/tomcat-docs/*=$(default.worker)
/manager=$(default.worker)
/manager/*=$(default.worker)
#Mount the sample aia context to the ajp13 worker
/aia/*=$(default.worker)
#Mount the sample wsa context to the ajp13 worker
/wsa/*=$(default.worker)
Ensure that the proper case is used when modifying any Tomcat configuration file. Tomcat is a case sensitive product.
5. Modify the workers.properties file to ensure TOMCAT_HOME points to the installation directory of Tomcat and JAVA_HOME points to the installation of JAVA.
Example:
workers.tomcat_home=c:\tomcat3_3a
workers.java_home=c:\Java
6. Create the following registry key:
[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0]
"extension_uri"="/jakarta/isapi_redirect.dll"
"log_file"="C:\\tomcat 3_3a\\logs\\iis_redirect.log"
"log_level"="emerg"
"worker_file"="C:\\tomcat 3_3a\\conf\\ntiis\\workers.properties"
"worker_mount_file"="C:\\ tomcat3_3a\\conf\\ntiis\\uriworkermap.properties"
Disclaimer: Create an Operating System level backup of the system prior to changing the registry editor, as corruption to the registry can cause the OS to become unusable.
PART 2: Configuring Internet Information Server. IIS
1. Add a Virtual Directory.
- Launch the Internet Services Menu from Control Panel, Administrative Tools.
- Right click on the desired web site and select New, Virtual Directory.
- Use "jakarta" as the alias.
- From the Directory text box browse to the %TOMCAT_HOME% directory.
- Set the Access Permissions to Read, Run Scripts and Execute.
- Choose OK and Finish.
2. Create a ISAPI filter.
- Right click on the web site and select properties.
- Choose the ISAPI Filter tab and Click Add.
- Enter "Jakarta ISAPI Redirector" for the Filter Name and browse to the %TOMCAT_HOME%\conf\ntiis\isapi_redirect.dll file. Save the filter and close the properties menu.
3. Relaunch the properties menu to ensure newly created Filter contains a green arrow. If the filter that was added does not contain a green arrow stop and restart IIS. If the green arrow is not present IIS has a configuration mistake and this will need to be corrected before continuing.
