English

How To: Install IIS with Tomcat 5.5.17 using J2SE JDK 5.0 Update 13 for ArcIMS 9.2/9.3 on Windows

Summary

Instructions provided are for the installation and configuration of IIS 6 with Tomcat 5.5.17 using J2SE Development Kit 5.0 Update 13 for ArcIMS 9.2 and ArcIMS 9.3 on Windows.

Specific information for the installation of ArcIMS is included with the product's Install Guide.

This installation requires the following software:

A user account that has Administrator rights on the ArcIMS machine is required.
Note:
ArcIMS 9.2 is supported with Java version 5 Update 6 or higher. This article has been updated to reference Java version 5 Update 13 since that is supported by both ArcIMS 9.2 and 9.3.

Before Beginning
  • Familiarity with certain Windows tasks is required to install and configure ArcIMS. For details, see Common Windows tasks when installing ArcIMS.
  • For more information on the acronyms and terms used in this document, see the Glossary of terms used in ArcIMS Installation articles.
  • Review and follow steps 1 and 2 from the ArcIMS Installation Guide on the DVD. These two steps ensure that the system meets the minimum requirements and assist in planning the ArcIMS site configuration. To open the ArcIMS Installation Guide, launch the DVD menu and click 'ArcIMS Installation Guide'.

Procedure

Note:
The following steps also apply for configuring IIS with Tomcat on a Windows 2003 64-bit operating system. However, there are additional steps needed for configuring IIS with Tomcat on Windows 2003 64-bit machines. See the additional note in Step 5.
  1. Uninstall any unsupported versions of Java, Web Server and Servlet Engine. See: How To: Uninstall ArcIMS-related third-party software on Windows
  2. Install Java 2 Standard Edition Development Kit version 5.0 Update 13.
  1. Click J2SE Development Kit (JDK) 5.0 Update 13 to download Sun Java 2 SDK, Standard Edition, version 5.0 Update 13.
  2. Click 'Download JDK'.
  3. Accept the license agreement.
  4. Click on the download link for the Windows Offline Installation Multi-Language. The file jdk-1_5_0_13-windows-i586-p.exe is downloaded.
  5. Run the installer after it has finished downloading.
  6. Accept all of the default installation options, unless changes are required. This installs both the Java Runtime and Development Kit.
  7. After the install, Navigate to Start > Settings > Control Panel > Java.
  8. Click the 'Update' tab and remove the check mark for 'Check for Updates Automatically'.
  9. Click Apply and close the Java Control Panel.
  1. Install Microsoft IIS if it is not already installed. See: How To: Install IIS 6.0 on Windows 2003.
  2. Install Tomcat 5.5.17.

INSTALL TOMCAT

  1. Click here to access the Jakarta Tomcat 5.5.17 Download site.
  2. Click on apache-tomcat-5.5.17.exe to download the file. Save it on the local machine.
  3. Navigate to the folder where the file was downloaded and double-click apache-tomcat-5.5.17.exe.
  4. Click Next to continue.
  5. Read the License Agreement and click 'I Agree'.
  6. At the Choose Components dialog box, change the type to 'Full' install. Alternatively, add at least the features Service and Examples to the selection.
  7. Click Next.
  8. Select the preferred installation location, for example, the default C:\Program Files\Apache Software Foundation\Tomcat 5.5 or C:\Tomcat5.5
  9. Use the default settings in the Configuration dialog box. Create a new password for the Tomcat Administrator. Click Next.
  10. The path of the JVM installed on the machine should be the location of the Java Standard Development Kit, for example, C:\Program Files\Java\jdk1.5.0_13. Browse to this path if it is not set automatically and click OK.
Warning: 
If a path to an older SDK version is listed, cancel the Tomcat installation. Make sure that a Java SDK is installed and the environment variables JAVA_HOME and PATH do not include any old entries regarding the Java Runtime Environment or are pointing to the J2SDK location correctly.
  1. Click Install to continue. Click Finish.
SETUP OF ENVIRONMENT VARIABLES:
  1. Right-click on My Computer and click Properties. Click the Advanced tab. Click on the Environment Variables button.
  2. Under System Variables, click New. When prompted for Variable Name, type JAVA_HOME (case sensitive). For the Variable value, type the path where Java 2 SDK is installed, for example, C:\Program Files\Java\jdk1.5.0_13. Click OK.
  3. Create another system environment variable called CATALINA_HOME (case sensitive). For the Variable value, type the path where Jakarta Tomcat 5.5.17 is installed, for example, C:\Program Files\Apache Software Foundation\Tomcat 5.5 or C:\Tomcat5.5. Click OK.
  4. In the System variables list, scroll to the 'Path' variable, select it, and click Edit. In the Variable Value text box, append the following to the end of the text, including the semi-colon to separate from previous entries:
