English

How To: Install IIS 6 with ServletExec ISAPI 5.0 and J2SDK 5.0 Update 13 for ArcIMS 9.2/9.3 on Windows

Summary

Note:
Before continuing, please see the link in the related section below for the latest information on using ServletExec 6.0 with IIS provided by New Atlanta.
Instructions provided below are for the installation and configuration of Internet Information Services (IIS) with ServletExec ISAPI 5.0 using Java 2 SDK 5.0 Update 13 for ArcIMS 9.2 or 9.3 on Windows 2000/XP/2003.

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

This installation requires the following: A user account with administrative privileges on the ArcIMS machine is required.
Note:
ArcIMS 9.2 is supported with Java version 5 Update 6 and higher. This document has been updated to use Java version 5 Update 13, which is supported by both ArcIMS 9.2 and 9.3.
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

Previous versions of ArcIMS must be uninstalled before proceeding. The setup program for ArcIMS on Windows prompts for the removal of previously installed versions.

If ArcIMS components were distributed among several computers, it is recommended to first remove the components on each computer before continuing, by going to Add/Remove Programs and selecting Remove for ArcIMS.
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 J2DK/JRE, Web Server and Servlet Engine. See: How To: Uninstall ArcIMS-related third-party software on Windows
  2. Install Java 2 SDK 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 Microsoft IIS if not already installed. See: How To: Install IIS 6.0 on Windows 2003
  4. Install ServletExec ISAPI 5.0.
    Warning:   
    Prior to installing ServletExec 5.0, ensure that a Scripts Virtual Directory is present in IIS. If there is no Scripts Virtual Directory, create one and point it to C:\Inetpub\Scripts. Use the Virtual Directory Creation Wizard in the Internet Information Services console to do this. Verify that the check box next to 'Execute' is checked when going through the wizard.

    A. Navigate to the ServletExec Directory on the ArcIMS installation CD. Double-click on the ServletExec_ISAPI_50.exe application to begin the installation.

    B. Click Yes to stop IIS.

    C. Click Next at the ServletExec 5.0 Welcome window.

    D. Read the license agreement, then click Yes.

    E. Read the ServletExec Information window, then click Next.

    F. Accept the default location or click Browse to select a different location on the Choose Destination Location window. Click to select a directory, then click Next.

    G. Enter a Username and Password to access the ServletExec Admin Pages, then click Next.

    H. Click OK to use the Internet Guest Account for IIS. For example, IUSR_<machinename>.

    I. Click OK to give the user account Network Service the necessary privileges.

    J. To complete the install, click Finish.

    K. After this setup, please apply the latest ServletExec ISAPI hotfix that is available at the according link for ServletExec Hotfixes.
     
    Note:
    Click Here for additional resources on installing New Atlanta's ServletExec.
  5. Verify Read/Write access for ServletExec has been applied.
     
    A. Navigate to the ServletExec ISAPI directory in the ServletExec installation folder. For example, <drive>:\Program Files\New Atlanta\ServletExec ISAPI.

    B. Right-click on the ServletExec ISAPI directory and select Properties.

    C. Click the Security tab.

    D. Click Add.

    E. In the drop-down list, select the computer name as location.

    F. On Windows 2003: Click Advanced > Find Now. Select the user accounts IUSR_<machine_name> and Network Services to add them.
    On Windows 2000/NT:
    Double-click IUSR_<machine_name> in the list to add it and click OK.
    On Windows XP: Click Advanced > Find Now. Select the user account IUSR_<machine_name>.

    G. Select Allow for Write access to grant Read and Write permissions.

    H. Click OK to close the dialog box.
  6. Stop and start the IIS Admin and World Wide Web Publishing services.
  7. Verify IIS and ServletExec were installed successfully.
     
    A. Open a Web browser and type the following (case sensitive) URL into the browser, substituting the Web server name for <machine_name>:
    Code:
    http:///servlet/TestServlet
    If the TestServlet Output screen displays, the install was successful. If this screen does not appear, there is a problem. Repeat the ServletExec installation steps.

    B. License ServletExec for production use. From the Start Menu navigate to Programs > New Atlanta > ServletExec (Version) ISAPI > ServletExec Admin.

    C. In the license key box, type the license number and click Enter License Key.

    D. Close ServletExec Admin.
  8. Install ArcIMS from the installation CD. Refer to the ArcIMS Installation Guide, step 3a.
  9. Run the ArcIMS Post Installation to configure ArcIMS. See the ArcIMS Installation Guide, step 3b. Additional notes on authorizing and configuring ArcIMS are provided here:
     
    AUTHORIZE ARCIMS
     
    Note:
    There are several options to authorize ArcIMS for use. Please see the Installation Guide, step 3b for more information. The following steps cover one common option.

    A. Open a Web browser and go to http://service.esri.com.

    B. Click Product Registration and select the ArcIMS version to register the software.

    C. Enter the information requested. Type the registration code in the field provided. For example, ECP123456789. The registration code should have been sent in an e-mail.
     
    Note:
    If a registration code for this product was not sent by way of e-mail, contact Customer Service or an international distributor.

    D. After registration is completed, an e-mail is sent with an authorization file attached, for example, 123456789.ecp. Save this file in a directory on the ArcIMS machine.

    E. Launch the ArcIMS Post Installation and select the Typical option.

    F. Select the third option 'I have received an authorization file...' and click Next.

    G. Browse to the file received in step D and click Next to authorize ArcIMS for use.

    H. Click Finish to exit the Software Authorization Wizard and continue with the ArcIMS Post Installation.

    CONFIGURE ARCIMS

    I. At the Web Server-Servlet Engine Configuration dialog box, select 'IIS with ServletExec 4.2/5.0'. Click Next.

    J. Enter the path where ServletExec was installed. For example, <drive>:\Program Files\New Atlanta\ServletExec ISAPI\

    K. Click Next.

    L. Click OK. The Web Server/servlet engine configuration may take a few minutes to complete.
  10. Verify that the ArcIMS installation was successful.
    For ArcIMS 9.2:
     
    A. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.

    B. Verify that 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 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.2.0
    Build_Number=514.1916
    Version=9.2.0
    Test successful

    The result for Test 2 should be:

    Version=9.2.0
    Build_Number=514.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.


    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.
  11. For additional optional steps, refer to the ArcIMS Installation Guide, step 5: "Configure ArcIMS".

Related Information