English

How To: Install iPlanet with ArcIMS 3.1 on Windows

Summary

Instructions provided are the installation and testing of iPlanet (FastTrack or Enterprise) using its native Servlet support with ArcIMS 3.1 on Windows.

Note:
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 iPlanet:
    a. At the Welcome screen, click Next.
    b. At the Software License Agreement screen, click Yes.
    c. At the Type of Installation screen, choose Typical and click Next.
    d. At the Location of Installation screen, Browse to the location where you want iPlanet installed or accept the default location. Click Next.
    e. At the Components to Install screen, accept the defaults and click Next.
    f. At the iWS Administration Server Authentication screen, type your user ID and a password. You can use the default User ID: admin along with a password of your choice and click Next.
    Note:
    This user ID is used to access iPlanet’s Admin Server.
    g. At the iWS Administration Server Port Selection screen, type in 10000 and click Next.
    h. At the Default Web Server screen, accept the defaults and click Next.
    i. At the Using LDAP for User and Group Administration screen, click Next.
    j. At the JDK Configuration screen, click Next.
    k. At the Configuration Summary screen, click Install.
    l. At the Completion of Installation screen, choose to restart and click Finish.
  3. VERIFY THE iPlanet INSTALLATION WAS SUCCESSFUL:
    a. Check that iWS (machine)and iWS Administration Server services are started.
    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.
    If they are not already started, start them.
    b. Open your browser and type <computer name>:10000.
    c. Enter the User ID and password that you specified during installation.
    If the iPlanet Web Server Administration Server page displays, you have successfully
    installed iPlanet and may continue.
    If it doesn’t display, something went wrong. Go back through the installation steps.
  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. 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 7 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 <drive>:\Netscape\Server4\docs\servlet.
    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 iPlanet TO WORK WITH ArcIMS:
    a. Stop your web server.
    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.
    b. Verify that the following items are at \Netscape\server4\docs\servlet:
    · com directory
    · Esrimap_prop
    · jaxp.jar
    · parser.jar
    · ServletConnector_Res.properties
    · ServletConnector_Res_en_US.properties files
    · WMSEsrimap_prop
    If the files are not there, skip to step 5c.
    Move the following items from \Netscape\server4\docs\servlet to
    \Netscape\server4\https-<localhost>.<domain>.com\config:
    · Esrimap_prop
    · ServletConnector_Res.properties
    · ServletConnector_Res_en_US.properties
    · WMSEsrimap_prop
    Skip to step 5d.
    c. If the files are not at \Netscape\server4\docs\servlet, navigate to <ArcIMS Installation Directory>\Connectors\Servlet, and copy the following items to that location:
    · com directory
    · jaxp.jar
    · parser.jar
    Note:
    You may need to create a servlet directory.
    Copy the following items from <ArcIMS Installation Directory>\Connectors\Servlet to
    \Netscape\server4\https-<localhost>.<domain>.com\config:
    · Esrimap_prop
    · ServletConnector_Res.properties
    · ServletConnector_Res_en_US.properties
    · WMSEsrimap_prop
    d. Start your web server and close the Services window.
    e. In your web browser, type:
    “http://<localhost.domain.com>:<serveradminport>”
    For example: http://esri.esri.com:10000
    Note:
    If you don’t know your server’s administration port, open Netscape\server4\https-admserv\config\magnus.conf in a text editor and read the port there.
    f. Type your user name and password and click OK. The iPlanet Web Server Administration Server screen displays.
    g. Select your Server from the dropdown list and click Manage. The Server On/Off screen displays. Make sure the server is on.
    h. Click Content Management in the navigation bar on the top. The Primary Document Directory screen displays.
    i. Click Document Preferences on the left sidebar. The Document Preferences screen displays.
    j. Add “default.htm,default.html,index.htm” first in the list under Index Filenames. Accept the defaults for the other options. Click OK, click Save and Apply, and click OK.
    k. Click the Servlets tab along the top. The Enable Servlets screen displays.
    l. Click Yes to activate the Servlet Engine, accept the defaults for the other options, and click OK.
    m. Click Configure JVM Attributes on the left sidebar. Position your cursor at the end of the last entry in the classpath text box and type the following:
    “;<drive>:/Netscape/Server4/docs/servlet/jaxp.jar;<drive>:/Netscape/Server4/docs/servlet/parser.jar”.
    Click OK, click Save and Apply, and click OK.
  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:
    After installing ArcIMS, you must create virtual directories for Manager, output, and website. A virtual directory is a mapped location on the web server to a physical path.
    Note:
    If you browsed to the location of your web server root directory to create directories for output and website (the Web Site Working Directories) during ArcIMS installation, you don’t need to create virtual directories for output and website.
    a. Click Content Management in the navigation bar at the top. The Primary Document Directory screen displays.
    b. Click Additional Document Directories on the left sidebar. The Additional Document Directories screen displays.
    c. Type “Manager” for the URL prefix.
    d. Next to Map To Directory, type “<install drive>:\Program Files\Esri\ArcIMS4.0\Manager” or the alternate location you selected during Step 4. Click OK, click Save and Apply, and click OK.
    Note:
    If you browsed to the location of your web server root directory to create directories for output and website during ArcIMS installation, continue to step 8 below.
    e. Type “output” for the URL prefix.
    f. Type the appropriate path under Map To Directory, for example, C:\ArcIMS\output. Click OK, click Save and Apply, and click OK.
    g. Type “website” for the URL prefix.
    h. Type the appropriate path next to Map To Directory, for example, C:\ArcIMS\website. Click OK, click Save and Apply, click OK, and exit iPlanet.
  8. See "Step 5: Configure ArcIMS" in the ArcIMS 3.1 Installation Guide for the final step required to get ArcIMS running.

Related Information