;%JAVA_HOME%\bin.
Note:
Verify that old references to JAVA_HOME in the path variable have been removed, for example, <drive:>\jdk1.3.1 or similar.
  1. Click OK twice to close the Properties window.
Click here for additional resources on installing the Tomcat Servlet Engine.
  1. Configure Tomcat for IIS.
DOWNLOAD CONFIGURATION FILES:
  1. Click here to download the Tomcat Connector ISAPI Redirector 1.2.15.
  2. Select the isapi_redirect.msi file and save it in a location on the machine.
INSTALL IIS REDIRECTOR FOR TOMCAT:
  1. Execute the downloaded isapi_redirect.msi installer file by double-clicking on it.
  2.  Read the License Agreement and accept it. Click Next.
  3. IMPORTANT: Change the installation location to be identical with the Tomcat installation location; for example, C:\Program Files\Apache Software Foundation\Tomcat 5.5 or C:\Tomcat5.5.
  4. Click Next to start the installation.
  5. Click Finish.
CONFIGURE IIS:
  1. Right-click 'Default Web Site' and select Properties. Continue as follows:
H1. In the dialog box, select the 'ISAPI Filters' tab.
H2. Click Add.
Note:
If there is already a filter, 'jakarta', listed, review the following and continue with step I.
H3. In the Filter Properties dialog box, enter the Filter Name: Jakarta.
H4. For the Executable, navigate to:
<Tomcat installation location>\bin\isapi_redirect.dll and click OK.
H5. Click Apply and close the Default Web Site Properties dialog box.
  1. In the IIS Management Console on the left panel of the window, navigate to Default Web Site > Jakarta.
  2. On the right panel of the window, right-click on the isapi_redirect.dll and select Properties.
  3. Select the File Security tab.
K1. Under 'Anonymous Access and Authentication Control', click the Edit button.
K2. Uncheck the 'Integrated Windows Authentication' box.
K3. Click OK twice to confirm and close the dialog boxes.

REQUIRED ON WINDOWS 2003 ONLY: WEB SERVICES EXTENSION
  1. Expand the contents in the left panel of the Internet Information Services (IIS) Management Console.
  2. Click on Web Service Extensions and verify that the Web Service Extension 'Jakarta' is listed and set to allowed. If not, select 'Add a new Web service extension' and follow these steps:
M1. Type 'Jakarta' for the Extension name.
M2. Click Add and navigate to:
<Tomcat installation location>\bin\isapi_redirect.dll. Click OK.
M3. Check 'Set extension status to Allowed' and click OK to close the dialog box.
  1. Close the IIS Management Console.
ADDITIONAL STEPS:
Update the installed isapi_redirect.dll with version 1.2.27 for Windows 32-bit machines:
  1. Download the isapi_redirect.dll version 1.2.27 from http://archive.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win32/jk-1.2.27/.
  2. Rename the existing 32-bit version of the file in the directory <Tomcat installation>\bin to isapi_redirect.OLDdll
Note:
It might be necessary to stop the IIS Admin service to be able to rename the file.
  1. Place the downloaded file in the directory <Tomcat installation>\bin.
  2. Rename the new library to isapi_redirect.dll
Continue with Step 6.

For Windows 64-bit machines:
  1. Download the 64-bit version of the isapi_redirect.dll, version 1.2.27 from http://archive.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win64/jk-1.2.27/amd64/.
  2. Rename the existing 32-bit version of the file in the directory <Tomcat installation>\bin to isapi_redirect.32bitdll
Note:
It might be necessary to stop the IIS Admin service to be able to rename the file.
  1. Place the downloaded file in the directory <Tomcat installation>\bin.
  2. Rename the downloaded 64-bit library to isapi_redirect.dll.
Continue with step 6.
  1. Restart IIS and Tomcat by going to Start > Settings > Control Panel > Administrative Tools > Services.
  1. Right-click on the 'Apache Tomcat' service and select Restart.
  2. Right-click on the 'IIS Admin' service and select Restart. Click Yes if asked to restart the other services.
  3. Verify that 'WWW Publishing Service' is started. If not, start it.
  1. Verify IIS and Tomcat were installed successfully.
  1. Open the Windows Services panel. Select the Apache Tomcat service from the list and start it, if not already started.
  2. Enter this case-sensitive URL into a browser:
