Update ServletExec 4.1.1 to use a new version of JDK

Summary

ServletExec 4.1.1 can be updated to use a new, supported version of the Sun Java Software Development Kit (JDK); the following steps describe the procedure for updating ServletExec 4.1.1.

Before beginning, verify the current Java ServletExec version on the machine by opening a browser and typing: http://machine_name/servlet/admin; this will start ServletExec Administration. In the left panel under Virtual Machine click Settings; the value shown by Current Java VM is the current version of JRE (or JDK).

Determine the supported versions of JDK by visiting the Online Support Center's System Requirements page.

Procedure

1. Stop the ArcIMS Windows Services in the following order:
   -ArcIMS Tasker 4.0.1
   -ArcIMS Monitor 4.0.1
   -ArcIMS Application Server 4.0.1
2. Stop the Web server.
3. Click Start > Settings > Control Panel and double-click Add/Remove Programs. Remove ServletExec 4.1.1.
4. From this same Add/Remove Programs dialog box, remove all versions of Java, such as JRE, JDK, SDK and Web Start.
5. In Windows Explorer delete the following folders:
   C:\Program Files\Java and
   C:\Program Files\Java Web Start
6. Reboot the server machine.
7. Download and install Java 2 SDK, Standard Edition Version 1.4.0.
   A. Click J2SDK 1.4.0 to download Sun Java 2 SDK, Standard Edition, version 1.4.0.
   B. Click DOWNLOAD in the SDK column next to the option: Windows (all languages, including English).
   C. Accept the license agreement; click 'Download j2sdk-1_4_0-win.exe'.
   D. Run the program after it has finished downloading.
   E. Accept all the installation program defaults unless needing to change them.
8. Install ServletExec 4.1.1.

   Note:
   Prior to installing ServletExec 4.1.1 verify that there is a Scripts Virtual Directory. If there is not a Scripts Virtual Directory create one and point it to C:\Inetpub\Scripts. Give it Execute permissions.

   A. Navigate to the ServletExec Directory on the ArcIMS 4.0.1 installation CD. Double-click on the ServletExec_ISAPI_411.exe application to begin the installation.
   B. At the ServletExec 4.1.1 Welcome window click Next.
   C. At the ServletExec 4.1.1 License Agreement, read the agreement; click Yes.
   D. At the ServletExec Information window, read the information; click Next.
   E. At the Choose Destination Location window, accept the default location or click Browse to select a different location. Click to select a directory and click Next.
   F. At the reminder warning to start and stop IIS in a specific order for ServletExec to take effect, click OK.
   G. To complete the install, uncheck the ReadMe file and click Finish.
9. Stop and start the Web server.
10. Verify the ServletExec installation was successful.
    A. Open a Web browser and type the following (case sensitive) URL into the browser, substituting the Web server name for <machine_name>:

    http://<machine_name>/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.
11. Provide Read/Write access to the ServletExec Data directory.
    1. Navigate to the ServletExec ISAPI directory in the ServletExec installation folder. For example, <drive>:\Program Files\New Atlanta\ServletExec ISAPI.
    2. Right-click on the ServletExec ISAPI directory and select Properties.
    3. Click the Security tab.
    4. Click Add.
    5. In the drop-down list, select the computer name as location.
       • On Windows 2003:</b> Click Advanced > Find Now. Select the user accounts IUSR_<machine_name> and Network Services to add them.
       • On Windows 2000/NT:</b> Double-click IUSR_<machine_name> in the list to add it and click OK.
       • On Windows XP:</b> Click Advanced > Find Now. Select the user account IUSR_<machine_name>.
    6. Select Allow for Write access to grant Read and Write permissions.
    7. Click OK to close the dialog box.
12. Run the Post Install for ArcIMS 4.0.1:
    Click Start > Programs > ArcGIS > ArcIMS > Post Install.
13. Use the Diagnostics tool to test the ArcIMS installation.
    A. Click Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics. The ArcIMS Diagnostics page displays.
    B. Ensure the Web server protocol and Web server name are correct, including the domain and port number. The default is port 80.
    C. Test both components. The result for test 1 should be:
    IMS v4.0.1
    Build_Number=630.1463
    Version=4.0.1
    Test successful
    
    The result for test 2 should be:
    Version=4.0.1
    Build_Number=630.1700
    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 dropdown list and click View. The error number and a description display will. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.