You are here:

Browse Path: ArcIMS > Installation > Web Server / Servlet Engine > Windows > IIS

Install: Install IIS 4.0/5.0 with Tomcat 4.1.29 using J2SDK 1.4.2 for ArcIMS 9.0 on Windows NT/2000/XP

Article ID:	26148
Software:	ArcIMS 9.0
Platforms:	Windows NT 4.0, 2000, XP

Requirements

Instructions provided are for the installation and configuration of IIS 4 or IIS 5 with Tomcat 4.1.29 using Java 2 SDK, version 1.4.2 for ArcIMS 9.0 on Windows NT/2000/XP.

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

This installation requires the following software:
• A Windows based server
• Java 2 SDK, Standard Edition Version 1.4.2
• Microsoft IIS 4/5
• Jakarta Tomcat 4.1.29
• ArcIMS Installation CD

A user account that has Administrator rights on the ArcIMS machine is required.

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

ArcIMS 3.1, 4.0 or 4.0.1 must be uninstalled to install ArcIMS 9.0. The setup program for ArcIMS 9.0 on Windows will prompt for the removal of previously installed versions.

If ArcIMS components were distributed among several computers, it is recommended the uninstall program be manually run on each computer.

A supported Web server and Servlet Engine must be properly installed and configured before running the setup program for ArcIMS 9.0.

Uninstall any unsupported versions of JDK/JRE, Web server and Servlet Engine. -show me-

Summary

The following is a list of documents for uninstalling third-party software used in conjunction with ArcIMS on Windows. The documentation pertains to Web server and servlet engine versions that are supported for use with ArcIMS. For uninstalling other Web server and servlet engine software products, review the according third-party documentation.

Procedure

ServletExec:

New Atlanta's ServletExec Documentation
%ArcIMSDVD%\ServletExec\ServletExec_Installation_Guide.pdf
%ArcIMSDVD%\ServletExec\ServletExec_User_Guide.pdf

Apache Tomcat:

Apache Tomcat Documentation

Apache Web Server:

Apache Web Server Documentation

JRun:

Adobe JRun Documentation

IIS:

Uninstalling IIS

WebLogic Web Server:

BEA WebLogic Documentation

Java SE Development Kit:

Java SE Documentation

JBoss:

JBoss Documentation

Oracle Application Server:

Oracle Documentation

Sun Java System Application Server:

Sun Java System Application Server Documentation

Sun Java System Web Server:

Sun Java System Web Server Documentation

WebSphere Application Server:

WebSphere Application Server Documentation

Install J2SDK 1.4.2. -show me-

A. Click J2SDK 1.4.2 to download Sun Java 2 SDK, Standard Edition, version 1.4.2.

B. Click 'Download' in the SDK column for the Windows version.

C. Accept the license agreement.

D. Click on Windows Offline Installation, the first option, to download j2sdk-1_4_2-windows-i586.exe.

E. Run the program after it has finished downloading.

F. Accept all of the installation program defaults, unless changes are required.

Install IIS Web server, if it is not already installed. -show me-

A. Click Start > Settings > Control Panel > Add/Remove Programs.

B. Click Add/Remove Windows Components in the left panel.

C. Check the box next to Internet Information Services (IIS) in the Windows Components screen, and click Next.

D. Click Finish at the 'Completing the Windows Components Wizard' screen.

E. Verify that IIS is installed by opening Internet Service Manager.

F. Expand the directory tree under the machine name in the left panel. 'Default Web Site' should be listed; this is the Web server host used for ArcIMS.

Click here for additional resources on installing Microsoft's IIS Web Server.

Install Tomcat 4.1.29. -show me-

A. Download and install Tomcat 4.1.29 using the following link: Jakarta Tomcat 4.1.29 Download site

B. Click on 'jakarta-tomcat-4.1.29.exe' to download the file and save it on the local machine.

C. Navigate to the folder where the file was downloaded and double-click 'jakarta-tomcat-4.1.29.exe'.

D. Click OK to confirm the correct Java Development Kit.

E. Read the License Agreement and click 'I Agree'.

F. Check the NT Service on the Installation Options page and click Next.

G. Type <drive>:\Tomcat4129 for the installation directory.

Do not install Tomcat under Program Files, or other paths with spaces, or problems may occur.

H. Click Install.

I. At the Test Install Setup screen, use the default settings. Enter a password for Tomcat Administration and click Next.

J. Click Close to complete the installation.

SET ENVIRONMENT VARIABLES:

K. Navigate to the Windows Environment Variables. Consult Windows Help for assistance.

L. Under System Variables, Click New. For the Variable Name, type: JAVA_HOME

This is case-sensitive.

For Variable value, type the path where Java 2 SDK is installed; for example: <drive>:\j2sdk1.4.2, and click OK.

M. Create another system environment variable called CATALINA_HOME

This is case-sensitive.

