You are here:
- Support Home >
- Knowledge Base >
- Technical Articles >
- Article Detail
Install: Install Apache 2.0.48 with Tomcat 5.0.28 with mod_jk2 using J2SDK 1.4.2_06 for ArcIMS 9.1 on Windows 2000/XP
| Article ID: | 29096 |
|---|---|
| Software: | ArcIMS 9.1 |
| Platforms: | Windows 2000, XP |
Requirements
Instructions provided are for the installation and configuration of Apache 2.0.48 with Tomcat 5.0.28 with mod_jk2 using Java 2 SDK, v. 1.4.2_06 for ArcIMS 9.1 on Windows 2000/XP.
Specific information for the installation of ArcIMS is included with the product's Install Guide.
This installation will require the following software:
• A Windows based server
• Java 2 SDK Version 1.4.2_06
• Apache 2.0.48 Web Server
• Tomcat 5.0.28
• ArcIMS 9.1 Installation CD
A user account that has administrative privileges on the ArcIMS machine is required.
Specific information for the installation of ArcIMS is included with the product's Install Guide.
This installation will require the following software:
• A Windows based server
• Java 2 SDK Version 1.4.2_06
• Apache 2.0.48 Web Server
• Tomcat 5.0.28
• ArcIMS 9.1 Installation CD
A user account that has administrative privileges 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'.
• 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, 4.0.1 or 9.0 must be uninstalled to install ArcIMS 9.1. The setup program for ArcIMS 9.1 on Windows prompts for the removal of previously installed versions.
If ArcIMS components are 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.1.
If ArcIMS components are 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.1.- Uninstall any unsupported versions of J2DK/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 Java 2 SDK, Standard Edition Version 1.4.2_06.
-show me- A. Click J2SDK 1.4.2_06 to download Sun Java 2 SDK, Standard Edition, version 1.4.2_06.
B. Click 'Download J2SDK'.
C. Accept the license agreement.
D. Click on the download link for the Windows Offline Installation Multi-Language. The file j2sdk-1_4_2_06-windows-i586-p.exe is downloaded.
E. Run the program after it has finished downloading.
F. Accept all of the default installation options, unless changes are required. - Install Apache 2.0.48 Web server.
-show me- A. Click Apache Web server version 2.0.48 and download the file 'apache_2.0.48-win32-x86-no_ssl.msi'.
B. Navigate to the folder where the file was downloaded and double-click it to run the installation.
C. At the 'Welcome' screen, click Next.
D. At the License Agreement screen, read and accept the terms of the license agreement. Click Next.
E. At the 'Read This First' screen, click Next.
F. At the 'Server Information' screen, type in the Network Domain, Server Name or computer name and the e-mail address of the administrator.
G. Select 'for All Users, on Port 80, as a service - Recommended'. Click Next.
H. At the Setup Type screen, select Typical and click Next.
I. At the Destination Folder screen, click Change to specify the installation location. For example, <drive>:\Apache. Click Next.
J. At the 'Ready to Install' screen, click Install.
K. At the 'Installation Completed' screen, click Finish.
L. Modify the httpd.conf file. Click Start > Programs > Apache HTTP Server 2.0.48 > Configure Apache Server > Edit the Apache httpd.conf Configuration File.
M. Locate the line 'DirectoryIndex index.html' and add 'default.htm' and 'default.html' at the end so it reads:DirectoryIndex index.html index.html.var default.htm default.html
N. Save the file and close the window.
O. Verify that the installation was successful. Open a Web browser and type the computer or domain name. For example, http://machinename.
The Apache page: "Seeing this instead of the website you expected?" should display.
If the page does not display, check that Apache is running.
P. Open the Services window.
Q. A service named Apache2 should be listed as started. If it isn’t, start it by clicking the triangle in the toolbar. Verify that the Apache installation is successful.
If the default Apache page still does not display, an error was made during one of the installation steps. Repeat the installation, or check the Apache Documentation. Additional resources on installing the Apache Web Server can be found here - Install Tomcat 5.0.28 Servlet Engine.
-show me- A. Click here to access the Jakarta Tomcat 5.0.28 Download site.
B. Click on jakarta-tomcat-5.0.28.exe to download the file. Save it on the local machine.
C. Navigate to the folder where the file was downloaded and double-click jakarta-tomcat-5.0.28.exe.
D. Click Next to continue.
E. Read the License Agreement and click 'I Agree'.
F. At the Choose Components dialog click on the '+' to expand Tomcat, then check Service to be installed. Leave the other options at the default settings.
G. Click Next.
H. Enter <drive>:\Tomcat5028 as the installation directory and click Next.
I. Use the default settings in the Configuration dialog box. Create a new password for the Tomcat Administrator. Click 'Next'.
J. Click 'OK' to confirm the path of the JVM installed on the machine. It should be the location of the Java Standard Development Kit: for example, C:\j2sdk1.4.2_06 If the path to the JRE is listed, or no default path is listed, please cancel the Tomcat installation and first 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, then click Finish.
Steps L through O cover the setup of necessary environment variables:
L. Right-click on My Computer and choose Properties, then the Advanced tab. Click on the Environment Variables button.
M. Under System Variables, click New. When prompted for Variable Name, type JAVA_HOME This is case sensitive.
For the Variable value, type the path where Java 2 SDK is installed; for example, <drive>:\j2sdk1.4.2_06, then click OK.
N. Create another system environment variable called CATALINA_HOME This is case sensitive.
For the Variable value, type the path where Jakarta Tomcat 5.0.28 is installed; for example: <drive>:\Tomcat5028, then click OK.
O. 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:
;%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.
P. Click 'OK' twice to close the Properties window.
Click Here for additional resources on installing the Tomcat Servlet Engine. - Configure Apache 2.0.48 with Tomcat 5.0.28.
-show me- A. Click on the following link to download the Mod_JK2 configuration files for Apache and Tomcat:Tomcat5028_Apache2048_IMS91_win.zip
B. Extract the contents of the zip file to a temporary location on your hard drive.
C. Copy the mod_jk2.so file to your Apache Modules directory. For example: <drive>:\apache\apache2\modules
D. Copy the workers2.properties file to your Apache Conf directory. For example: <drive>:\Apache\Apache2\conf
E. Modify the httpd.conf file. Click Start > Programs > Apache HTTP Server 2.0.48 > Configure Apache Server > Edit the Apache httpd.conf Configuration File.
F. Locate the line: #LoadModule ssl_module modules/mod_ssl.so and add the following line of code directly below it so it reads:#LoadModule ssl_module modules/mod_ssl.so
LoadModule jk2_module modules/mod_jk2.so
G. Save and close the file.
UPDATE REGISTRY
H. Doubleclick on the extracted Win200x_XP_IMS91_Tomcat5028.reg file to add the necessary information to the registry. If Tomcat was installed to a location other then C:\Tomcat5028, please first edit the registry file in Notepad with the different path.
I. Click Yes to confirm.
RESTART SERVICES
J. Open the Services window.
K. Start and stop the services in the following order:
K1. Stop Apache2
K2. Stop Apache Tomcat
K3. Start Apache Tomcat
K4. Start Apache2
L. Enter the following into a Web browser.
Note: This is case sensitive.http://<your_machine_name>/servlets-examples/servlet/HelloWorldExample
A page should display that says "Hello World" if the test is successful. Apache must run on the default port 80. If not, append the port number after the machine name in the URL. If the above test fails, recheck the installation steps for Apache and Tomcat. It may be that the URL works if users specify 'port 8080'. This only indicates that Tomcat is working. Do not proceed to install ArcIMS until this is working. - Install ArcIMS 9.1 from the installation CD. Refer to the ArcIMS Installation Guide, Step 3a.
- Perform the ArcIMS Post Installation, Step 3b in the ArcIMS Installation Guide, to configure ArcIMS 9.1 with Apache and Tomcat.
-show me- A. Select Typical as the Post Installation Option.
B. At the Web Server-Servlet Engine Configuration, select Apache 2.0.4x with Tomcat 4.1.xx/5.0.28(mod-jk2). Click Next.
C. For Web Server Directory, enter the path where Apache 2.0.48 is installed; for example, <drive>:\Apache Group\Apache2
D. For the Servlet Engine Directory, enter the path where Tomcat 5.0.28 is installed; for example, <drive>:\Tomcat5028
E. Click next. The Web server / Servlet Engine configuration may take a few minutes to complete.
F. Restart the Web server and Servlet Engine from the services panel once the Post Installation is finished. - Verify that the ArcIMS installation was successful.
-show me- A. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.
B. Verify the Web server protocol and Web server name are correct, including the domain and port number. The default is port 80. On Windows XP/2003 machines, Internet Explorer sometimes does not show the hostname and port number. If this is the case, right-click near the top of the window and select 'Allow Blocked Content'.
C. Test both components. The result for Test 1 should be:
IMS v9.1.0
Build_Number=1084.1931
Version=9.1.0
Test successful
The result for Test 2 should be:
Version=9.1.0
Build_Number=1084.2174
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 from the dropdown list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and then try the Diagnostics tool again. - For the final steps to get ArcIMS running, refer to the ArcIMS 9.1 Installation Guide, Step 5: "Configure ArcIMS".
Created: 4/6/2005
Last Modified: 12/29/2008