HOW TO
Instructions provided describe the installation and configuration of Apache 2.0.48 with Tomcat 4.1.XX using J2SDK 1.4.2_06 for ArcIMS on Solaris/Linux/AIX/HP-UX.
Specific installation information for ArcIMS is provided in the ArcIMS Install Guide.
This installation requires the following software:
· Java 2 SDK, Standard Edition, version 1.4.2_06
· Apache Web Server 2.0.48
· Jakarta-Tomcat Servlet Engine version 4.1.XX
· ArcIMS Installation CD
Note: HP-UX has a package available for download that includes Tomcat, Apache and the mod_jk connector. If using the HP-UX Web Server Suite, then only the 'Configure Apache and Tomcat' step is necessary.
Note: Verify that GCC Compiler version 2.95.3 or higher is present on the system.
Note: Root privileges are required to install Perl, GNU GCC, and Make compiler packages.
Note: In the steps below, it is assumed that Apache 2.0.48 is used. If a different version was downloaded, replace the file name where mentioned.
Warning: Root permissions are assumed when following this document. The default HTTP port of 80 requires root privileges, and the Apache install location of /usr/local/apache also requires root privileges. If the 'root' account is not being used, then certain steps fail.A. Click 'httpd-2.0.48.tar.gz' to download the Apache Web Server version 2.0.48.
gunzip httpd-2.0.48.tar.gzC. An archive file is created named 'httpd-2.0.48.tar.' To untar this archive, type:
tar -xvf httpd-2.0.48.tar
Note: The source code for the Apache Web server should be extracted into a directory named 'httpd-2.0.48' in the $TEMP location.D. Navigate to the $TEMP/httpd-2.0.48. Decide on a location to install the Apache Web server, for example, /usr/local/apache.
./configure --prefix=/usr/local/apache --enable-module=soF. Type:
makeG. Type:
make install
Note: The directory '/usr/local/apache' is now created.H. Set the environment variable 'APACHE_HOME' to the new installation location for Apache. For example, '/usr/local/apache' was used in this article. If using bash, ksh, or sh type:
export APACHE_HOME=/usr/local/apacheIf using csh, we would type:
setenv APACHE_HOME /usr/local/apacheThis setting may then be checked by typing:
echo $APACHE_HOME
Warning: It is highly recommended that this environment variable be added to root's initialization file: .cshrc, .bashrc, or .profile. The steps necesssary depend on the OS and shell settings being used. The initialization file needs to be sourced after the edits, for them to take effect. If this is not done, the APACHE_HOME variable must be set manually before starting and stopping Apache.I. Setup a default Web page for Apache, by copying the '$APACHE_HOME/htdocs/index.html.en' file to '$APACHE_HOME/htdocs/index.html'. Type:
cd $APACHE_HOME/htdocs cp index.html.en index.htmlJ. Open the '$APACHE_HOME/conf/httpd.conf' file in a text editor and change the values for ServerName and Listen (Port) to reflect the system environment. For example, a system with a DNS name of 'gis.esri.com' using the default port of '80' would have:
ServerName gis.esri.com Listen 80
Note: Root privileges are required to use a port below 1024. The # symbol must be removed from the beginning of a line in the 'httpd.conf' file for the contents of the line to be recognized.K. Start Apache by navigating to $APACHE_HOME/bin and typing:
cd $APACHE_HOME/bin ./apachectl startL. Open a browser and load the Web site root: http://<Servername>:<ServerPort>.
http://gis.esri.comIf the default page appears, continue to step M.
ps -ef | grep -i apache2. If the port number is not the default (80), make sure it is appended on the Web server URL (for example, http://www.website.com:2004 - where '2004' is the Web server port).
netstat –an | grep <ServerPort>4. Make sure the ServerName variable is correct; also, try commenting out the ServerName variable by placing a # in front of it.
#ServerName gis.esri.com5. Check the Apache Web server log files for additional information that are located in $APACHE_HOME/logs.
cd $APACHE_HOME/bin ./apachectl stop
Note: In the steps below, it is assumed that the 'jakarta-tomcat-4.1.30.tar.gz' file is downloaded. If a different file is downloaded, replace the file name in the examples below.B. Decide on a location to install the Tomcat Servlet Engine. For this example use, /usr/local/tomcat4.1.30.
gunzip jakarta-tomcat-4.1.30.tar.gzD. The file 'jakarta-tomcat-4.1.30.tar' is created. Untar this archive by typing:
tar -xvf jakarta-tomcat-4.1.30.tar
Note: The directory structure and files associated with the binary version of Tomcat are created in the 'jakarta-tomcat-4.1.30' directory. See notes mentioned in the Before Beginning section if problems occur.E. Move the directory to the location decided on earlier in step B. This example used '/usr/local/tomcat4.1.30'.
mv tomcat-4.1.30 /usr/local/tomcat4.1.30F. Open the .cshrc, .bashrc, or .profile file (whichever file is used to set environment variables for the current user session) and add two variables: JAVA_HOME and CATALINA_HOME.
cd $CATALINA_HOME/bin ./startup.shK. Open the homepage for the Tomcat server in a browser. The URL is http://<server_name>:8080. The Tomcat default homepage should be visible.
cd $CATALINA_HOME/bin ./shutdown.sh
Note: To use Apache with Tomcat, a 'mod_jk2.so' Tomcat connector is needed to enable communication between the two. This connector library may be downloaded from the Web. Links have been provided to the pre-compiled binary file and also to the source code.A. Click the following link to download the appropriate copy of Tomcat Connectors.
Note: HP-UX and AIX users need to follow the instructions found on the Apache Web site for compiling the mod_jk2 connector.
Note: Linux and Solaris users need to follow the instructions below after extracting the downloaded files.B. Rename the file to 'mod_jk2.so' if it is not already named that.
mv mod_jk2-2.0.43.so mod_jk2.soC. Copy the 'mod_jk2.so' file to the '$APACHE_HOME/modules' directory and make it executable.
cp mod_jk2.so $APACHE_HOME/modules cd $APACHE_HOME/modules chmod 755 mod_jk2.soD. Copy the 'workers2.properties' file in the '$APACHE_HOME/conf' directory.
LoadModule jk2_module modules/mod_jk2.soH. Save and close the file.
cd $APACHE_HOME/bin ./apachectl startH. Navigate to '$CATALINA_HOME/bin' and start the Tomcat servlet engine:
cd $CATALINA_HOME/bin ./startup.shI. Open a Web browser and navigate to the following URL:
http://<server_name>/examples/servlet/HelloWorldExampleIf a response containing "Hello World!" is returned, Apache and Tomcat are communicating as expected.
Note: At the end of the Post-installation, it is required to run the ArcIMS Web Server Configuration. This script must be run as 'root'. If Apache 2.0.xx with Tomcat 5.0.xx for ArcIMS is being configured manually, please refer to the ArcIMS Installation Guide step 4: Configure your Web server.
Get help from ArcGIS experts
Download the Esri Support App