How To: Configure Tomcat 4.0.5 (or 4.1.12) for Apache 2.0.42 for ArcIMS
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.
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:
Note: A 'classes' directory may need to be created.
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.
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>
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:
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".
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".