How To: Install IIS with Tomcat 6.0.13 using J2SE JDK 5.0 Update 13 for ArcIMS 9.3 on Windows 2000, XP, and Server 2003
Instructions provided are for the installation and configuration of IIS 6 with Tomcat 6.0.13 using J2SE Development Kit 5.0 Update 13 for 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:
- J2SE Development Kit (JDK) 5.0 Update 13
- Microsoft IIS (available as a Microsoft Windows Component on the Windows CD)
- Apache Tomcat 6.0.13
- Tomcat ISAPI Redirect files
- ArcIMS 9.3 Installation CD
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'.
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 according notes in step 5.
- Uninstall any unsupported versions of Java, Web Server, and Servlet Engine. See: How To: Uninstall ArcIMS-related third-party software on Windows
- Install Java 2 Standard Edition Development Kit version 5.0 Update 13.
A. Click J2SE Development Kit (JDK) 5.0 Update 13
to download Sun Java 2 SDK, Standard Edition, version 5.0 Update 13.
B. Click 'Download JDK'.
C. Accept the license agreement.
D. 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.
E. Run the installer after it has finished downloading.
F. Accept all of the default installation options, unless changes are required. This installs both the Java Runtime and Development Kit.
G. After the install, Navigate to Start > Settings > Control Panel > Java.
H. Click the 'Update' tab and remove the check mark for 'Check for Updates Automatically'.
I. Click Apply and close the Java Control Panel.
- Install Microsoft IIS if it is not already installed. See: How To: Install IIS 6.0 on Windows 2003
- Install Tomcat 6.0.13.
A. Click here to access the Apache Tomcat 6.0.13 Download site.
B. Click on apache-tomcat-6.0.13.exe to download the file. Save it on the local machine.
C. Navigate to the folder where the file was downloaded and double-click apache-tomcat-6.0.13.exe.
D. Click Next to continue.
E. Read the License Agreement and click 'I Agree'.
F. At the Choose Components dialog box, change the type to 'Full' install. Alternatively, add at least the features Service and Examples to the selection.
G. Click Next.
H. Select the preferred installation location; for example, the default C:\Program Files\Apache Software Foundation\Tomcat 6.0 or C:\Tomcat6.0.
I. Use the default settings in the Configuration dialog box. Create a new password for the Tomcat Administrator. Click Next.
J. 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.K. Click Install to continue. Click Finish.
SETUP OF ENVIRONMENT VARIABLES:
L. Right-click on My Computer and click Properties. Click the Advanced tab. Click on the Environment Variables button.
M. 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.
N. 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:
Note: Verify that old references to JAVA_HOME in the path variable have been removed; for example, <drive:>\jdk1.3.1 or similar.
O. Click OK twice to close the Properties window.
For additional resources on installing Tomcat, click here.
- Configure Tomcat for IIS.
DOWNLOAD CONFIGURATION FILES:
A. Click on the following link to download the configuration files for Tomcat 6.0.13:Tomcat6013_IIS_IMS93_win.zip.
INSTALL IIS REDIRECTOR FOR TOMCAT:
B. Extract the downloaded .zip file to a location on the hard drive.
C. Navigate to <Tomcat installation directory>\bin in Windows Explorer.
D. Create a new folder and name it 'win32' in the 'bin' folder.
Important: If using a 64-bit machine, create a folder 'win64' instead.E. Copy the isapi_redirect.dll from the location where it was originally extracted, to the newly created win32 folder; for example C:\Program Files\Apache Software Foundation\Tomcat 6.0\bin\win32.
Note: Important: If using a 64-bit machine, copy the file isapi_redirect_1.2.27_amd64bit.dll in the folder 'win64' and rename it to isapi_redirect.dll. Replace any paths referencing the /win32 directory with /win64 in the steps below.CONFIGURE PROPERTIES FILES:
F. Copy the files 'workers.properties.minimal' and 'uriworkermap.properties' from the temporary location (Step A) to: <Tomcat installation location>\conf.
MODIFY WEB.XML FILE:
G. Navigate to <Tomcat Installation location>\conf in Windows and open the file 'web.xml' in a text editor.
H. Search for the following text:
Code: <!-- The mapping for the invoker servlet --> <!-- <servlet-mapping> <servlet-name>invoker</servlet-name> <url-pattern>/servlet/*</url-pattern> </servlet-mapping> -->
Delete the comment lines '<!--' and '-->', so the code appears as shown in the example below:
Code: <!-- The mapping for the invoker servlet --> <servlet-mapping> <servlet-name>invoker</servlet-name> <url-pattern>/servlet/*</url-pattern> </servlet-mapping>
I. Search for the following text:
Code: <!-- <servlet> <servlet-name>invoker</servlet-name> <servlet-class> org.apache.catalina.servlets.InvokerServlet </servlet-class> <init-param> <param-name>debug</param-name> <param-value>0</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet> --> -->
Delete the comment lines '<!--' and '-->', so the code appears as shown in the example below:
Code: <servlet> <servlet-name>invoker</servlet-name> <servlet-class> org.apache.catalina.servlets.InvokerServlet </servlet-class> <init-param> <param-name>debug</param-name> <param-value>0</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet>J. Save and close the file.
K. Edit the file context.xml.
- K1. Find the file context.xml in <Tomcat installation directory>\conf and open it in a text editor.
- K2. Add the parameter 'privileged="true"' into the <Context> tag at the beginning of the file. The first two lines of the file should look like this:
Code: <!-- The contents of this file will be loaded for each web application --> <Context privileged="true">
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.
Note: The registry file is configured for Tomcat 6.0.13 installed to the default location C:\Program Files\Apache Software Foundation\Tomcat 6.0. If the installation is in a custom location, open the according file in Notepad, and make the appropriate changes to reflect the current environment.
If Tomcat is installed on a 64-bit machine, then the paths in the registry file may need to be edited to point to C:\Program Files (x86)\... Use Notepad to make the appropriate changes.
Warning: If ArcGIS Server is installed on the same machine as ArcIMS then IIS is being run in 32 bit mode. For this it is necessary to adjust the second line in the registry file to read: [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Jakarta Isapi Redirector\1.0] then save the file.
L. Double-click on the registry file Win_IMS93_IIS_Tomcat60.reg in the location where it was extracted to execute it.
M. Click Yes and OK. This should create the necessary registry keys for Tomcat.
N. Open Internet Services Manager.
O. In the left panel of the Console under Internet Information Services, expand the contents for the 'host' machine name.
Note: If a 'Jakarta' virtual directory already exists in IIS, it is possible to delete it and re-create it as follows.
P. Right-click 'Default Web Site' and select New > Virtual Directory. This opens the Virtual Directory wizard. Continue as follows:
- P1. Click Next to continue.
- P2. In the Alias box, type 'Jakarta' and click Next.
- P3. For Directory, browse to: <Tomcat installation location>\bin\win32, click OK, and click Next.
- P4. Check the box to give the permissions: Execute, for example, ISAPI applications or CGI.
- P5. Click Finish.
Q. Right-click 'Default Web Site' and select Properties. Continue as follows:
- Q1. In the dialog box, select the 'ISAPI Filters' tab.
- Q2. Click Add.
- Q3. In the Filter Properties dialog box, enter the Filter Name; for example, Jakarta.
- Q4. For the Executable, navigate to <Tomcat installation location>\bin\win32\isapi_redirect.dll and click OK.
- Q5. Click Apply and close the Default Web Site Properties dialog box.
INTEGRATED WINDOWS AUTHENTICATION
R. In IIS Manager, on the left panel of the window, navigate to Default Website > Jakarta.
S. Right-click on the isapi_redirect.dll in the right hand panel, and select properties.
T. Set the security options:
- T1. Select the File Security tab.
- T2. Click Edit for Anonymous Access and Authentication Control.
- T3. Uncheck Integrated Windows Authentication.
- T4. Click OK twice to close the properties dialog box.
<b>Windows 2003: Web Service Extensions</b>
Note: If there is already a 'Jakarta' Web Service Extension listed, it is possible to delete and re-create it as follows.U. In the Internet Information Servers Manager click on 'Web Service Extensions' on the left.
- U1: Right-click on Web Service Extensions and select 'Add a new Web Service Extension'.
- U2: In the Extension name field, type 'Jakarta'.
- U3: For Required Files, click Add and browse to the isapi_redirect.dll (e.g., at C:\Program Files\Apache Software Foundation\Tomcat 6.0\bin\win32\isapi_redirect.dll). Click OK.
- U4: Check the box for 'Set extension status to Allowed'. Click OK.
- Configure the directory permissions for IIS and Tomcat.
A. Open Windows Explorer.F. Set the following permissions for the above accounts:<div id='indent' style='padding: 0em,0em,0em,1em;'>• Read & Execute
B. Navigate to <drive>:\<Java Home Directory>.
C. Right-click the directory, and select Properties.
D. Select the Security tab.
E. Add the following accounts:<div id='indent' style='padding: 0em,0em,0em,1em;'>• Authenticated Users
• IUSR_<machinename> or IUSR
G. Navigate to the <drive>:\<Tomcat Home Directory>\bin\win32 folder.
H. Right-click the *.dll file. Select Properties.
I. Select the Security tab.
J. Add the following accounts:<div id='indent' style='padding: 0em,0em,0em,1em;'>• Authenticated Users
• IUSR_<machinename> or IUSR
K. Set the following permissions for the above accounts:<div id='indent' style='padding: 0em,0em,0em,1em;'>• Read & Execute
- Restart IIS and Tomcat by going to Start > Settings > Control Panel > Administrative Tools > Services.
A. Right-click on the 'Apache Tomcat' service and select Restart.
B. Right-click on the 'IIS Admin' service and select Restart. Click Yes if asked to restart the other services.
C. Verify that 'WWW Publishing Service' is started. If not, start it.
- Verify IIS and Tomcat were installed successfully.
A. Open the Windows Services panel. Select the Apache Tomcat service from the list and start it.
B. Enter this case-sensitive URL into a browser:
Code: http://<your_machine_name>/examples/servlets/servlet/HelloWorldExampleA page that says 'Hello World' displays if the test is successful.
Warning: If this test fails, check the URL carefully for case or spelling issues. Retrace the installation steps. The URL may work 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.C. Return to the IIS Management Console > Default Web Site > Properties. Check the ISAPI Filters tab. Verify that there is a green, upward arrow next to the Jakarta filter.
Note: This only applies to IIS 6; IIS 7 does not have a way to check if the ISAPI filter is working.
Warning: If there is not a green arrow next to the 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.D. Return to the IIS Management Console > Default Web Site > Jakarta. Verify that the Jakarta virtual directory is pointing to the correct location on the hard drive, the location of the isapi_redirect.dll.
- Install ArcIMS from the installation CD. Refer to the ArcIMS Installation Guide (install.htm), Step 3a.
- To configure ArcIMS and run the ArcIMS Post Installation, see the ArcIMS Installation Guide, Step 3b.
Note: There are several options to authorize ArcIMS for use. See the Installation Guide, step 3b for more information. The following steps are for one common option:
A. Open a Web browser and go to http://service.esri.com.
B. Click Product Registration and select the corresponding 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 is sent in an e-mail.
Note: If a registration code for this product has not been received, contact Customer Service or an International Distributor.
D. 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.
E. Launch the ArcIMS Post Installation and select the Typical option.
F. Select 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.
I. At the Web Server-Servlet Engine Configuration dialog box, select 'IIS with Tomcat 5.5.x/6.0.x'. Click Next.
J. Browse to the Tomcat installation directory; for example, C:\Program Files\Apache Software Foundation\Tomcat 6.0.
Click Next. Click OK at the pop-up warning.
K. Click Finish.
- Verify that the ArcIMS installation was successful.
A. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.
B. 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'.C. Test both components.
The result for Test 1 should be:
The result for Test 2 should be:
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 additional steps for ArcIMS, refer to the ArcIMS Installation Guide, Step 5.
For getting the ArcIMS Web ADF for the Java Platform or for the .NET Framework setup, refer to the corresponding Installation Guide.