For Variable value, type the path where Jakarta Tomcat 4.1.29 is installed; for example: <drive>:\Tomcat4129, and click OK.

N. While in the System Variables panel, scroll to Path, select it and click Edit. In the Variable Value text box, append the following to the end of the text, including the leading semi-colon:
;%JAVA_HOME%\bin

Verify that old references to JAVA_HOME; for example, <drive:>\jdk1.3.1 or similar, in the path variable have been removed.

O. Click OK twice to close the Properties window.

Click Here for additional resources on installing the Tomcat Servlet Engine.

Configure Tomcat 4.1.29 with IIS 4/5. -show me-

DOWNLOAD CONFIGURATION FILES

A. Click on the following link to download the configuration files needed for IIS and Tomcat: Tomcat4129_IIS_IMS9_win.zip

B. Extract the downloaded .zip file to a location on the harddrive.

INSTALL IIS REDIRECTOR FOR TOMCAT:

C. In Windows Explorer, navigate to <drive>:\Tomcat4129\bin.

D. Within the 'bin' folder, create a new folder and name it 'win32'.

E. Copy the isapi_redirector.dll from the location where it was originally extracted, to the newly created win32 folder; for example <drive>:\Tomcat4129\bin\win32.

CONFIGURE PROPERTIES FILES:

F. In a text editor, open the 'worker.properties' file from the temporary location.

Use Notepad to edit the properties files. Using other text editors for this step may cause a '404 Error, File not found' later in the installation.

G. Verify that the 'worker.java_home' and 'worker.tomcat_home' variables have been set correctly. For example:

worker.tomcat_home=<drive>:\Tomcat4129

worker.java_home=<drive>:\j2sdk1.4.2

Make sure these paths accurately reflect the current set-up environment.

H. Save and close the file.

I. Copy both 'worker.properties' and 'uriworkermap.properties' from the temporary location and paste them into the directory:

<drive>:\Tomcat4129\conf

MODIFY WEB.XML FILE

J. In Windows, navigate to <drive>:\Tomcat4129\conf, and open the file 'web.xml' in a text editor.

K. Search for the following text:

<!-- The mapping for the invoker servlet -->

<!--

