English

How To: Configure Tomcat 4.0.5 (or 4.1.12) for Apache 2.0.42 for ArcIMS

Summary

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

Note:
If the Post Installation has been performed, ensure that all the edits specified below have been made.

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

Procedure

  1. Edit the '$CATALINA_HOME/conf/mod_jk.conf' file. Open the 'mod_jk.conf'file in a text editor and add the 'JkMount' settings below under the 'VirtualHost' session:

    <VirtualHost Your_server_name>
    ServerName Your_server_name
    ��

    Code:
    JkMount /servlet/* ajp13

    ��
    </VirtualHost>
  2. Copy the Servlet Connector files below from '<ArcIMS Installation Directory>/ArcIMS/Middleware/servlet_connector' to '$CATALINA_HOME/webapps/ROOT/WEB-INF/classes.'

    - com directory
    - Esrimap_prop
    - ServletConnector_Res.properties
    - ServletConnector_Res_en_US.properties
    - WMSEsrimap_prop

    Note:
    A 'classes' directory may need to be created.

  3. Open the 'Esrimap_prop' file in a text editor and change the value of the 'appServerMachine' to the name of the computer on which the ArcIMS Application Server is running. For example:

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

    Save and close the file.

    Note:
    Make sure to edit the Esrimap_prop file that resides in the $CATALINA_HOME/webapps/ROOT/WEB-INF/classes directory.

  4. Edit the Apache configuration file. Open the '<Apache Installation Directory>/conf/httpd.conf' file in a text editor. In the 'Alias' section, add the code below for your Web site and server output virtual directories:

    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>

  5. For the Web pages designed with ArcIMS Designer to start automatically, verify that the 'httpd.conf' file's 'DirectoryIndex' line includes 'default.htm.' For example:

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

    Save and close the httpd.conf file.

  6. To allow Web users to access the ArcIMS files necessary to view the Java Web pages, it is necessary to copy the '\install' directory from the ArcIMS installation directory to the Web site directory. For example:

    Code:
    cp -r <ArcIMS Installation Directory>/ArcIMS/ViewerDownLoad/install <Path to Website directory>

    For more information, refer to the ArcIMS Install Guide, "Installing ArcIMS Viewer".
  7. Stop the Tomcat and Apache services.

    To stop Tomcat:

    Code:
    $CATALINA_HOME/bin/shutdown.sh

    To stop Apache:

    Code:
    <Apache Installation Directory>/bin/apachectl stop

  8. Start the Apache and Tomcat services.

    To start Apache:

    Code:
    <Apache Installation Directory>/bin/apachectl start

    To start Tomcat:

    Code:
    $CATALINA_HOME/bin/startup.sh

  9. Test the ArcIMS Servlet Connector. Open '<ArcIMS Installation Directory>/ArcIMS/Xenv/ArcIMS_Diagnostics/ArcIMS_Diagnostics.html' in Netscape. The ArcIMS Diagnostics tool displays.

    Select the Web server protocol, type the Web server name including the domain, and type the port number. The default is 80. Click 1 to test the ArcIMS Servlet Connector. If this test is successful, the ArcIMS Servlet Connector is configured correctly.

    If an error message is generated, select the error number in the drop-down list and click View. The error number and a description display. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.

    See Install documentation, Step 5: "Configure ArcIMS for instructions on running ArcIMS".

Related Information