English

How To: Install JRun 3.1 for IIS 4/5 and ArcIMS 3.1 on Windows

Summary

Instructions provided are for the installation and testing of JRun Servet Engine on IIS Web server and ArcIMS 3.1.

Note:
Important: Check that the version of ArcIMS shown in 'Software' in the title bar above, matches the version you are using. Do not continue if these do not match. Refer to Related Information, below, for an article providing the installation on a more recent version of ArcIMS, or return to the ESRI Online Support Site to locate the instructions you require.

Procedure

 

  1. Install jdk 1.3.0_02 from the Sun Web site and accept all the defaults.
  2. INSTALL JRun:
    A. At the Install screen under Install, click Allaire JRun Server.

    B. At the Welcome screen, click Next.

    C. At the License screen, click Yes.

    D. At the JRun Product Serial Number screen, enter the serial number for any version other than the Developer version and click Next. For the Developer version, just click Next.

    E. At the JRun Installation Folder screen, Browse to the location where you want JRun installed or accept the default location. Click Next.

    F. At the Setup Type screen, select Full and click Next.

    G. At the Select Program Folder screen, accept the defaults and click Next.

    H. At the Install JRun Services screen, click Next.

    I. At the Select a Java Runtime screen, highlight a jdk and click Next.

    J. At the JVM Advisor screen, click Next.

    K. At the JRun Management Console screen, accept the default port number and click Next.

    L. At the JRun Management Console password screen, type a password and click Next.

    M. At the JRun Product Information screen, uncheck the boxes and click Next.

    N. At the JRun Setup Complete screen, choose Configure JRun Now and click Finish.

    O. Type the username and password that you specified above.

    P. For Step 1, in the JRun Server Name box, highlight JRun Default Server.

    Q. In the Web Server Type box, choose Internet Information Server.

    R. For Web Server Version, choose 4.0 or 5.0 as appropriate.

    S. For Web Server Platform, choose intel-win and click Next.

    T. At the Explorer Note box click OK and stop IIS as described above.

    U. For Step 2, type 51000 in the JRun Server Connector Port box and click Next.

    V. For Step 3, in the IIS scripts Directory box, Browse to
    C:\Inetpub\scripts, click Accept, and click Next.

    W. For Step 4, click Done.

    X. Close the Jrun Management Console and click Exit twice to close the install screen.

    Y. Start IIS web server.
     
    A. Open IIS Manager:

    --For IIS 4.0:
    Click Start > Programs > Windows NT Option Pack > Microsoft Internet Information Server > Internet Service Manager.

    --For IIS 5.0:
    Click Start > Settings > Control Panel > Administrative Tools > Internet Services Manager.

    B. Highlight Default Web Site under your localhost name:
    1. In the toolbar, click the Stop button (square icon).
    2. Click the Start button (arrow icon).



    Z. Choose Start > Programs > JRun > JRun Management Console and log in. In the left panel, click JRun Default Server and, in the right panel, click Restart server.
  3. VERIFY THE JRun INSTALLATION WAS SUCCESSFUL:
    A. Open a browser and type: http://<computer name>/demo/servlets

    B. If you see the JRun Sample Servlets screen, your installation was successful and you may continue.

    If you don’t see this screen, something is wrong. Go through the installation steps again.
  4. INSTALL ArcIMS 3.1:

    A. Run ArcIMS setup.exe.

    B. At the Welcome screen, click View Readme to read about last-minute changes
    to the ArcIMS installation instructions. Close the window when done. Click Next. At the License Agreement screen, click I Agree.

    C. At the Installation Type screen, click Typical and click Next.

    D. At the Installation Directory screen, click Browse to change the installation directory, if desired, and click OK. Click Next.

    E. If JRE 1.3.0_02 is not installed or not detected, a Java Runtime Environment Installation screen displays. You must have JRE installed to install and run ArcIMS Manager and the Java Viewers.
     
    Note:
    The setup program looks for a specific registry entry to determine if JRE is installed on your computer. Java Development Kit (JDK) 1.3 does not create the registry entry even though it contains a valid JRE.

    Click OK to begin JRE installation or Browse to an existing JDK location. After JRE installation, click Next to continue ArcIMS installation.

    F. At the Host Name and Working Directories screen, choose a protocol and change the Web Server Host Name, if needed.

    If you are setting up an Internet web site or a multiple ArcIMS Spatial Server configuration, you must include your domain name, for example, esri.esri.com. If your web server has a port number other than the default HTTP port (80), then it should have the syntax webservername:port number, for example, esri.esri.com:81.

    G. For the Web Site Working Directory, accept the default location to store web pages and ArcIMS output, or click Browse to change the directory.
     
    Note:
    If you choose the default, after installation you must create virtual directories for output and website. See step 6 below for instructions.
    
    If you browse to the location of your web server root directory, then you don’t need to create virtual directories for output and website.

    H. For the User’s Working Directory, accept the default location or click Browse to navigate to another location. Click Next.

    I. At the Application Server Information screen, change the Registry Port and Connector Port, if desired.

    The ArcIMS Spatial Server, Monitor, and Tasker communicate with the ArcIMS Application Server via the Registry port.

    The Servlet Connector and ArcIMS Application Server communicate via the Connector port.

    Click Next.

    J. At the Servlet Connector Directory screen, Browse to the location of your Servlet directory, for example \Program Files\Allaire\Jrun\servlets.

    If you don’t know this location, click Help for a list of the most common Servlet directory locations.

    If you are unsure, use this location:
    <ArcIMS Installation Directory>\Connectors\Servlet and contact your system administrator. In this case, the servlet connector (com directory and associated files) must be moved from <ArcIMS Installation Directory>\Connectors\Servlet to the appropriate web server directory before using ArcIMS. See step 5 below for details.

    Click Next.

    K. At the Windows Services Authorization screen, change your Domain\User Name, if necessary. The User Name and Password must be for the installation account and must have administrator privileges.

    This information gives ArcIMS the ability to start Windows services (ArcIMS Application Server, Monitor, and Tasker) and gives the ArcIMS Spatial Server the necessary privileges to access resources on the local computer and/or network.

    L. Type your Password for the selected User Name and type it again to confirm it. Click Next.

    M. At the Summary of Installation Information screen, verify that the information displayed is correct. After installation, it is written to a log file located at
    <ArcIMS Installation Directory>\Common\InstallSummary.log.

    Click Next to begin installation.
     
    Note:
    Microsoft’s Java VM 3186 or later is required for the ArcIMS Windows Services. The installation prompts you to update your system if Microsoft Java VM is not detected or if you have an older version.

    N. At the Installation Successful screen, click Finish to restart your computer.
     
    Note:
    You must restart your computer to complete ArcIMS installation.

    O. After ArcIMS installation, it is recommended that you update your Services file. This file contains a record of what ports are in use. It is typically located at <drive>:\WINNT\system32\drivers\etc.

    Open the Services file in a text editor, scroll to the place where the port numbers fit in, and add the Connector and Registry port numbers to the file, for example,
    Code:
    esri_conn    5300/tcp    #ArcIMS connector port
    esri_reg     5353/tcp    #ArcIMS registry port

    Save the file.

    This tells your system administrator which ports are in use, so they will not be duplicated. The port numbers are listed on the ArcIMS Summary screen; this information is written to a summary log file located at <ArcIMS Installation Directory>\Common.
  5. CONFIGURE JRun TO WORK WITH ArcIMS:
    A. Verify that the following items are at \Program Files\Allaire\Jrun\servlets:
    · com directory
    · Esrimap_prop
    · jaxp.jar
    · parser.jar
    · ServletConnector_Res.properties
    · ServletConnector_Res_en_US.properties
    · WMSEsrimap_prop

    If not, Stop IIS. Then navigate to <ArcIMS Installation Directory>\Connectors\Servlet and copy the files to that location. Restart IIS.

    B. Choose Start > Programs > JRun > JRun Management Console and log in. If the JRun Quick Start window opens, close it. In the left sidebar, click JRun Default Server. Then, in the left sidebar, click Java Settings.

    C. In the right panel, click edit, in the JRun Default Server/Java Settings: Edit Window, scroll down to Classpath, and in the Input Field for Classpath type: {jrun.rootdir}/servlets

    Click update. Close the JRun Management Console.

    D. Stop and Start JRun Default Server and close the Services window.
     
    To start and stop Windows services:

    -On Windows NT: Click Start > Settings > Control Panel > Services.

    -On Windows 2000: Click Start > Settings > Control Panel > Administrative Tools > Component Services.

    -On Windows XP: Click Start > Control Panel > Performance and Maintenance > Administrative Tools > Component Services and click Services on the Tree tab.
  6. USE THE DIAGNOSTICS TOOL TO TEST YOUR ArcIMS INSTALLATION:
    A. Choose Start > Programs > Esri > ArcIMS 3.1 > ArcIMS Diagnostics. The ArcIMS Diagnostics displays.

    B. Select your web server protocol, type your web server name including domain, and type your port number. The default is 80.

    C. Click Test to test the ArcIMS Servlet Connector and ArcIMS Application Server.

    If this test is successful, your ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly.

    If you receive an error message, select the error number in the dropdown list and click View. The error number and a description display. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.
  7. CREATE VIRTUAL DIRECTORIES ON IIS:
    A. Open IIS Manager:
    · For IIS 4.0, choose Start > Programs > Windows NT Option Pack > Microsoft Internet Information Server > Internet Service Manager.

    · For IIS 5.0, choose Start > Settings > Control Panel > Administrative Tools > Internet Services Manager.

    B. Under your localhost name, find Default Web Site. Click to highlight it.

    C. Click Action in the toolbar.

    D. From the dropdown menu, point to New and click Virtual Directory. The New Virtual Directory Wizard displays.

    E. Type “Manager” for the alias and click Next.

    F. Click Browse to select the ArcIMS Manager directory at
    <drive>:\Program Files\Esri\ArcIMS3.1\Manager or the alternate location you selected installation, click OK, and click Next.

    G. For IIS 4.0, check Allow Directory Browsing and click Finish.

    For IIS 5.0, check Browse and click Next.

    Manager appears in the virtual directory list.

    Now create virtual directories for output and website.
     
    Note:
    If you browsed to the location of your web server root directory to create directories for output and website during ArcIMS installation, skip to step 7R below.

    H. Click Default Web Site to highlight it.

    I. Click Action, point to New, and click Virtual Directory.

    J. Type “output” for the alias and click Next.

    K. Click Browse to select the ArcIMS output directory located where you placed it during installation, for example, C:\ArcIMS\output. Click Next.

    L. Check Allow Directory Browsing and click Finish. Output appears in the virtual directory list.

    M. Click Default Web Site to highlight it.

    N. Click Action, point to New, and click Virtual Directory.

    O. Type “website” for the alias and click Next.

    P. Click Browse to select the ArcIMS website directory located where you placed it during installation, for example, C:\ArcIMS\website. Click Next.

    Q. Check Allow Directory Browsing and click Finish. Website appears in the virtual directory list.

    R. To change file security, in the left panel, click Scripts. In the right panel, right-click jrun.dll for JRun, and choose Properties.

    S. Click the File Security tab and click Edit to change the Anonymous access and authentication control.

    T. Make sure Anonymous access is checked. For IIS 4.0, uncheck Windows NT Challenge/Response and click OK; for IIS 5.0, uncheck Integrated Windows Authentication and click OK.

    U. Close the console window. Click Yes at the Save Console settings prompt.
  8. See "Step 5: Configure ArcIMS" in the ArcIMS 3.1 Installation Guide for the final step required to get ArcIMS running.

Related Information