<servlet-mapping>

    <servlet-name>invoker</servlet-name>

    <url-pattern>/servlet/*</url-pattern>

</servlet-mapping>

-->

L. Delete the comment lines '', so the code appears as shown in the example below:

<!-- The mapping for the invoker servlet -->



<servlet-mapping>

    <servlet-name>invoker</servlet-name>

    <url-pattern>/servlet/*</url-pattern>

</servlet-mapping>

M. Save and close the file.

CONFIGURE THE REGISTRY:

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.

The registry files extracted from the downloaded .zip file are intended to work with a default installation of Tomcat 4.1.29 in C:\Tomcat4129. If the drives or the installation directory was changed, open the according file in Notepad, and make the appropriate changes to reflect the current environment.

N. Double-click on the registry file (*.reg) in the location where it was extracted to execute it.
• For Windows NT - click WinNT_IMS90_Tomcat4129.reg
• For Windows 2000 or XP - click Win200x_XP_IMS90_Tomcat4129.reg

O. Click Yes, then OK. This should create the necessary registry keys for Tomcat.

CREATE JAKARTA VIRTUAL DIRECTORY:

P. Open Internet Services Manager.

Q. In the left panel of the Console, under Internet Information Services, expand the contents for the '*host' machine name.

R. Right-click 'Default Web Site' and select New > Virtual Directory. This opens the Virtual Directory wizard. Continue as follows:
R1. Click Next to continue.
R2. In the Alias box, type 'Jakarta' and click Next.
R3. For Directory, browse to: <drive>:\Tomcat4129\bin\win32, click OK, then click Next.
R4. Check the box to give the permissions: Execute, for example, ISAPI applications or CGI.
R5. Click Finish.

S. Right-click 'Default Web Site' and select Properties. Continue as follows:
S1. In the dialog box, select the 'ISAPI Filters' tab.
S2. Click Add.
S3. In the Filter Properties dialog box, enter the Filter Name, for example, Jakarta.
S4. For the Executable, navigate to <drive>:\Tomcat4129\bin\win32\isapi_redirector.dll and click OK.
S5. Click Apply and close the Default Web Site Properties dialog box.

T. Stop and Start IIS, ensuring that the Default Web Site is selected.

U. Return to the ISAPI Filters tab and ensure that there is a green, upward arrow next to the Jakarta filter.

If there is not a green arrow next to Jakarta filter, try stopping and re-starting the 'IIS Admin Service', including the WWW Publishing Service, from the Services panel. If the Jakarta filter still fails, do not proceed further. Go back and check the registry entries created in Step M.

INTEGRATED WINDOWS AUTHENTICATION

V. In IIS Manager, on the left panel of the window, navigate to Default Website > Jakarta.

W. Right-click on the Jakarta virtual directory and select properties.

X. Select the File Security tab.
X1. Click Edit for Anonymous Access and Authentication Control.
X2. Uncheck Integrated Windows Authentication.
X3. Click OK.
X4. Click OK again.

Close Internet Services Manager.

Verify that the configuration of Tomcat was successful -show me-

A. Open the Windows services panel. Select the Apache Tomcat 4.1 service from the list and start it, if not already started.

B. Enter the following test URL into a browser.

http://<your_machine_name>/examples/servlet/HelloWorldExample

This URL is case-sensitive.

A page should display that says "Hello World" if the test is successful.

If this test fails, retrace the installation steps. It may be that the URL works if 'port 8080' is specified. This only indicates that the Tomcat Web server is working; the required redirect to IIS is failing. Do not proceed to install ArcIMS.

C. In the Internet Services Manager, Right-click on Default Web Site, choose Properties and click on the ISAPI Filters tab. Verify that there is a green, upward arrow next to the Jakarta filter.

If there is not a green arrow next to Jakarta filter, try stopping and re-starting the 'IIS Admin Service' and 'WWW Publishing Service' from the Services panel. If the Jakarta filter still fails, do not proceed further. Go back and check the registry entries created in Step 5M.

Install ArcIMS 9.0 from the installation CD. In the ArcIMS Installation Guide, see Step 3a.

Run the ArcIMS Post Installation to configure ArcIMS 9.0 with IIS and Tomcat 4.1.29. In the ArcIMS Installation Guide, see Step 3b. -show me-

Stop the Tomcat service before continuing, or difficulties may arise during the Post Installation.

AUTHORIZE ARCIMS

There are several options to authorize ArcIMS for use. Please see the Installation Guide, Step 3b for more information. The following steps cover one common option.

A. Open a web browser and go to http://service.esri.com

B. Click Product Registration and choose the according ArcIMS version to register the software.

C. Enter the information requested and type the registration code in the field provided, for example ECP123456789. The registration code should have been sent in an e-mail.

If you did not receive a registration code for this product please contact Customer Service. Customers outside the USA should contact their ESRI International Distributor.

D. An email will be sent with an authorization file attached, for example 123456789.ecp. Save the file in a directory on the ArcIMS machine.

E. Launch the ArcIMS Post Installation and choose the Typical option.

F. Choose the third option 'I have received an authorization file...' and click Next.

G. Browse to the file received in Step D and click Next to authorize ArcIMS for use.

H. Click Finish to exit the Software Authorization Wizard and continue with the ArcIMS Post Installation.

CONFIGURE ARCIMS

I. At the Web Server-Servlet Engine Configuration dialog box, select 'IIS with Tomcat 4.1.xx. Click Next.

J. For the Servlet Engine Directory, enter the path where Tomcat was installed, for example: <drive>:\Tomcat4129

K. Click Next.

L. Click OK. The Web Server / Servlet engine configuration may take a few minutes to complete.

M. Finish the Post Installation.

N. Restart IIS and Tomcat in the Windows services panel.

Verify that the ArcIMS installation was successful. -show me-

A. Click Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics. The ArcIMS Diagnostics page displays.

B. Verify the Web server protocol and Web server name are correct, including the domain and port number. The default is port 80.

C. Test both components. The result for test 1 should be:

IMS v9.0.0
Build_Number=871.1714
Version=9.0.0
Test successful

The result for test 2 should be:

Version=9.0
Build_Number=871.1957
Test successful

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 in 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 try the Diagnostics tool again.

For the final step to get ArcIMS running, refer to the ArcIMS Installation Guide, Step 5: "Configure ArcIMS".

Related Information

Configuration files for IIS with Tomcat 4.1.29 for ArcIMS 9.0
No green arrow for Jakarta ISAPI filter when configuring Tomcat with IIS 6.0
When configuring Tomcat with IIS6 for ArcIMS, one of the steps is to add an ISAPI Filter called 'Jakarta' in the Properties dialog of the Internet Services Manager on Windows 2003. After a restart of IIS, there should be a green arrow for the adde...
Tomcat.exe - Application Error when running the ArcIMS Post Installation
During the ArcIMS Post Installation, after you click Next on the dialog box for the Web server - servlet engine configuration, an error message may occur: "Tomcat.exe - Application Error"
Java Viewer and Manager does not load successfully when using JRE 1.4.2_01 or later versions
Any combination of the following problems or errors may indicate that the Java Custom or Standard Viewer is not successfully loading due to the use of JRE version 1.4.2_01 or later: {PRE}- No toolbar - No overview map - Error in the browser win...
Java Viewer and Manager does not load successfully when using JRE 1.4.2_01 or later versions
Any combination of the following problems or errors may indicate that the Java Custom or Standard Viewer is not successfully loading due to the use of JRE version 1.4.2_01 or later: {PRE}- No toolbar - No overview map - Error in the browser win...

Created: 1/13/2004
Last Modified: 12/29/2008