Install and configure ArcIMS 3.1 with Oracle Application Server on Windows

Summary

Instructions provided are for the installation of Oracle Application Server with ArcIMS 3.1 on Windows.

Procedure

1. Install Oracle Application Server:
   
   A. At the Welcome screen, click Next.
   
   B. At the File Locations screen, accept the defaults and click Next.
   
   C. At the Installation Types screen, choose Oracle HTTP Server Only and click Next.
   
   D. At the summary screen, click Install.
   
   E. Once Oracle is done installing either the screen will disappear and you need to reboot, or the End of Installation screen will appear in which case click Exit and reboot.
   
   F. After rebooting, the install screen should reappear and you may continue.
   
   G. At this point the installer may ask you to insert a cd or point it to disk 1. Insert disk 1 or browse to the location where you are installing from and click OK.
   
   It takes a while for the next screen to pop up. Be patient. The Apache Listener Configuration for Oracle Portal screen should eventually appear.
   
   H. At the Apache Listener Configuration for Oracle Portal screen, accept the defaults, leave the TNS Connect String empty, and click Next.
   
   I. The next screen looks exactly the same as the last one. Do the same here. Accept the defaults, leave the TNS Connect String empty, and click Next.
   
   J. At the Portal-to-Go repository information screen, click Next.
   
   K. At the Portal-to-Go schema information screen, click Next.
   
   L. At the Please enter SYSTEM Password screen, click Next.
   
   M. At the Summary screen, click Install.
   
   N. A DOS window should appear prompting for a username. This is for connecting to a database. Press enter twice. The DOS window will go away and the configuration will continue.
   
   O. At the Net8 Configuration Welcome screen, check the box to do a typical configuration and click Next.
   
   P. At the Oracle Portal Step 1 screen, click Cancel. We don’t want to configure this now.
   
   Q. An Error box will display. This is OK. Click OK and continue.
   
   R. At the Configuration Tools screen, click Next.
   
   S. At the End of Installation screen, click Exit.
   
   T. Reboot your computer.
2. Test your Oracle Application Server installation:
   
   Open a browser, and type: http://<your machine name>/servlets/IsItWorking
   
   The display should show: 'Yes, It’s working!' If it does, continue. If not, Reinstall Oracle Application Server.
3. 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:
   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:
   NOTE: If you choose the default, after installation you must create virtual directories for output and Web site. See step 13 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 Web site.

   
   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>:\Oracle\iSuites\Apache\Jserv\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 7 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:
   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:
   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.
4. Configure Oracle 9iAS to work with ArcIMS:
   
   A. Verify that the following items are at \Oracle\iSuites\Apache\Jserv\servlets:
   com directory, Esrimap_prop, ServletConnector_Res.properties, ServletConnector_Res_en_US.properties, and WMSEsrimap_prop files.
   
   If not, on Windows NT, choose Start > Settings > Control Panel > Services; on Windows 2000, choose Start > Settings > Control Panel > Administrative Tools > Component Services.
   
   Stop your Oracle Application Server, navigate to <ArcIMS Installation Directory>\Connectors\Servlet,
   and copy the following items to that location: com directory, Esrimap_prop, ServletConnector_Res.properties, ServletConnector_Res_en_US.properties, and WMSEsrimap_prop files.
   
   Start your Oracle Application Server.
   
   B. Edit the jserv.properties file located at Oracle\iSuites\Apache\Jserv\conf. Add these lines under CLASSPATH:
   
   

   Code:
   wrapper.classpath=<drive>:\Oracle\iSuites\Apache\Jserv\servlets\jaxp.jar
   wrapper.classpath=<drive>:\Oracle\iSuites\Apache\Jserv\servlets\parser.jar

   
   Save the file. Stop and Start your OraceISuitesHTTPServer and close the Services window.
5. Use the Diagnostics tool to test the ArcIMS installation:
   
   A. Click 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.
6. Creating virtual directories:
   
   After installing ArcIMS, create virtual directories for Manager, output,
   and Web site. A virtual directory is a mapped location on the Web server to a physical path.
   
   

   Note:
   Note: If you browsed to the location of your Web server root directory to create directories for output and Web site (the Web Site Working Directories) during ArcIMS installation, you don’t need to create virtual directories for output and Web site.

   
   A. On Windows NT, click Start > Settings > Control Panel > Services; on Windows 2000, choose Start > Settings > Control Panel > Administrative Tools > Component Services.
   
   Stop your Oracle Application Server.
   
   B. In a text editor, open <ArcIMS Installation Directory>\Common\ApacheAlias.txt and
   copy the contents of the file.
   
   C. In a text editor, open \Oracle\iSuites\Apache\Apache\conf\httpd.conf.
   
   Under the line
   
   

   Code:
   Alias /icons/ “>:\Oracle\iSuites\Apache\Apache\icons/”

   
   paste the lines from the ApacheAlias.txt file that follow this pattern. Replace the paths in these lines with the appropriate paths where necessary.
   
   D. Save the text file.
   
   E. Start your Oracle Application Server and close the Services window.
7. For the final step to run ArcIMS refer to the ArcIMS 3.1 Installation Guide: "Step 5: Configure ArcIMS".