English

How To: Install Apache 2.2.4 with Tomcat 6.0.13 with mod_jk using J2SDK 5.0 Update 13 for ArcIMS 9.3 on Windows 2003/2000/XP (32-bit binaries)

Summary

Instructions provided describe the installation and configuration of Apache 2.2.4 with Tomcat 6.0.13 with mod_jk using J2SE Development Kit 5.0 Update 13 for ArcIMS 9.3 on Windows.

Specific information for the installation of ArcIMS is included with the product's Install Guide.

This installation requires the following software:
· J2SE Development Kit (JDK) 5.0 Update 13
· Apache Web Server version 2.2.4
· Tomcat 6.0.13
· ArcIMS 9.3 Installation DVD
 

Note:
A user account that has Administrator rights on the ArcIMS machine is required.
 
· Familiarity with certain Windows tasks is required to install and configure ArcIMS. For details, see the following ESRI Knowledge Base article, Common Windows tasks when installing ArcIMS.

· For more information on the acronyms and terms used in this document, see the Glossary of terms used in ArcIMS Installation articles.

· Review and follow steps 1 and 2 from the ArcIMS Installation Guide on the DVD. These two steps ensure that the system meets the minimum requirements and assists in planning the ArcIMS site configuration. To open the ArcIMS Installation Guide, navigate to the DVD in Windows and double-click on Install.htm.

Procedure

Previous versions of ArcIMS must be removed before installing ArcIMS 9.3. The setup program for ArcIMS on Windows prompts for the removal of previously installed versions.

If previous ArcIMS components were distributed among several computers, it is recommended to first remove the components on each computer in the Control Panels Add/Remove Programs.

