English

How To: Install IBM HTTP Server 1.3.26 and Websphere 5.0 using Java 1.4.2_06 for ArcIMS 9.1 on Windows

Summary

Instructions provided are for the installation and configuration of IBM HTTP Server 1.3.26 with WebSphere 5.0 using J2SDK 1.4.2_06 for ArcIMS 9.1 on Windows.

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

WebSphere possesses its own native servlet engine and does not require other third-party servlet engines.
This installation will require the following software:

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, 4.0.1 or 9.0 must be uninstalled to install ArcIMS 9.1. The setup program for ArcIMS 9.1 on Windows prompts for the removal of previously installed versions.

If ArcIMS components are 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.1.
  1. Uninstall any unsupported versions of JDK/JRE, Webserver, and Servlet Engine. For more information, refer to the following technical article, How To: Uninstall ArcIMS-related third-party software on Windows.
  2. Install Java 2 SDK, v. 1.4.2_06.
    1. Click J2SDK 1.4.2_06 to download Sun Java 2 SDK, Standard Edition, version 1.4.2_06.
    2. Click 'Download J2SDK'.
    3. Accept the license agreement.
    4. Click on the download link for the Windows Offline Installation Multi-Language. The file j2sdk-1_4_2_06-windows-i586-p.exe is downloaded.
    5. Run the program after it has finished downloading.
    6. Accept all of the default installation options, unless changes are required.
  3. Install WebSphere 5.0.
    1. Launch the LaunchPad.bat file on the WebSphere installation CD.
    2. Select Install the product.
    3. Select English to launch the installation.
    4. Click 'I accept the terms of the license agreement' on the Software License Agreement dialog, then click 'Next'.
    5. Select Custom at the 'Choose the setup type' dialog. Click Next.
    6. Remove the checkmark in the checkbox for 'Embedded Messaging'. Click Next.
    7. Verify the installation directories or change them if desired. Click Next.
    8. Use the default Node Name and verify the host name. Click Next twice to start the installation.
      Note:
      WebSphere requires a few minutes to install.
      
    9. Uncheck the 'Register Now' checkbox when the installation has completed and click Next.
    10. Click the 'Start the Server' link on the 'First Steps' page.
    11. Click the 'Verify Installation' link when the server has started.
      Note:
      After processing, it should say "Installation Verification is complete" at the bottom of the window.
      
      If not, an installation error occurred. Refer to the Troubleshooting section of the WebSphere installation guide on the installation CD. For additional resources on installing WebSphere Click Here.
  4. Configure IBM HTTP Server 1.3.26.
    1. Open the httpd.conf file located in <drive>:\Program Files\IBMHttpServer\conf in a text editor.
    2. Verify that the ServerName parameter, located at the top of the file, reflects the correct host name specified during the installation.
    3. Append default.htm, default.html, and index.htm to the end of the DirectoryIndex parameter so that it appears as follows:
      DirectoryIndex index.html index.html.var default.htm default.html index.htm
      
    4. Add the following code under the Alias section of the file:
      Alias /Output "C:/ArcIMS/Output"
      Alias /output "C:/ArcIMS/Output"
      Alias /OUTPUT "C:/ArcIMS/Output"
      
      Alias /WEBSITE "C:/ArcIMS/WebSite"
      Alias /website "C:/ArcIMS/WebSite"
      Alias /WebSite "C:/ArcIMS/WebSite"
      Alias /Website "C:/ArcIMS/WebSite"
      
      <Directory "C:/ArcIMS/Website">
      Options Indexes MultiViews
      AllowOverride None
      Order allow,deny
      Allow from all
      </Directory>
      
      Note:
      Verify that the paths specified above accurately reflect the environment.
      
    5. Find the line 'UseCanonicalName on' and comment it out with a '#':
      # Use CanonicalName on
      
    6. Save and close the file.
    7. Navigate to Administrative Tools > Services to open the Services panel.
    8. Start IBM HTTP Administration 1.3.26.
    9. Start IBM HTTP Server 1.3.26.
    10. Open a browser, and type: http://<machinename>
      Note:
      A 'Welcome to IBM HTTP Server' page should appear.
      
  5. Install ArcIMS 9.1 from the installation CD.
  6. To configure ArcIMS 9.1, run the ArcIMS Post Installation. Refer to the ArcIMS 9.1 Installation Guide, Step 3B.
  7. To Configure WebSphere to work with ArcIMS 9.1, please refer to the ArcIMS 9.1 Installation Guide, Step 4.
  8. Verify that the ArcIMS installation was successful.
    1. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.
    2. Verify the Web server protocol and 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 hostname and port number. If this is the case, right-click near the top of the window and select 'Allow Blocked Content'.
      
    3. Test both components. The result for Test 1 should be:

      IMS v9.1.0
      Build_Number=1084.1931
      Version=9.1.0
      Test successful

      The result for Test 2 should be:

      Version=9.1.0
      Build_Number=1084.2174
      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 dropdown list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and then try the Diagnostics tool again.
      
  9. For the final step to get ArcIMS running, refer to the ArcIMS 9.1 Installation Guide, Step 5: "Configure ArcIMS".