Install IIS 4.0/5.0 with Tomcat 4.0.5 using J2SDK 1.4.0 for ArcIMS 4.0.1 on Windows

<H4>Requirements</H4>
<DIV>Instructions provided are for the installation and configuration of IIS 4 or IIS 5 with Tomcat 4.0.5 using J2SDK 1.4.0 for ArcIMS on Windows.


Specific installation information is provided in the ArcIMS Install Guide.

This installation will require the following software:
&#8226; <a href="http://java.sun.com/products/archive/j2se/1.4.0/index.html" target="_blank" >J2SDK 1.4.0</A>
&#8226; <a href="http://archive.apache.org/dist/jakarta/tomcat-4/archive/v4.0.5/bin/" target="_blank" >Jakarta Tomcat 4.0.5</A>
&#8226; ArcIMS Installation CD

A user account that has Administrator rights on the ArcIMS machine is required.</DIV>

<H4>Before Beginning</H4>
<DIV>&#8226; Familiarity with certain Windows tasks is required to install and configure ArcIMS. For details on these skills see <a href="http://support.esri.com/index.cfm?fa=knowledgebase.techArticles.articleShow;d=23714" target="_blank" >Common Windows tasks when installing ArcIMS</A>.

&#8226; For more information on the acronyms and terms used in this document, please see the <a href="http://support.esri.com/index.cfm?fa=knowledgebase.techArticles.articleShow;d=24226" target="_blank" >Glossary of terms used in ArcIMS Installation articles</A>.

&#8226; Review and follow Steps 1 and 2 from the ArcIMS Installation Guide on the CD. To open the guide, navigate to the CD in Windows and click Install.htm.

These two steps ensure the system meets the minimum requirements and assist in planning the ArcIMS site configuration. </DIV>

<H4>Procedure</H4>
<DIV>You don't need to uninstall ArcIMS 3.1 or ArcIMS 4.0 to install ArcIMS 4.0.1. The setup program for ArcIMS 4.0.1 on Windows will remove the previously installed versions.

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


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/warn.gif"> A supported Web server and Servlet Engine must be properly installed and configured before running the setup program for ArcIMS 4.0.1. </DIV>



<OL>
<LI>Uninstall any unsupported versions of JDK/JRE, Web server and Servlet Engine.
<LI>Install J2SDK 1.4.0. <a><NOBR>-show me-</NOBR></A>
<DIV>

<TABLE align=center border=0 cellPadding=2 cellSpacing=0 width="75%">

<TR>
<TD class=tdWhite>
<DIV>A. Click <a href="http://java.sun.com/products/archive/j2se/1.4.0/index.html" target="_blank" >J2SDK 1.4.0</A> to download Sun Java 2 SDK, Standard Edition, version 1.4.0.

B. Click DOWNLOAD in the SDK column next to the option: Windows (all languages, including English).

C. Accept the license agreement; click 'Download j2sdk-1_4_0-win.exe'.

D. Run the program after it has finished downloading.

E. Accept all the installation program defaults unless needing to change them.</DIV></TD></TR>
<TR>
<TD class=tdWhite>
<DIV></DIV></TD></TR></TABLE></DIV>
<LI>Install IIS Web server, if not already installed. <a><NOBR>-show me-</NOBR></A>
<DIV>

<TABLE align=center border=0 cellPadding=2 cellSpacing=0 width="75%">

<TR>
<TD class=tdWhite>
<DIV>A. Click Start > Settings > Control Panel > Add/Remove Programs.

B. In the left panel, click Add/Remove Windows Components.

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

D. At the Completing the Windows Components Wizard screen, click Finish.

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

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


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/note.gif"> <a href="http://support.esri.com/index.cfm?fa=knowledgebase.techArticles.articleShow;d=25344" target="_blank" >Click here</A> for additional resources on installing Microsoft's IIS Web Server.</DIV>
</DIV></TD></TR>
<TR>
<TD class=tdWhite>
<DIV></DIV></TD></TR></TABLE></DIV>

<LI>Install Tomcat 4.0.5. <a><NOBR>-show me-</NOBR></A>
<DIV>

<TABLE align=center border=0 cellPadding=2 cellSpacing=0 width="75%">

<TR>
<TD class=tdWhite>
<DIV>A. Click <a href="http://archive.apache.org/dist/jakarta/tomcat-4/archive/v4.0.5/bin/" target="_blank" >Tomcat 4.0.5 download site</A>, select 'jakarta-tomcat-4.0.5.exe' to download the file saving it to your local machine.

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

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

