photograph: Desert Tortoise The Advanced Resource Technology Group:
The Knowledge Base



Last updated
6/21/02

Back

****************************************
  ArcIMS Installation Log
****************************************
  Patrick J. Barabe
  Advanced Resource Technology Group
  School of Renewable Natural Resources
  The University of Arizona
****************************************




INFO:
NOTE: this procedure was adapted from that posted by Bart
Adriaanse on the ESRI ArcIMS Product Discussion Conference

SOFTWARE USED:
OS:MS Windows 2000 Server
Web:Apache v 2.0
Servlet:Tomcat 4.1
IMS:ESRI ArcIMS 3.1



STEPS:
I. Install Java J2SDK 1.4.0
II. Install Apache 2.0.35
III. Install Jakarta-Tomcat 4.01
IV. Install/Configure ESRI ArcIMS 3.1
V. Configure Tomcat for ArcIMS
VI. Configure Apache for ArcIMS
VII. Optional Steps




STEP I - Install J2SDK 1.4.0 w/ J2RE
  1. That's all!





STEP II - Install Apache as a service
  1. Choose default settings

  2. Reboot

  3. Verify Apache is running by noting the presence of its default web page:
    http://myhost.mydomain.edu/
    or simply
    http://localhost/





STEP III - Instal Tomcat
  1. Choose default options and install as an "NT Service"

  2. Reboot

  3. Verify Tomcat is running by noting the presence of its default web page:
    http://myhost.mydomain.edu:8080/
    or simply
    http://localhost:8080/





STEP IV - Intall ArcIMS
  1. Choose to do a Custom Installation

    • Click Options for Manager
      • Choose Manager Applications

    • Click Options for Application Server Connectors
      • Choose Servlet Connector
      • Choose AppServerLink

    • Choose Samples, click Options
      • Choose Tutorial Data
      • Choose Sample HTML & Java Viewers
      • Choose Sample Java & JSP Applications
      • Choose Sample WMS Viewers

    • Choose Documentation, click Options
      • Choose ArcXML Guide
      • Choose Customizing HTML Viewer
      • Choose Customizing Java Viewer
      • Choose Customizing AppServerLink

  2. JRE:

    • Browse to JRE w/in J2SDK 1.4

  3. Host Name:

    • Protocol: http
    • Host: myhost:8080

  4. Web Site Working Directory: c:\ArcIMS

  5. User's Working Directory: c:\ArcIMS\AXL

  6. Application Server Information:
    • Host Name: myhost
    • Registry Port: 5353
    • Connector Port: 5300

  7. Servlet Connector Directory:

    • C:\Program Files\Apache Tomcat 4.0\webapps\ROOT\WEB-INF
      NOTE: other instructions say %above path%\classes

  8. Provide an administrative user/password

  9. Install





STEP V - Configure Tomcat
  1. Open %Tomcat Install Dir%\conf\server.xml in a text editor

  2. Add to Context section:
    <!-- ArcIMS Context using default directories -->
    <Context path="/Website" docBase="c:/ArcIMS/Website" debug="0"/>
    <Context path="/output" docBase="c:/ArcIMS/Output" debug="0"/>



  3. Create dir %Tomcat Install Dir%\webapps\ROOT\WEB-INF\classes

  4. Move all contents of directory ..\WEB-INF EXCEPT web.xml to classes

  5. Edit %ArcIMS Install Dir%\common\wrapper.properties to match local paths for
    Tomcat & Java installations. Save this file as
    %Tomcat Install Dir%\conf\wrapper.properties

  6. Restart ArcIMS, Tomcat, & Apache





STEP VI - Configure Apache
  1. Open %ArcIMS install dir%\Common\ApacheAlias.txt, copy & past contents
    to the Alias section of %Apache Install Dir%\conf\httpd.conf





STEP VII - Optional Steps

** INSTALL SAMPLE JSP/AppServerLink APPLICATIONS **
  1. Edit %ArcIMS Install Dir%/Server/etc/aimses.cfg so that access="PUBLIC"

  2. Restart ArcIMS

  3. Add following lines to
    %Tomcat Install Dir%/conf/wrapper.properties and
    %ArcIMS Install Dir%/common/wrapper.propteries
    wrapper.arcims_home=c:\Program Files\ESRI\ArcIMS3.1
    wrapper.class_path=$(wrapper.arcims_home)\Connectors\AppServerLink\arcims_appserverlink.jar
    wrapper.class_path=$(wrapper.arcims_home)\Samples\Java_JSP\Classes\arcims_jspbeans.jar
    wrapper.class_path=$(wrapper.arcims_home)\Samples\Java_JSP\Classes\jaxp.jar
    wrapper.class_path=$(wrapper.arcims_home)\Samples\Java_JSP\Classes\parser.jar


  4. Restart Apache

  5. Edit %ArcIMS Install Dir%/Samples/Java_JSP/AdvancedViewer/default.jsp
    change serverName, serviceName, and ovServiceName variables to local parameters

  6. Add following line to %Tomcat Install Dir%/conf/server.xml
    <Context path="/AdvancedViewer" docBase="c:/Program Files/ESRI/ArcIMS3.1/Samples/Java_JSP/AdvancedViewer" debug="0"/>


  7. Copy %ArcIMS Install Dir%/Samples/Java_JSP/Classes/*.* to %Tomcat Install Dir%/lib/.

  8. Copy %ArcIMS Install Dir%/Connectors/AppServerLink/arcims_appserverlink.jar to %Tomcat Install Dir%/lib/.

  9. Restart Apache