How To: Install IIS 7 with Tomcat 6.0.13 using J2SE JDK 5.0 Update 13 for ArcIMS 9.3 on Windows Vista and Server 2008
Instructions provided describe the steps for the installation and configuration of IIS 7 with Tomcat 6.0.13 using J2SE Development Kit 5.0 Update 13 for ArcIMS 9.3 on Windows Vista and Server 2008.
Specific information for the installation of ArcIMS is included with the product's Install Guide.
This installation requires the following software:
- 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
Note: A user account that has Administrator rights on the ArcIMS machine is required.
- 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'.
Previous versions of ArcIMS must be uninstalled before proceeding. The setup program for ArcIMS on Windows prompts for the removal of previously installed versions.
If ArcIMS components were distributed among several computers, it is recommended to first remove the components on each computer before continuing by going to Add/Remove Programs and selecting Remove for ArcIMS.
Warning: If ArcGIS Server is already installed and running on the same machine where ArcIMS will be installed, then IIS is being run in 32-bit mode. Please follow steps for 32-bit installation.
- Uninstall any unsupported versions of Java, Web Server, and Servlet Engine. Please refer to How To: Uninstall ArcIMS-related third-party software on Windows.
- Install J2SE Development Kit (JDK) 5.0 Update 13.
Warning: The version of Tomcat that is used in reference to this article is 32-bit, thus the 32-bit version of Java must be used (including 64-bit machines as well).
- Install Microsoft IIS if it is not already installed.
- Navigate to Start > Control Panel > Programs and Features.
- Click 'Turn Windows features on or off' on the left.
- Click the box next to Internet Information Services to enable it.
- Expand Internet Information Services by clicking the '+' symbol.
- Expand Web Management Tools and select the box next to IIS 6 Management Compatibility, and expand it. Check the box next to IIS Metabase and IIS 6 Configuration Compatibility.
- Expand World Wide Web Services, and expand Application Development Features.
- Click the boxes next to ASP, ISAPI Extensions and ISAPI Filters.
- Install IIS for Windows 2008 Server. Refer to How To: Install IIS on Windows 2008 or Vista for more information.
- Install Tomcat 6.0.13.
- Click here to access the Apache Tomcat 6.0.13 Download site.
- Click on apache-tomcat-6.0.13.exe to download the file. Save it on the local machine.
- Navigate to the folder where the file was downloaded and double-click apache-tomcat-6.0.13.exe.
- Click Next to continue.
- Read the License Agreement and click 'I Agree'.
- At the Choose Components dialog box, change the type to 'Full' install. Alternatively, add at least the features Service and Examples to the selection. Click Next.
- Select the preferred installation location; for example, the default C:\Program Files\Apache Software Foundation\Tomcat 6.0 or C:\Tomcat6.0.
- Use the default settings in the Configuration dialog box. Create a new password for the Tomcat Administrator. Click Next.
- 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.
- Click Install to continue. Click Finish.
Setup of Environment Variables:
- Right-click on My Computer and click Properties. Click the Advanced tab. Click on the Environment Variables button.
- 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.
- 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, \jdk1.3.1 or similar.
- Click OK twice to close the Properties window.
For additional resources on installing Tomcat, click here.
- Configure Tomcat for IIS.
- Download the configuration files for Tomcat: 6.0.13:Tomcat6013_IIS_IMS93_win.zip.
- Extract the downloaded .zip file to a location on the hard drive.
- Navigate to <Tomcat installation directory>\bin in Windows Explorer.
- Create a new folder, and name it 'win32' in the bin folder.
Important: If using a 64-bit machine, create a folder 'win64' instead.
- Copy the isapi_redirect.dll from the location where it was originally extracted, to the newly created win32 folder; for example, <Tomcat installation location>\win32.
Note: If using a 64-bit machine, copy the file isapi_redirect_1.2.27_amd64bit.dll to the 'win64' folder and rename it isapi_redirect.dll.
Configure the properties files
Important: If using a 64-bit machine, replace any paths referencing the /win32 directory with /win64 in the steps below.
- Copy the files 'workers.properties.minimal' and 'uriworkermap.properties' from the temporary location, from step A, to <Tomcat installation location>\conf.
Modify the web.xml file
- Navigate to <Tomcat Installation location>\conf, and open the file 'web.xml' in a text editor.
- 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> -->Delete the comment lines '<!--' and '-->,' so the code appears as shown below:
<!-- The mapping for the invoker servlet --> <servlet-mapping> <servlet-name>invoker</servlet-name> <url-pattern>/servlet/*</url-pattern> </servlet-mapping>
- Search for the following text:
<!-- <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 below:
<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>
- Save and close the file.
- Edit the file 'context.xml.'
Configure the registry
Warning: It is recommended that you backup your operating system and files, including the registry, before proceeding. The instructions below include making changes to essential parts of your operating system. 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 file Win_IMS93_IIS_Tomcat60.reg is configured for Tomcat 6.0.13 installation at the location C:\Program Files\Apache Software Foundation\Tomcat 6.0. If Tomcat was installed to C:\Program Files (x86)\... or a custom location, open the file in Notepad, and make the appropriate changes to reflect the installation location.
Note: If ArcGIS Server is installed on the same machine as ArcIMS, then IIS is being run in 32-bit mode. In this case, it is necessary to adjust the second line in the registry file to read:
Code: [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Jakarta Isapi Redirector\1.0]
- Find the file 'context.xml' in <Tomcat installation directory>\conf, and open it in a text editor.
- 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:
<!-- The contents of this file will be loaded for each web application --> <Context privileged="true">
- Save and close the file.
- Double-click the registry file Win_IMS93_IIS_Tomcat60.reg in the location where it was extracted to execute it.
- Click Yes and OK. This creates the necessary registry keys for Tomcat.
- Open Internet Services Manager.
- Under Internet Information Services, expand the contents of the host machine name.
- If a Jakarta virtual directory already exists in IIS, delete it.
- Create, or re-create, a Jakarta virtual directory as follows:
- Right-click Default Web Site, and select Add Virtual Directory. This opens the Virtual Directory wizard.
- In the Alias box, type Jakarta.
- For Physical Path, browse to <Tomcat installation location>\bin\win32. Click OK.
- Add Jakarta ISASPI filters as follows:
Integrated Windows authentication
- Click Default Web Site, and from the list on the right, double-click ISAPI Filters.
- In the top right of the screen, select Add....
- Type Jakarta for the Filter name.
- For the Executable, navigate to <Tomcat installation location>\bin\win32\isapi_redirect.dll.
- Click OK.
- In IIS Manager on the left, navigate to and click Default Website, double-click Authentication, and click Anonymous Authentication. Verify that it is enabled.
- Navigate back to Default Website, expand it, and select Jakarta. Double-click Authentication from the middle panel. Click Anonymous Authentication. Verify that it is enabled.
- Click Jakarta. Double-click Handler Mappings. If ISAPI.dll is disabled, select Edit Feature permissions, and enable Execute.
Add ISAPI restriction
Note: This is equivalent to setting up a Web Service Extension in IIS 6.
- Add an ISAPI restriction as follows:
- Under Connections on the top left, click the host name of the machine.
- From the IIS list on the right, double-click ISAPI and CGI Restrictions.
- In the top right of the screen, select Add.
- For Description, type Jakarta.
- For the ISAPI path, navigate to <Tomcat installation location>\bin\win32\isapi_redirect.dll.
- Check the box to Allow extension path to execute.
- Click OK.
- Configure the directory permissions for IIS5 and Tomcat.
- Restart IIS and Tomcat by going to Start > Settings > Control Panel > Administrative Tools > Services.
- Right-click on the 'Apache Tomcat' service and select Restart.
- Right-click on the 'IIS Admin' service and select Restart. Click Yes if asked to restart the other services.
- Verify that 'WWW Publishing Service' is started. If not, start it.
- Verify IIS and Tomcat were installed successfully.
- Open the Windows Services panel. Select the Apache Tomcat service from the list and start it.
- Enter this case-sensitive URL into a browser:
Code: http:///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://:8080/...' is specified. This only indicates that the Tomcat Web server is working on port 8080; the required redirect to IIS is failing.
- 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.
- 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:
- Open a Web browser and go to http://service.esri.com.
- Click Product Registration and select the corresponding ArcIMS version to register the software.
- 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.
- 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.
- Launch the ArcIMS Post Installation and select the Typical option.
- Select the third option, 'I have received an authorization file...' and click Next.
- Browse to the file received in step D and click Next to authorize ArcIMS for use.
- Click Finish to exit the Software Authorization Wizard and continue with the ArcIMS Post Installation.
- At the Web Server-Servlet Engine Configuration dialog box, select 'IIS with Tomcat 5.5.x/6.0.x'. Click Next.
- 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.
- Click Finish.
- Verify that the ArcIMS installation was successful. See How To: Run Diagnostics for ArcIMS 9.3 or 10 for more information.
- For additional steps for ArcIMS, refer to the ArcIMS Installation Guide, step 5.
To obtain the ArcIMS Web ADF for the Java Platform or for the .NET Framework setup, refer to the corresponding Installation Guide.