D. Read, then click 'I Agree' on the License Agreement.

E. Check NT Service on the Installation Options page. Click Next.

F. Type '<drive>:\Tomcat4' for the installation directory.


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/warn.gif"> Do not install Tomcat under Program Files or other paths containing spaces because this may cause problems.</DIV>
G. Click Install.

H. Click Close to complete the installation.

SET ENVIRONMENT VARIABLES:

I. Navigate to your Environment Variables.

J. Under System Variables, click New. For Variable Name, type JAVA_HOME. Note: this is case sensitive. For Variable value, type the path where you installed the Java 2 SDK; for example <drive>:\j2sdk1.4.0, and click OK.

K. Create another system environment variable called CATALINA_HOME. Note: this is case sensitive. For Variable value, type the path where you installed Jakarta-Tomcat-4.0.5; for example <drive>:\Tomcat4, and click OK.

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


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/warn.gif"> Make sure you do not have old references to JAVA_HOME; for example, <drive:>\jdk1.2, in the Path variable.</DIV>
M. Click OK twice to close the Properties window.</DIV></TD></TR>
<TR>
<TD class=tdWhite>
<DIV></DIV></TD></TR></TABLE></DIV>
<LI>Configure Tomcat 4.0.5 with IIS. <a><NOBR>-show me-</NOBR></A>
<DIV>

<TABLE align=center border=0 cellPadding=2 cellSpacing=0 width="75%">

<TR>
<TD class=tdWhite>
<DIV>INSTALL IIS REDIRECTOR FOR TOMCAT:

A. In Windows Explorer, navigate to the folder: <drive>:\Tomcat4\bin.

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

C. Click <a href="http://archive.apache.org/dist/jakarta/tomcat-4/archive/v4.0.3/bin/win32/isapi_redirector.dll" target="_blank" >isapi_redirector.dll</A> to download the file.

D. Save the isapi_redirector.dll file int <drive>:\Tomcat4\bin\win32.


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/warn.gif"> Note that the spelling of the required file is: isapi_redirector.dll. Jakarta-Tomcat 3.x.x used a different file called isapi_redirect.dll; this file is not compatible.</DIV>
DOWNLOAD PROPERTIES FILES:

E. Click <a href="http://downloads.esri.com/support/techarticles/IMS/tomcat%20405%20Windows/worker.properties" target="_blank" >worker.properties</A> to download the file.

F. Open an empty document in Notepad. Copy and paste the contents of the worker.properties file into the empty document.


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/warn.gif"> You must 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.</DIV>
G. Ensure that the 'java_home' and 'tomcat_home' variables have been set correctly. For example: worker.tomcat_home=<drive>:\Tomcat4
worker.java_home=<drive>:\j2sdk1.4.0


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/note.gif"> Ensure that these paths accurately reflect your current set-up environment</DIV>
H. Save the file in: <drive>:\Tomcat4\conf folder as "worker.properties" (quotes included) and specify 'All File Types' before saving.

I. Click <a href="http://downloads.esri.com/support/techArticles/uriworkermap.properties" target="_blank" >uriworkermap.properties</A> to download the file.

J. Open an empty document in Notepad. Copy and paste the contents of the uriworkermap.properties file into the empty document.


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/warn.gif"> Again, you must 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.</DIV>
K. Save the file in: <drive>:\Tomcat4\conf folder as "uriworkermap.properties" (quotes included) and specify 'All File Types' before saving.

CONFIGURE THE REGISTRY:

&#8226; If you are using Windows NT - Click <a href="http://downloads.esri.com/support/techArticles/IMS/tomcat%20405%20Windows/WinNT_Tomcat4.reg" target="_blank" >WinNT_Tomcat4.reg</A> to download the file.

&#8226; If you are using Windows 2000 or XP - Click <a href="http://downloads.esri.com/support/techArticles/IMS/tomcat%20405%20Windows/Win2000_XP_Tomcat4.reg" target="_blank" >Win2000_XP_Tomcat4.reg
</A>to download the file.


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/note.gif"> The above files are intended to work with a default installation of Tomcat 4.0.5 in C:\Tomcat4. If you changed drives or the installation directory, please open this file in Notepad, and make the appropriate changes to reflect your current environment.</DIV>
L. Double-click on the registry file (*.reg) that you downloaded to execute it. Click Yes, then OK. This should create the necessary registry keys for Tomcat.

CREATE JAKARTA VIRTUAL DIRECTORY:

M. Open Internet Services Manager.

N. In the left panel of the Console, under Internet Information Services, expand the contents for your "*host" machine name.