Warning:
A supported Web Server and Servlet Engine must be properly installed and configured before running the setup program for ArcIMS.
  1. Uninstall any unsupported versions of Java, Web Server, and Servlet Engine. For more information, refer to the following Knowledge Base article, How To: Uninstall ArcIMS-related third-party software on Windows.
     
  2. Install Java 2 Standard Edition Development Kit version 5.0 Update 13.
     
    A. Click J2SE Development Kit (JDK) 5.0 Update 13
    to download Sun Java 2 SDK, Standard Edition, version 5.0 Update 13.

    B. Click 'Download JDK'.

    C. Accept the license agreement.

    D. Click on the download link for the Windows Offline Installation Multi-Language. The file jdk-1_5_0_13-windows-i586-p.exe is downloaded.

    E. Run the installer after it has finished downloading.

    F. Accept all of the default installation options, unless changes are required. This installs both the Java Runtime and Development Kit.

    G. After the install, Navigate to Start > Settings > Control Panel > Java.

    H. Click the 'Update' tab and remove the check mark for 'Check for Updates Automatically'.

    I. Click Apply and close the Java Control Panel.
  3. Install Apache 2.2.4.
    Warning:
    Prior to installing Apache Web server, be sure to either uninstall IIS Web server or change the port of its Default Web site from port 80 to an unreserved port (e.g., port 81). When changing the IIS port number, be sure to restart the IIS Web server for the change to take effect. Failure to take any of these actions results in a failed Apache Web server install.

    A. Click Apache Web Server version 2.2.4 and download the file apache_2.2.4-win32-x86-no_ssl.msi.

    B. Navigate to the folder where the file was downloaded and double-click it to run the installation.

    C. At the Welcome screen, click Next.

    D. At the License Agreement screen, read and accept the terms of the license agreement. Click Next.

    E. At the Read This First screen, click Next.

    F. At the Server Information screen, type in the network domain, server name or computer name, and the e-mail address of the administrator.

    G. Select 'for All Users, on Port 80, as a Service -- Recommended'. Click Next.

    H. At the Setup Type screen, select Typical and click Next.

    I. At the Destination Folder screen, accept the default installation location or click Change to specify a different location. Click Next.

    J. At the Ready to Install the Program screen, click Install.

    K. At the Installation Wizard Completed screen, click Finish.

    L. Modify the httpd.conf file. Click Start > Programs > Apache HTTP Server 2.2.4 > Configure Apache Server > Edit the Apache httpd.conf Configuration File.

    M. Locate the line 'DirectoryIndex index.html' and add 'default.htm' and 'default.html' at the end so it reads:
    DirectoryIndex index.html default.htm default.html

    N. Save the file and close the window.

    O. Verify that the installation was successful. Open a Web browser and type http://machinename (replace with your server's machinename).

    The Apache page: 'It Works!' should display. If so, proceed to step 4.

    If the page does not display, proceed to the next step (step P) to ensure that the Apache Web server is running.

    P. Open the Windows Services panel.

    Q. A service named Apache2 should be listed as started. If not, select the Apache2 service and start it by clicking the 'Start Service' triangle in the toolbar.
    Note:
    If the default Apache page still does not display, an error was made during one of the installation steps. Repeat the installation, or check the Apache Documentation. Additional resources on installing the Apache Web Server can be found here.
  4. Install Tomcat 6.0.13.
    INSTALL TOMCAT

    A. Click here to access the Apache Tomcat 6.0.13 Download site.

    B. Click on apache-tomcat-6.0.13.exe to download the file. Save it on the local machine.

    C. Navigate to the folder where the file was downloaded and double-click apache-tomcat-6.0.13.exe.

    D. Click Next to continue.

    E. Read the License Agreement and click 'I Agree'.

    F. At the Choose Components dialog box, change the type to 'Full' install. Alternatively, add at least the features Service and Examples to the selection.

    G. Click Next.

    H. Select the preferred installation location; for example, the default C:\Program Files\Apache Software Foundation\Tomcat 6.0 or C:\Tomcat6.0.

    I. Use the default settings in the Configuration dialog box. Create a new password for the Tomcat Administrator. Click Next.

    J. The path of the JVM installed on the machine should be the location of the Java Standard Development Kit; for example, C:\Program Files\Java\jdk1.5.0_13.
    Browse to this path if it is not set automatically and click OK.
    Warning:
    If a path to an older SDK version is listed, cancel the Tomcat installation. Make sure that a Java SDK is installed and the environment variables JAVA_HOME and PATH do not include any old entries regarding the Java Runtime Environment or are pointing to the J2SDK location correctly.

    K. Click Install to continue. Click Finish.

    SETUP OF ENVIRONMENT VARIABLES:

    L. Right-click on My Computer and click Properties. Click the Advanced tab. Click on the Environment Variables button.

    M. Under System Variables, click New. When prompted for Variable Name, type JAVA_HOME (case sensitive). For the Variable value, type the path where Java 2 SDK is installed; for example, C:\Program Files\Java\jdk1.5.0_13. Click OK.

    N. In the System variables list, scroll to the 'Path' variable, select it, and click Edit. In the Variable Value text box, append the following to the end of the text, including the semi-colon to separate from previous entries:
    ;%JAVA_HOME%\bin.
    Note:
    Verify that old references to JAVA_HOME in the path variable have been removed; for example, <drive:>\jdk1.3.1 or similar.

    O. Click OK twice to close the Properties window.

    For additional resources on installing Tomcat, click here.
  5. Configure Tomcat with Apache Web Server.
     
    A. Click here to download the 'mod_jk-1.2.26-httpd-2.2.4.so' file.
     
    - Save the 'mod_jk-1.2.26-httpd-2.2.4.so' as 'mod_jk.so' in the Modules folder of the Apache installation directory; for example, :\Program Files\Apache Software Foundation\Apache2.2\Modules.

    B. Click here to download the 'modjk_workers_Tomcat6013_IMS93.zip' file.

    C. Extract the workers.properties file from the .zip file to the Apache Conf directory. For example: <drive>:\ Program Files\Apache Software Foundation\Apache2.2\conf.

    D. Modify the httpd.conf file. Click Start > Programs > Apache HTTP Server 2.2.4 > Configure Apache Server > Edit the Apache httpd.conf Configuration File.

    E. Locate the following line: #LoadModule ssl_module modules/mod_ssl.so. Add the following line of code directly below it so it reads:
    #LoadModule ssl_module modules/mod_ssl.so
    LoadModule jk_module modules/mod_jk.so

    F. Scroll to the end of the file and add the following below the last line of the file. Edit the path to reflect your environment.

    JkWorkersFile "<drive>:\Program Files\Apache Software Foundation\Apache2.2\conf\workers.properties"
    JkLogFile "<drive>:\Program Files\Apache Software Foundation\Apache2.2\logs\mod_jk.log"
    JkLogLevel info

    JkMount /examples ajp13
    JkMount /examples/* ajp13

    G. Save and close the httpd.conf file.
    1. Verify that Apache Web Server and Tomcat Servlet Engine were installed successfully.

      Test the connectivity between the Apache and Tomcat.
      1. Restart Services
        1. Open the Services window
        2. Start and stop the services in the following order:
          1. Stop Apache2
          2. Stop Apache Tomcat
          3. Start Apache Tomcat
          4. Start Apache2
      2. Enter the following into a Web browser:
        Note: This is case sensitive.
      http://<mymachinename>/examples/servlets/servlet/HelloWorldExample

      A page should display that says 'Hello World' if the test is successful.
      Warning:
      If this test fails, first check the URL carefully for case or spelling issues, then retrace the installation steps. Do not proceed to install ArcIMS.
      Note:
      It may be that the URL works if 'http://localhost:8080/...' is specified. This indicates that while the Tomcat Web Server is working on port 8080, the required redirect from the Apache Web Server is failing. Retrace the installation steps. Do not proceed to install ArcIMS.
  6. Install ArcIMS 9.3 from the installation DVD.
  7. Perform the ArcIMS Post Installation.
     
    A. Select Typical as the Post Installation Option.

    B. Accept the default directories and options.

    C. When the Web Server-Servlet Engine Configuration is reached, select Apache 2.2.x with Tomcat 6.0.x. Click Next.

    D. For the Web Server directory, enter the path where Apache 2.2.4 is installed; for example: <Drive>:\Program Files\Apache software Foundation\Apache2.2.

    E. For Servlet Engine directory, enter the path where Tomcat 6.0 is installed; for example, <Drive>:\Program Files\Apache Software Foundation\Tomcat 6.0.

    F. If asked, permit the Post Installation to restart the ArcIMS services.

    G. Restart the Web Server and Servlet Engine, from the Windows Services panel, once the Post Installation has finished.
  8. Verify that the ArcIMS installation was successful.
    For ArcIMS 9.3:
     
    A. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.

    B. Verify that the Web server protocol and the Web server name are correct, including the domain and port number. The default is port 80.
    Note:
    On Windows XP/2003 machines, Internet Explorer sometimes does not show the host name and port number. If this is the case, right-click near the top of the window, under the address bar, and select 'Allow Blocked Content'.

    C. Test both components.

    The result for Test 1 should be:

    IMS v9.3.0
    Build_Number=503.1916
    Version=9.3.0
    Test successful

    The result for Test 2 should be:

    Version=9.3.0
    Build_Number=503.2159
    Test successful
    Note:
    If these tests are successful, the ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly. If an error message is received, select the error number from the drop-down list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and run the Diagnostics tool again.
  9. For additional steps for configuring ArcIMS, refer to the ArcIMS Installation Guide.

    For setting up the ArcIMS Web ADF for the Java Platform or for the Microsoft .NET Framework, reference the appropriate Installation Guide.

Related Information