English

How To: Install IIS Redirector for Tomcat

Summary

Instructions provided are for the installation of the IIS Redirector for Tomcat.

Procedure

See Related Information for links to the required files.

Warning:
The instructions below include making changes to essential parts of your operating system. It is recommended that you backup your operating system and files, including the registry, before proceeding. Consult with a qualified computer systems professional, if necessary.

Esri cannot guarantee results from incorrect modifications while following these instructions; therefore, use caution and proceed at your own risk.
  1. Navigate to <drive>:\jakarta\tomcat-3.2\bin and create a directory called iis, and under it create a directory called i386.
  2. Copy the isapi_redirect.dll from the Tomcat Web site into the new i386 directory.
  3. Click Start > Run and type regedit. Click OK to bring up the Registry Editor.
  4. Expand HKEY_LOCAL_MACHINE.
  5. Right-click the SOFTWARE folder and select New > Key. Type 'Apache Software Foundation' for the folder name and press Enter.
  6. Right-click Apache Software Foundation and select New > Key. Type Jakarta Isapi Redirector for the name and press Enter.
  7. Right-click Jakarta Isapi Redirector and select New > Key. Type 1.0 and press Enter.
  8. Add the following string values:
    1. In the left panel of the Registry, right-click 1.0 and select New > String Value.
    2. Type in the Name and press Enter.
    3. Type in the Value and press Enter.
  • Name: extension_uri
  • Value: /jakarta/isapi_redirect.dll
  • Name: log_file
  • Value: <drive>:\jakarta-tomcat-3.2\isapi.log
  • Name: log_level
  • Value: inform
  • Name: worker_file
  • Value: <drive>:\jakarta-tomcat-3.2\conf\workers.properties
  • Name: worker_mount_file
  • Value: <drive>:\jakarta-tomcat-3.2\conf\uriworkermap.properties
Warning:
Exercise extreme caution when manipulating the contents of the registry, as it can seriously compromise the integrity of your system. 
  1. Close the Registry Editor.
  2. Open the IIS Management console.
    • For Windows NT:
      • Click Start > Programs > Windows NT Option Pack > Microsoft Internet Information Server > Internet Service Manager.
    • For Windows 2000:
      • Click Start > Settings > Control Panel > Administrative Tools > Internet Services Manager.
  3. Select the Default Web Site under the localhost name and click Action in the toolbar.
  4. Select New > Virtual Directory from the dropdown menu.
  5. In the New Virtual Directory wizard, type Jakarta in the Alias box and click Next.
  6. Navigate to <drive>:\jakarta\tomcat-3.2\bin\iis\i386 and click Next.
  7. Check the Execute box on the Access Permissions dialog box, click Next, and click Finish.
  8. Right-click the Default Web Site and select Properties.
  9. Select the ISAPI Filters tab and click Add. Type Jakarta for the filter name.
  10. For the Executable, navigate to <drive>:\jakarta-tomcat-3.2\bin\iis\i386\isapi_redirect.dll and select OK. Click OK to close the Properties window.
  11. Stop and Start IIS.
Open IIS Manager:
  • For IIS 4.0:
    • Click Start > Programs > Windows NT Option Pack > Microsoft Internet Information Server > Internet Service Manager.
  • For IIS 5.0:
    • Click Start > Settings > Control Panel > Administrative Tools > Internet Services Manager.
  1. Highlight Default Web Site under your localhost name:
    1. In the toolbar, click the Stop button (square icon).
    2. Click the Start button (arrow icon).
  2. Right-click the Default Web Site and select Properties.
  3. Switch to the ISAPI Filters tab and make sure there is a green arrow next to the Jakarta filter.
Note:
If there isn't a green arrow next to the Jakarta filter, go back and check the Registry Editor entries.
Execute the startup file
  1. Open a Command Prompt window:
    • Windows 2000:
      • Click Start > Programs > Accessories > Command Prompt.
    • Windows NT:
      • Click Start > Programs > Command Prompt.
  2. Change the directory to <drive>:\jakarta-tomcat-3.2\bin.
  3. Type <drive>:\ and press Enter.
  4. Type the following:
    cd jakarta\-tomcat-3.2\bin
  5. Execute startup.bat

Related Information