English

How To: Install IIS 6 with JRun 4 and J2SDK 1.4.2 for ArcIMS 9.0 on Windows 2003 Server

Summary

Instructions provided are for the installation and configuration of of IIS 6 with JRun 4.0 using Java 2 SDK, Standard Edition, v. 1.4.2 for ArcIMS 9.0 on Windows 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. 

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 J2DK/JRE, Web Server and Servlet Engine. See: How To: Uninstall ArcIMS-related third-party software on Windows
  2. Install Java 2 SDK, Standard Edition Version 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 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 IIS 6 Web Server if not already installed. See: How To: Install IIS 6.0 on Windows 2003.
  4. Install JRun 4.0.
    1. Launch the JRun 4.0 Installation from the CD or download location.
    2. At the Welcome Screen, click Next.
    3. Read and accept the License Agreement and click Next.
    4. At the Customer Information screen, enter a username, the name of the organization and the serial number. Click Next.
    5. At the Select Java Virtual Machine dialog box, browse to the J2SDK installation directory, if it is not already selected by default; for example, <drive>:\j2sdk1.4.2 or <drive>:\Program Files\Java\j2dk1.5.0_06.
    6. Select a location to install JRun or accept the default, C:\JRun4.
    7. Select Complete Install and click Next.
    8. Select a username and password to log in to the JRun Management Console. Click Next.
    9. Check the box next to 'Install JRun as a Windows Service'. Click Next.
    10. Review the settings and click Install to continue.
    11. Click Finish once the installation is complete.
    12. Download and install the latestsUpdater for JRun 4 and follow the instructions provided by Macromedia: Updater Download
      Note:
      Windows 2003 SP1 may block the execution of the Updater. Add the Updater to the Data Execution Prevention exception list. Please see the link in the Related Section below for more information on this Microsoft feature.
      
      Note:
      Click here for additional resources on installing JRun.
      
  5. Configure JRun 4.0 with IIS.
    1. Click Start > Programs > Macromedia JRun 4.0 > Web Server Configuration Tool.
    2. Click Add.
    3. For JRun Host enter the machine name or fully qualified Web site name.
    4. Make sure JRun Server is set to default.
    5. For Web server, choose Internet Information Server (IIS).
    6. For IIS Web Site, select All.
    7. Click OK.
  6. Add Read/Write permissions for the user accounts: 'Authenticated Users' and 'IUSR_machinename' to the directories
    • Java Runtime Environment at C:\Program Files\Java\j2re1.4.2
    • Java Development Kit at C:\j2dk1.4.2
    • JRun at C:\JRun4
  7. Install ArcIMS 9.0 from the installation CD. Refer to the ArcIMS Installation Guide, Step 3a.
  8. To configure ArcIMS 9.0 run the ArcIMS Post Installation, see the ArcIMS Installation Guide, Step 3b.
    1. Select the Typical Post Installation Option.
    2. At the Web Server-Servlet Engine Configuration screen, select 'I will manually configure my Web server / servlet engine'.
    3. Click OK on the information message referring to the Installation Guide.
    4. Finish the Post Installation.
  9. Configure JRun with IIS for ArcIMS 9.0; see also the ArcIMS Installation Guide Step 4 for manually configuring ArcIMS with IIS and Jrun.
    • CONFIGURE THE ARCIMS SERVLET CONNECTOR
      1. Browse in Windows Explorer to:
        <ArcIMS Installation Directory>\ArcIMS\Connectors\Servlet
      2. Ctrl-click to select the following:
        • the 'com' directory
        • Esrimap_prop
        • ServletConnector_Res.properties
        • ServletConnector_Res_en_US.properties.
      3. Paste these four items into the JRun servlet location at:
        <JRun Installation Directory>\servers\default\default-ear\default-war\WEB-INF\classes
      4. In a text editor such as Notepad, open:
        <JRun Installation Directory>\servers\default\default-ear\default-war\WEB-INF\classes\Esrimap_prop
      5. Edit appServerMachine=APPSMACHINE to point to the machine where the ArcIMS Application Server is installed; for example, change it to appServerMachine=MYMACHINE or appServerMachine=<ip_address>. Change appServerClientPort=5300 only if a different port was selected.
      6. Save and close the file.
    • CREATE VIRTUAL DIRECTORIES
      1. Open the Internet Information Services (IIS) Management Console and expand the tree view until Default Web Site is listed.
        Note:
        Expand the Default Web Site and look for an item named JRunScripts. If a JRunScripts virtual directory alredy exists, skip to step M. If not, follow the steps below.
        
      2. Right-click Default Web site and select New > Virtual Directory.
      3. Enter 'JRunScripts' for the alias and click Next.
      4. For the path, browse to:
        <drive>:\JRun4\lib\wsconfig\1
        then click Next.
      5. Check the box to give it 'Execute (such as ISAPI applications or CGI)' permissions.
      6. Click Finish.
      7. On the left panel, click to select the JRunScripts virtual directory.
      8. On the right panel, right-click on either jrun.dll or jrun_iis6_wildcard.dll (if using Windows 2003) and select Properties from the menu.
      9. Click the File Security tab. Under 'Anonymous Access and Authentication Control', click the Edit button.
      10. Uncheck the box labeled Integrated Windows Authorization. On Windows NT, this box will be called Windows NT Challenge/Response.
      11. Click OK and close the window.
      12. Create a new virtual directory named 'Website' pointing to the Website folder; for example, C:\ArcIMS\Website. Set the virtual directory's permissions to allow Browse.
      13. Create a new virtual directory named 'Output' pointing to the Output folder; for example, C:\ArcIMS\Output.
      14. See the Installation Guide, Step 4, for directions to configure the ArcIMS Service Administrator and Metadata Explorer for IIS with Jrun.
      15. Close the IIS Management Console.
      16. Restart the Windows services named 'IIS Admin Service' and 'World Wide Web Publishing Service'.
  10. 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.
      
  11. For the final step to get ArcIMS running, refer to the ArcIMS 9.0 Installation Guide, Step 5: "Configure ArcIMS".

Related Information