English

How To: Configure ServletExec 4.2 for Apache with ArcIMS

Summary

After installing ArcIMS, it is necessary to configure the Web server for ArcIMS. If the Web server and servlet engine are not operational, contact the system administrator before proceeding. Also, contact New Atlanta for specific versions of Apache supported for ServletExec 4.2 and any problems encountered with ServletExec.

Procedure

  1. Stop the Apache and ServletExec services.

  2. Copy the following from <ArcIMS Installation Directory>/ArcIMS/Middleware/servlet_connector to <ServletExec Installation Directory>/NewAtlanta/ServletExecAS/se-<instance-name>/Servlets:

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

  3. Open the Esrimap_prop file in a text editor.

  4. Change the value of appServerMachine to the name of your Application Server computer. For example:

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

  5. Save and close the file.

  6. After installing ArcIMS, one must create virtual directories to map the location on the Web server to a physical path, for both output and website.

    Open the file <Apache Installation Directory>/conf/httpd.conf in a text editor.

  7. 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>

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

    Code:
    DirectoryIndex index.html default.htm

    Save and close the file.

  9. To provide Web users with the ArcIMS files that are necessary to view the Java Web pages, copy the /install directory from your install directory to your website directory. For example:

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

    For more information, see the Installing ArcIMS Viewer topic in the ArcIMS Install Guide.

  10. Start the Apache and ServletExec services.

  11. Open <ArcIMS Installation Directory>/ArcIMS/Xenv/ArcIMS_Diagnostics/ArcIMS_Diagnostics.html in Netscape. The ArcIMS Diagnostics tool displays.

  12. Select the Web server protocol, type the Web server name including domain, and type in its port number. The default is 80.

  13. Click 1 to test the ArcIMS Servlet Connector.
    If this test is successful, the ArcIMS Servlet Connector is configured correctly.
    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