English

How To: Install Apache 1.3.20 with Tomcat 3.2.x and ArcIMS 3.1 on Windows

Summary

Instructions provided are to install Apache Web server with Tomcat Servlet Engine and ArcIMS 3.1.

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. If an older version of Apache or Tomcat is on your machine, remove them before installing an updated version. Follow steps #1 A-E to uninstall Apache as a service. Then continue through steps #1 F-I to uninstall other specified servers and directories.
    A. Open a Command Prompt window.
    -On Windows NT: Click Start > Programs > Command Prompt;
    -On Windows 2000: Click Start > Programs > Accessories > Command Prompt.
    B. Navigate to apache.exe; for example, C:\Program Files\Apache Group\Apache.
    C. At the command prompt, type 'apache -u' without the quotes.
    D. Close the Command Prompt window.
    E. Check that Apache is no longer listed as a service.
    -On Windows NT: Click Start > Settings > Control Panel > Services;
    -On Windows 2000: Click Start > Settings > Control Panel > Administrative Tools > Component Services.
    F. Uninstall Apache Web Server and, if present, uninstall Java Servlet Development Kit 2.0.
    G. Log off your computer and log in.
    H. Delete the Apache and Jakarta-Tomcat directories.
    I. Remove Tomcat services.
    Warning:
    The instructions below include making changes to essential parts of your operating system. It is recommended that you backup your operating system and files, including the registry, before proceeding. Consult with a qualified computer systems professional, if necessary.
    
    Esri cannot guarantee results from incorrect modifications while following these instructions; therefore, use caution and proceed at your own risk.
    1. Click Start > Run.
    2. Type regedit and click OK.
    3. Navigate to HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet > Services.
    4. Delete the jakarta directory.
    5. Close the Registry Editor.
  2. This step is for Windows NT users only:
    Run InstMSI.exe. This allows your computer to interact with Microsoft installer (*.msi) files. Download the executable from the Apache Web Server link in Related Information, below.
    Note:
    This functionality is built into Windows 2000.
  3. Before installing Apache or Tomcat, close all Internet Explorer windows.
  4. Install jdk 1.3.0_02 from the Sun Web site, accepting all defaults. Refer to the Sun Web Site link in Related Information below, for this download.
  5. Install Apache.
    A. Download the Apache Web server. The file is called 'apache_1.3.20-win32-no_src-r2.msi'. Run this msi file to install Apache. Refer to the Apache Web site link in Related Information below, for this download.
    B. At the Welcome screen, click Next.
    C. At the License Agreement screen, choose Accept and click Next.
    D. At the Readme screen, click Next.
    E. At the Server Information screen:
    -For Network Domain, type esri.com;
    -For Server Name, type your computer name;
    -For Administrators E-mail Address, type your e-mail address.
    Select Run as a service for all users. Click Next.
    F. At the Setup Type screen, select Complete and click Next.
    G. At the Destination Folder screen, click Change to either:
    -specify the install location; for example, C:\Apache or
    -accept the default location.
    Click Next.
    H. At the Ready to Install screen, click Install.
    I. At the Installation Completed screen, click Finish.
    J. Reboot the computer.
    K. Click Start > Programs > Apache httpd Server > Configure Apache Server > Edit the Apache httpd.conf Configuration File.
    L. Locate the line: DirectoryIndex index.html and add 'default.htm' to the end.
    If done correctly it reads: DirectoryIndex index.html default.htm
    M. Save the file and close the window.
  6. Verify the Apache installation was successful:
    Open a browser and type your computer name. You should see the Apache page: "Seeing this instead of the website you expected?".
    If you don’t see this page, check that Apache is running.
    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.
    Apache should be listed as 'Started'. If it isn’t, start it.
    If you still don’t see this page, something went wrong; repeat Apache installation, Steps 5 and 6.
  7. Install Tomcat 3.2.
    A. Download Tomcat from the Tomcat Web site; refer to the Download Tomcat 3.2 link in Related Information, below. Unzip jakarta-tomcat-3.2.zip to a root directory; for example, C:\ or D:\.
    B. Right-click My Computer and click Properties.
    C. Click the Environment tab.
    D. In the System Variables:
    -Windows NT, click in the Variable field;
    -Windows 2000, click New.
    E. For Variable, type JAVA_HOME.
    F. For Value, type the path where you installed the jdk, for example C:\jdk1.3.0_02, and click Set on Windows NT, or OK on Windows 2000.
    G. In System Variables:
    -Windows NT, click in the Variable field;
    -Windows 2000, click New.
    H. Type TOMCAT_HOME for Variable.
    I. For Value, type the path where you installed Tomcat; for example, C:\jakarta-tomcat-3.2. Click Set on Windows NT or OK on Windows 2000.
    J. Unzip ApacheModuleJServe.dll.zip to the modules folder of the Apache installation directory; for example, C:\Apache\Apache\modules. Refer to the link in Related Information below, for the zip file.
    K. Open a Command Prompt.
    -On Windows NT: Click Start > Programs > Command Prompt;
    -On Windows 2000: Click Start > Programs > Accessories > Command Prompt.
    Type <drive>:
    Press Enter, and type cd jakarta-tomcat-3.2\bin.
    Press Enter.
    L. Type 'startup.bat' and press Enter. This should create a tomcat-apache.conf file at <drive>:\jakarta-tomcat-3.2\conf. If an error is returned, refer to the article "FATALjava.net.BindException: Address in use", in Related Information below.
    Note:
    A secondary DOS window is opened by startup.bat and appears to hang after a few seconds. This is OK.
    M. Type 'shutdown.bat' and press Enter.
    Note:
    The secondary DOS window closes automatically.
    N. Navigate to Start > Programs > Apache httpd Server > Configure Apache Server > Edit the Apache httpd.conf Configuration File.
    O. At the bottom of the file, add the line:
    Code:
    Include  <tomcat drive>:\jakarta-tomcat-3.2\conf\tomcat-apache.conf
    Save the file and close Apache httpd Server.
  8. Install Tomcat Service.
    A. Unzip Tomcat321service.bat and TomcatService.exe to <drive>:\jakarta-tomcat-3.2\bin. Links to both these files can be found in Related Information, below.
    B. Execute Tomcat321service.bat.
    C. Start the Jakarta service.
    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 there are problems, follow Tomcat's instructions for installing Tomcat as a service.
  9. Verify the installation was successful:
    A. Ensure the Apache service is started: Navigate to Start > Programs > Apache httpd Server > Control Apache Server > Start.
    B. Start the Jakarta-Tomcat service in the Services Window: Navigate to Start > Settings > Control Panel > Services.
    C. Open a browser and type: http://<machinename>/examples/servlet/HelloWorldExample.
    "Hello World!" should display. If it does, continue. If not, repeat the installation of Tomcat Service, Steps 8 and 9.
  10. 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; for example: C:\jdk1.3.0_02. After JRE is installed, click Next to continue the 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. At the Web Site Working Directory, you have two options:
    -To store web pages and ArcIMS output, accept the default location. If you choose the default, you must create virtual directories for output and Web site, after installation. Refer to Step 13 below for instructions.
    -To change the directory, click Browse. If you browse to the location of your Web server root directory, it is unnecessary 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>:\jakarta-tomcat-3.2\webapps\ROOT\WEB-INF\classes.
    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. It also 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 the ports 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 the ports 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.
  11. Configure Tomcat to work with ArcIMS:
    A. Verify that the following items are at \jakarta-tomcat-3.2\webapps\ROOT\WEB-INF\classes:
    · com directory
    · Esrimap_prop
    · jaxp.jar
    · parser.jar
    · ServletConnector_Res.properties
    · ServletConnector_Res_en_US.properties files
    · WMSEsrimap_prop
    If not, Stop your Apache Web server; then navigate to <ArcIMS Installation Directory>\Connectors\Servlet and copy the items to that location.
    Start your Apache Web server.
    B. Stop the Jakarta and Apache services.
    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.
    C. If you have Jakarta-Tomcat running as a service, find and open in a text editor \jakarta-tomcat-3.2\conf\ wrapper.properties. Search on 'wrapper.class_path' and add the following lines to the wrapper.class_path list:
    Code:
    wrapper.class_path=$(wrapper.tomcat_home)\webapps\ ROOT\ WEB-INF\classes\jaxp.jar
    wrapper.class_path=$(wrapper.tomcat_home)\webapps\ ROOT\ WEB-INF\classes\parser.jar
    Save the file, start the Jakarta and Apache services and close the Services window.
    Note:
    You can find the wrapper.properties file at <ArcIMS Installation Directory>\common or at www.apache.org.
    D. Start the Jakarta and Apache services.
  12. Use the Diagnostics tool to test the ArcIMS Installation.
    A. Navigate to Start > Programs > Esri > ArcIMS 3.1 > ArcIMS Diagnostics. The ArcIMS Diagnostics displays.
    B. Select your Web server protocol, type the 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, such as 'Page not found', select the error from the Select Error dropdown list and click View. The error and a description will display. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.
  13. Create Virtual Directories.
    A. Stop your Apache 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. In a text editor, open <ArcIMS Installation Directory>\Common\ApacheAlias.txt and copy the contents of the file. Close the file.
    C. In a text editor, open \Program Files\Apache Group\Apache\conf\httpd.conf.
    Under the line
    Code:
    Alias /icons/ “<drive>:/Program Files/Apache Group/Apache/icons/”
    paste the lines from the ApacheAlias.txt file. Replace the paths in these lines with the appropriate paths where necessary.
    D. Add the following lines:
    Code:
    <Directory “C:/arcIMS/Website”>
            Options Indexes MultiViews
            AllowOverride None
            Order allow,deny
     	Allow from all
        </Directory>
    E. Save and close the text file.
    F. Start your Apache Web Server and close the Services window.
  14. For the final step to get ArcIMS running, refer to the ArcIMS 3.1 Installation Guide, Step 5: "Configure ArcIMS".

Related Information