Bug: Cannot create some services in ArcIMS Administrator if using Tomcat 5.0.28


While creating map services in ArcIMS Administrator, some ArcMap services are created correctly, others fail, or ArcMap services cannot be created at all if using Tomcat 5.0.28 or 5.0.27 as the servlet engine in combination with Microsoft IIS as the Web server. This configuration may cause AXLParser errors when attempting to create a feature or image service.


This is a known issue. Services cannot be created with Tomcat 5.0.2x if it was configured with the ISAPI file isapi_redirector2.dll


Configure Tomcat 5.0.2x with the newest available redirector file 'isapi_redirect.dll' Following the steps below.

  1. Download the updated configuration files for Tomcat 5.0.28: Tomcat5028_IIS_IMS91_win.zip
    Extract the downloaded .zip file to a location on the hard drive.
    Download the latest versions of these files at the Apache download site. See the link in the Related Information section below.
  2. Copy the isapi_redirect.dll to the \bin\win32 directory in the Tomcat installation location, for example; C:\Tomcat5028\bin\win32
    The permissions for the file may not be updated automatically. Verify that the user account IUSR_<machinename>, Network Service and Authenticated Users are listed in the file properties' security tab, and have at least Read&Execute permissions
  3. Copy the files 'workers.properties.minimal' and 'uriworkermap.properties' from the temporary location to: <drive>:\Tomcat5028\conf
    Rename any existing files of the same name before overwriting them
    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.

    The registry files extracted from the downloaded .zip file are intended to work with a default installation of Tomcat 5.0.28 in C:\Tomcat5028. If the drives or the installation directory was changed, open the according file in Notepad, and make the appropriate changes to reflect the current environment.
    1. Double-click the registry file Win200x_XP_IMS91_Tomcat5028.reg in the location where it was extracted to execute it.
    2. Click Yes, then OK. This should create the necessary registry keys for Tomcat.
  5. Launch the Internet Information Services Manager.

    UPDATE ISAPI filter

    1. Expand the web site.
    2. Right-click the Default Web site, or the site configured for ArcIMS, and select Properties.
    3. Select the ISAPI Filters tab.
    4. Click Remove for the existing Jakarta filter.
    5. Click Add to add a new filter and call it Jakarta.
    6. Browse to the file C:\Tomcat5028\bin\win32\isapi_redirect.dll
    7. Click OK.


    1. In IIS Manager, on the left panel of the window, navigate to Default Website > Jakarta.
    2. Right-click on the isapi_redirect.dll in the right hand panel, and select properties.
    3. Set the security options:
      1. Select the File Security tab.
      2. Click Edit for Anonymous Access and Authentication Control.
      3. Uncheck Integrated Windows Authentication.
      4. Click OK.
      5. Click OK again.
      6. Close Internet Services Manager
      WINDOWS 2003:
    4. In the menu click on Web Services Extensions.
    5. Highlight Jakarta and click the Properties link. On the Files tab, add the isapi_redirect.dll
    6. Click OK and close IIS.
  6. For the changes to take effect, go to the Windows Services panel and restart:
    • Apache Tomcat
    • IIS Admin
    • World Wide Web Publishing service
  7. Verify that the Tomcat configuration was successful.
    1. Open the Windows Services panel. Select the Apache Tomcat service from the list and start it, if not already started.
    2. Enter this case-sensitive URL into a browser:
      A page should display that says 'Hello World' if the test is successful.
      If this test fails, check the URL carefully for case or spelling issues. Retrace the installation steps. It may be that the URL works if 'http://<hostname>:8080/...' is specified. This only indicates that the Tomcat Web server is working on port 8080; the required redirect to IIS is failing.
    3. Return to the IIS Management Console > Default Web Site > Properties and check the ISAPI Filters tab. Verify that there is a green, upward arrow next to the Jakarta filter.
      If there is not a green arrow next to Jakarta filter, stop and re-start the 'IIS Admin Service', including the WWW Publishing Service, from the Services panel. If that does not work, open a browser and type http://localhost to re-initialize IIS. If the Jakarta filter still fails, do not proceed further. Go back and verify the settings created in the previous steps.
    4. Return to the IIS Management Console > Default Web Site > Jakarta. Verify that the Jakarta virtual directory is set to point to the correct location on the hard drive. It needs to be the location of the isapi_redirect.dll.
  8. Logging back into ArcIMS Administrator should now be possible. Create the ArcMap or image services again.

    Contact Esri Technical Support with any further issues.

Related Information