English

How To: Install Apache 2.0.48 with Tomcat 5.0.27 with mod_jk2 using J2SDK 1.4.2 for ArcIMS 9.0 on Windows

Summary

Instructions provided are for the installation and configuration of Apache 2.0.48 with Tomcat 5.0.27 using J2SDK 1.4.2 for ArcIMS 9.0 on Windows.

For specific information for the installation of ArcIMS, see the product's Install Guide.

This installation will require the following:

Note:
A user account that has Administrator rights on the ArcIMS machine is required.

Before Beginning: 

  • Familiarity with certain Windows tasks is required to install and configure ArcIMS. For details, see 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 assist in planning the ArcIMS site configuration. To open the ArcIMS Installation Guide, launch the DVD menu and click 'ArcIMS Installation Guide'.

Procedure

ArcIMS 3.1, 4.0 or 4.0.1 must be uninstalled to install ArcIMS 9.0. The setup program for ArcIMS 9.0 on Windows will prompt for the removal of previously installed versions.

If ArcIMS components were distributed among several computers, it is recommended the uninstall program be manually run on each computer.

Warning:   
A supported Web server and Servlet Engine must be properly installed and configured before running the setup program for ArcIMS 9.0.
  1. Uninstall any unsupported versions of JDK/JRE, Web server and Servlet Engine.
    For more information, refer to Uninstall ArcIMS-related third-party software on Windows.
  2. Install Java 2 SDK 1.4.2
    1. Click J2SDK 1.4.2 to download Sun Java 2 SDK, Standard Edition, version 1.4.2.
    2. Click 'Download' in the SDK column for the Windows version.
    3. Accept the license agreement.
    4. Click on Windows Offline Installation, the first option, to download j2sdk-1_4_2-windows-i586.exe.
    5. Run the program after it has finished downloading.
    6. Accept all of the installation program defaults, unless changes are required.
  3. Install Apache 2.0.48
    1. Click Apache Web server version 2.0.48 and download the file 'apache_2.0.48-win32-x86-no_ssl.msi'.
    2. Navigate to the folder where the file was downloaded and double-click it to run the installation.
    3. At the 'Welcome' screen, click Next.
    4. At the License Agreement screen, read and accept the terms of the license agreement. Click Next.
    5. At the 'Read This First' screen, click Next.
    6. At the 'Server Information' screen, type in the Network Domain, Server Name or computer name and the e-mail address of the administrator.
    7. Select 'for All Users, on Port 80, as a service - Recommended'. Click Next.
    8. At the Setup Type screen, select Typical and click Next.
    9. At the Destination Folder screen, click Change to specify the installation location. For example, <drive>:\Apache. Click Next.
    10. At the 'Ready to Install' screen, click Install.
    11. At the 'Installation Completed' screen, click Finish.
    12. Modify the httpd.conf file. Click Start > Programs > Apache HTTP Server 2.0.48 > Configure Apache Server > Edit the Apache httpd.conf Configuration File.
    13. Locate the line 'DirectoryIndex index.html' and add 'default.htm' and 'default.html' at the end so it reads:
      DirectoryIndex index.html index.html.var default.htm default.html
      
    14. Save the file and close the window.
    15. Verify that the installation was successful. Open a Web browser and type the computer or domain name. For example, http://machinename.

      The Apache page: "Seeing this instead of the website you expected?" should display.

      If the page does not display, check that Apache is running.
    16. Open the Services window.
    17. A service named Apache2 should be listed as started. If it isn’t, start it by clicking the triangle in the toolbar. Verify that the Apache installation is successful.
      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 5.0.27
    1. Download and install Tomcat 5.0.27 using the following link: Apache Tomcat 5.0.27 Download Site
    2. Click on 'jakarta-tomcat-5.0.27.exe' to download the file and save it on the local machine.
    3. Navigate to the folder where the file was downloaded and double-click 'jakarta-tomcat-5.0.27.exe'.
    4. Click Next to continue.
    5. Read the License Agreement and click 'I Agree'.
    6. At the 'Choose Components' dialog click on the '+' to expand 'Tomcat', then check 'Service' to be installed. Leave the other options as the default.
    7. Click Next.
    8. Type <drive>:\Tomcat5027 for the installation directory and click Next.
      Warning:   
      Do not install Tomcat under Program Files, or other paths containing spaces, or problems may occur.
    9. Use the default settings at the Configuration dialog. Enter a password for the Tomcat Administrator. No Windows login is required. Click 'Next'.
    10. Click 'OK' to confirm the path of the JVM installed on the machine. It should be the location of the Java Runtime Environment: for example, C:\Program Files\Java\j2re1.4.2
      Note:
      If it does not default to a path, cancel the Tomcat installation and verify a valid Java 2 SDK is installed.
      
    11. Click Install to continue, then click Finish at completion.
    12. Navigate to the Environment Variables.
    13. Click 'New' Under System Variables. When prompted for Variable Name, type JAVA_HOME
      Note:
      This is case sensitive.
      

      When prompted for Variable value, type the path where Java 2 SDK is installed; for example, <drive>:\j2sdk1.4.2, and click OK.
    14. Create another system environment variable called CATALINA_HOME
      Note:
      This is case sensitive.
      
      When prompted for Variable value, type the path where Jakarta Tomcat 5.0.27 is installed; for example: <drive>:\Tomcat5027, and click OK.
    15. Scroll to Path, while in in the System Variables panel, select it, and click Edit. In the Variable Value text box, append the following to the end of the text, including the semi-colon:
      ;%JAVA_HOME%\bin
      Note:
      Verify that old references to JAVA_HOME; for example, <drive>\jdk1.3.1 or similar, in the path variable have been removed.
      
    16. Click 'OK' twice to close the Properties window.
      Note:
      Click Here for additional resources on installing the Tomcat Servlet Engine.
      
  5. Configure Apache 2.0.48 with Tomcat 5.0.27.
    1. Click on the following link to download the Mod_JK2 configuration files for Apache and Tomcat: Tomcat5027_Apache2048_IMS9_win.zip
    2. Extract the contents of the zip file to a temporary location on your hard drive.
    3. Copy the mod_jk2.so file to your Apache Modules directory. For example: <drive>:\apache\apache2\modules
    4. Copy the workers2.properties file to your Apache Conf directory. For example: <drive>:\Apache\Apache2\conf
    5. Modify the httpd.conf file. Click Start > Programs > Apache HTTP Server 2.0.48 > Configure Apache Server > Edit the Apache httpd.conf Configuration File.
    6. Locate the line: #LoadModule ssl_module modules/mod_ssl.so and add the following line of code directly below it so it reads:
      #LoadModule ssl_module modules/mod_ssl.so
      LoadModule jk2_module modules/mod_jk2.so
      
    7. Save and close the file.

      UPDATE REGISTRY
    8. Double-click the extracted Win200x_XP_IMS90_Tomcat5027.reg file to add the necessary information to the registry.
      Note:
      If Tomcat was installed to a location other then C:\Tomcat5027, please first edit the registry file in Notepad with the different path.
      
    9. Click Yes to confirm.

      RESTART SERVICES
    10. Open the Services window.
    11. Start and stop the services in the following order:
      1. Stop Apache2
      2. Stop Apache Tomcat
      3. Start Apache Tomcat
      4. Start Apache2
  6. Verify that the Tomcat installation was successful.
     
    Enter the following into a Web browser. Note: This is case sensitive.
    http://<your_machine_name>/servlets-examples/servlet/HelloWorldExample
    
    A page should display that says "Hello World" if the test is successful.
    Warning:   
    Apache must run on the default port 80. If not, append the port number after the machine name in the URL. If the above test fails, recheck the installation steps for Apache and Tomcat. It may be that the URL works if users specify 'port 8080'. This only indicates that Tomcat is working. Do not proceed to install ArcIMS until this is working.
  7. Install ArcIMS 9.0 from the installation CD. Refer to the ArcIMS Installation Guide for more information.
  8. Install any Service Packs available for ArcIMS 9.0 before continuing. They are available for download at the
    ArcIMS Patches and Service Packs Website
  9. To configure ArcIMS 9.0, run the ArcIMS Post Installation. Refer to the ArcIMS 9.0 Installation Guide, Step 3b.
    1. Select the Typical Post Installation Option.
    2. At the Web Server-Servlet Engine Configuration dialog box, select 'I will manually configure my Web server /servlet engine'. Click Next.
    3. Finish the Post Installation.
  10. Configure the ArcIMS Servlet Connector for Tomcat 5.0.27
    1. Stop the Apache and Tomcat services from the Windows services Panel.
    2. Navigate to <ArcIMS Installation location>\ArcIMS\Connectors\Servlet and copy the file arcimsservletconnector.war file to the <drive>:\Tomcat5027\webapps directory.
    3. In the <drive>:\Tomcat5027\webapps directory rename the arcimsservletconnector.war to servlet.war
    4. Start the Tomcat service again. The servlet.war file will automatically expand to a folder with the same name.
    5. Go to the expanded <drive>:\Tomcat5027\webapps\servlet\WEB-INF\classes directory.
    6. In a text editor, open the file Esrimap_prop.
    7. Change the AppServerMachine variable "APPSMACHINE" to the name or IP address of the machine where ArcIMS Application Server is installed. Change the AppServerClientPort if you are using a non-default client port.
      Note:
      Similar steps are necessary to deploy the ArcIMS Service Administrator (esriadmin.war), Metadata Explorer (metadataexplorer.war and the WMS Connector (wmsconnector.war). Please see the Installation Guide and ArcIMS Help for more information.
      
    8. Save and close the Esrimap_prop file.

      CREATE VIRTUAL DIRECTORIES
    9. In a text editor (such as Notepad), open <ArcIMS Installation Directory>\ArcIMS\Common\ApacheAlias.txt and copy the contents of the file. Close the file.
    10. In a text editor (such as Notepad), open <Drive>:\Apache\Apache2\conf\httpd.conf. Under the line:

      Alias /icons/ "<Apache Installation Directory/Apache2/icons/"

      Paste the lines from the ApacheAlias.txt file.
      Note:
      Replace the paths in these lines with the appropriate paths where necessary.
      
    11. Save and close the file.
  11. Verify that the ArcIMS installation was successful.
    1. Click Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics. The ArcIMS Diagnostics page displays.
    2. Verify the Web server protocol and Web server name are correct, including the domain and port number. The default is port 80.
    3. Test both components. The result for test 1 should be:

      IMS v9.0.0
      Build_Number=871.1714
      Version=9.0.0
      Test successful

      The result for test 2 should be:

      Version=9.0
      Build_Number=871.1957
      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 in 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 try the Diagnostics tool again.