O. Right-click Default Web Site and select New > Virtual Directory. This opens the Virtual Directory wizard. Continue through these steps:
O1. Click Next.
O2. In the Alias box, type "Jakarta" and click Next.
O3. For Directory, browse to <drive>:\Tomcat4\bin\win32 and click OK, then Next.
O4. Check the box to engage 'Execute (such as ISAPI applications or CGI)' permissions.
O5. Click Finish.

P. Right-click 'Default Web Site' and select Properties.
P1. In the dialog box, select the 'ISAPI Filters' tab.
P2. Click Add.
P3. In the Filter Properties dialog box, enter the Filter Name as 'Jakarta'.
P4. For the Executable, browse t <drive>:\Tomcat4\bin\win32\isapi_redirector.dll and click OK.
P5. Click Apply and close the Default Web Site Properties dialog box.

Q. Stop and Start IIS; ensure the Default Web Site is selected.

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


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/warn.gif"> 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 G.</DIV>
S. Close Internet Services Manager.

VERIFY TOMCAT INSTALLATION:

T. Copy the 'SnoopServlet.class' and 'SnoopServlet.java' files from <drive>:\Tomcat4\webapps\examples\WEB-INF\classes into <drive>:\Tomcat4\classes location.

U. Open the Services panel. Select the 'Apache Tomcat' service from the list and stop it, if it is not already stopped, and start it.

V. Enter the following into a browser. Note: code is case sensitive.

<DIV ><PRE >http://<your_machine_name>/servlet/SnoopServlet</PRE></DIV>
A page with various parameters will eventually display if the test is successful. It may take a few seconds to load completely.

X. Enter the following into a browser. Note: Code is case sensitive.

<DIV ><PRE >http://<your_machine_name>/examples/servlet/HelloWorldExample</PRE></DIV>
A page should display that says "Hello World" if the test is successful.


<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/warn.gif"> If either of the above tests fail, recheck your installation steps. You may find that these two test URLs work if you specify 'port 8080' in the URL. This only indicates that the Tomcat web server is working; the required redirect to IIS is failing. Do not proceed to install ArcIMS. </DIV>
</DIV></TD></TR>
<TR>
<TD class=tdWhite>
<DIV></DIV></TD></TR></TABLE></DIV>
<LI>Install ArcIMS 4.0.1 from the installation CD. In the ArcIMS Installation Guide, see Step 3a.
<LI>Run the ArcIMS Post Installation to configure ArcIMS 4.0.1 with IIS and Tomcat. In the ArcIMS Installation Guide, see Step 3b. <a><NOBR>-show me-</NOBR></A>
<DIV>

<TABLE align=center border=0 cellPadding=2 cellSpacing=0 width="75%">

<TR>
<TD class=tdWhite>
<DIV>A. Select the Typical Post Installation Option.

B. When you reach the Web Server-Servlet Engine Configuration, select Microsoft IIS for your Web server.

C. Select Tomcat for your Servlet Engine.

D. Enter the path where you installed Tomcat 4.0.5. For Example: <drive>:\Tomcat4.</DIV></TD></TR>
<TR>
<TD class=tdWhite>
<DIV></DIV></TD></TR></TABLE></DIV>
<LI>Verify that the ArcIMS installation was successful. <a><NOBR>-show me-</NOBR></A>
<DIV>

<TABLE align=center border=0 cellPadding=2 cellSpacing=0 width="75%">

<TR>
<TD class=tdWhite>
<DIV>A. Click Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics. The ArcIMS Diagnostics page displays.

B. Ensure 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 v4.0.1
Build_Number=630.1463
Version=4.0.1
Test successful

The result for test 2 should be:

Version=4.0.1
Build_Number=630.1700
Test successful



<DIV ><IMG src="http://support.esri.com/common/style/graphics/icons/note.gif"> 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 dropdown list and click View. The error number and a description display will. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.</DIV>
</DIV></TD></TR>
<TR>
<TD class=tdWhite>
<DIV></DIV></TD></TR></TABLE></DIV>
<LI>For the final step required to get ArcIMS running, see the ArcIMS 4.0.1 Installation Guide, Step 5: "Configure ArcIMS". </LI></OL></DIV>

<P><I>Created:</I> 12/13/2002
<I>Last Modified:</I> 6/9/2004</P>
<SCRIPT language=javascript type=text/javascript>
 function openWindow(url, features){
  comment=window.open(url,'feedback',features);
 }
</SCRIPT>

<P>有点难看了</P>