http://<your_machine_name>/servlets-examples/servlet/HelloWorldExample
A page should display that says 'Hello World' if the test is successful.
Warning:  	
If this test fails, check the URL carefully for case or spelling issues. Retrace the installation steps. It may be that the URL works if 'http://<hostname>:8080/...' is specified. This only indicates that the Tomcat Web server is working on port 8080; the required redirect to IIS is failing.
  1. Return to the IIS Management Console > Default Web Site > Properties and check the ISAPI Filters tab. Verify that there is a green, upward arrow next to the Jakarta filter.
Warning:  
If there is not a green arrow next to Jakarta filter, stop and re-start the 'IIS Admin Service', including the WWW Publishing Service, from the Services panel. If that does not work, open a browser and type http://localhost to re-initialize IIS. If the Jakarta filter still fails, do not proceed further. Go back and verify the settings created in the previous steps.
  1. Return to the IIS Management Console > Default Web Site > Jakarta. Verify that the Jakarta virtual directory is set to point to the correct location on the hard drive. It needs to be the location of the isapi_redirect.dll.
  1. Install ArcIMS from the installation CD. Refer to Step 3a in the ArcIMS Installation Guide (install.htm).
  2. To configure ArcIMS and run the ArcIMS Post Installation, see Step 3b in the the ArcIMS Installation Guide.
AUTHORIZE ARCIMS
Note:
There are several options to authorize ArcIMS for use. See Step 3b in the Installation Guide for more information. The following steps are for one common option.
  1. Open a Web browser and go to http://service.esri.com.
  2. Click Product Registration and select the corresponding ArcIMS version to register the software.
  3. Enter the information requested and type the registration code in the field provided; for example, ECP123456789. The registration code is sent in an e-mail.
Note:
If a registration code for this product is not received, contact Customer Service or an International Distributor.
  1. After completing the online form, an e-mail is sent with an authorization file attached; for example, 123456789.ecp. Save the file in a directory on the ArcIMS machine.
  2. Launch the ArcIMS Post Installation and select the Typical option.
  3. Select the third option, 'I have received an authorization file...' and click Next.
  4. Browse to the file received in step D and click Next to authorize ArcIMS for use.
  5. Click Finish to exit the Software Authorization Wizard and continue with the ArcIMS Post Installation.
  6. At the Web Server-Servlet Engine Configuration dialog box, select 'IIS with Tomcat 5.5'. Click Next.
  7. Browse to the Tomcat installation directory; for example, C:\Program Files\Apache Software Foundation\Tomcat 5.5. Click Next. Click OK at the pop-up warning.
  8. Click Finish.
  1. Verify that the ArcIMS installation was successful.
  • For ArcIMS 9.2:
  1. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.
  2. Verify that the Web server protocol and Web server name are correct, including the domain and port number. The default is port 80.
Note:
On Windows XP/2003 machines, Internet Explorer sometimes does not show the host name and port number. If this is the case, right-click near the top of the window, under the address bar, and select 'Allow Blocked Content'.
  1. Test both components.
The result for Test 1 should be:
IMS v9.2.0
Build_Number=514.1916
Version=9.2.0
Test successful

The result for Test 2 should be:
Version=9.2.0
Build_Number=514.2159
Test successful
Note:
If these tests are successful, the ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly. If an error message is received, select the error number from the drop-down list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and run the Diagnostics tool again.
  • For ArcIMS 9.3:
  1. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.
  2. Verify that the Web server protocol and the Web server name are correct, including the domain and port number. The default is port 80.
Note:
On Windows XP/2003 machines, Internet Explorer sometimes does not show the host name and port number. If this is the case, right-click near the top of the window, under the address bar, and select 'Allow Blocked Content'.
  1. Test both components.
The result for Test 1 should be:
IMS v9.3.0
Build_Number=503.1916
Version=9.3.0
Test successful

The result for Test 2 should be:
Version=9.3.0
Build_Number=503.2159
Test successful
Note:	
If these tests are successful, the ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly. If an error message is received, select the error number from the drop-down list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and run the Diagnostics tool again.
  1. For additional steps for ArcIMS, refer to Step 5 in the ArcIMS Installation Guide.
For getting the ArcIMS Web ADF for the Java Platform or for the .NET Framework setup, refer to the corresponding Installation Guide.

Related Information