English

How To: Configure Tomcat 4.1.29 for Apache 2.0.48 for ArcIMS

Summary

After installing ArcIMS, it is necessary to configure the Apache Web Server and Tomcat for ArcIMS if the ArcIMS Web Server Configuration has not been performed.

Note:
If the ArcIMS Web Server Configuration has been performed, ensure that all edits specified below have been made.

These instructions assume that Apache and Tomcat are already running properly. If the Web server and servlet engine are not operational, contact your system administrator before proceeding. See Related Information for information on problems with Apache and Tomcat.

Procedure

  1. Stop the Apache and Tomcat services.
  2. Copy the arcimsservletconnector.war file from $AIMSHOME/Middleware/servlet_connector/arcimsservletconnector.war to the $CATALINA_HOME/webapps directory.

    Start and stop the Apache and Tomcat Services.

    Navigate to the $CATALINA_HOME/webapps directory and rename the arcimsservletconnector directory to servlet.

    Code:
    cd $CATALINA_HOME/webapps
    mv arcimsservletconnector servlet

  3. Navigate to the $CATALINA_HOME/webapps/servlet/WEB-INF/classes directory and open the Esrimap_prop file in a text editor. Change the value of appServerMachine to the name of your Application Server computer. For example:

    Code:
    appServerMachine=<server name>.esri.com

    Save and close the file.
  4. Navigate to $APACHE_HOME/conf and open the workers2.properties file. Add the following lines of code to the end of the file.

    Code:
    [uri:/servlet/*]
    info=ArcIMS servlet connector

    Save and close the file.

  5. Create the virtual directories to map the location on the Web server to a physical path, for both output and Web site.

    Open the file $APACHE_HOME/conf/httpd.conf in a text editor.

    In the Alias section, add the following for Web site and server output:

    Code:
    Alias /output/ "<Path to output directory>/output/"
    <Directory "<Path to output directory>/output">
    Options Indexes Multiviews
    AllowOverride None
    Order allow,deny
    Allow from all
    </Directory>

    Alias /website/ "<Path to website directory>/website/"
    <Directory "<Path to website directory>/website">
    Options Indexes Multiviews
    AllowOverride None
    Order allow,deny
    Allow from all
    </Directory>

  6. For the Web pages designed in ArcIMS to start automatically, make sure your DirectoryIndex line includes default.htm. For example:

    Code:
    DirectoryIndex index.html index.html.var default.htm

    Save and close the httpd.conf file.
  7. Start the Apache and Tomcat Services.
  8. Verify that the ArcIMS Installation was successful using the ArcIMS Diagnostics test.

    Open $AIMSHOME/Xenv/ArcIMS_Diagnostics/ArcIMS_Diagnostics.html in Netscape. The ArcIMS Diagnostics tool displays.

    Select the Web server protocol, type the Web server name including domain, enter the port number. The default is 80.

    Click 1 to test the ArcIMS Servlet Connector. The result for Test 1 should be:

    IMS v9.0.0
    Build_Number=804.1646
    Version=9.0.0
    Test successful

    If an error is received, select the error number in the dropdown list and click View. The error number and a description will be displayed. Follow the instructions in the description to fix the problem, and try the Diagnostics tool again.

Related Information