Kbase P19929: How to setup Tomcat and IIS?
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
6/22/2009 |
|
Status: Verified
GOAL:
How to setup Tomcat and IIS?
GOAL:
How to setup Microsoft's Internet Information System (IIS) to work with the Tomcat JSE?
FACT(s) (Environment):
Windows NT 32 Intel/Windows 2000
Tomcat
IIS
FIX:
Prior to configuring IIS with Tomcat, ensure that IIS is installed and working and Tomcat has been installed and configured to work with AIA. For information on how to configure the AppServer Internet Adapter with Tomcat, see Solution P21274, How to setup TOMCAT and AIA.
1. 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. Ensure that the proper case is used when modifying any Tomcat configuration file. Tomcat is a case sensitive product.
# 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)
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.
a. This can be done by Launching Internet Services Menu from Control Panel, Administrative Tools.
b. Right click on the desired web site and select New, Virtual Directory.
c. Use "jakarta" as the alias.
d. From the Directory text box browse to the %TOMCAT_HOME% directory.
e. Set the Access Permissions to Read, Run Scripts and Execute.
f. Choose OK and Finish.
2. Create a ISAPI filter.
a. Right click on the web site and select properties.
b. Choose the ISAPI Filter tab and Click Add.
c. 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.