How To: Install IBM HTTP Server with WebSphere Application Server and ArcIMS 3.1 on Windows
This document takes you through all install and test steps for IBM HTTP Server with WebSphere Application Server 3.5 with ArcIMS 3.1.
INSTALL IBM HTTP Server AND WebSphere:
a. At the Choose Setup Language screen, choose English and click OK.
b. At the Attention screen, click Next.
c. At the Installation Options screen, choose Quick Installation and click Next.
d. At the Security Options screen, type your password twice and click Next.
e. At the Product Directory screen, browse to where you want everything installed or accept the defaults, and click Next.
f. At the Select Program Folder screen, click Next.
g. At the Setup Complete screen, uncheck the readme box and click Finish.
h. At the Restarting Windows screen, choose Yes to restart now and click OK.
i. Start the WebSphere Administration Server. Choose Start > Programs > IBM WebSphere > Application Server V3.5 > Start Admin Server. A DOS window appears showing Websphere starting. It will take awhile to start so be patient. Once it has started, the window disappears.
j. Choose Start > Programs > IBM WebSphere > Application Server V3.5 > Administrator’s Console.
k. In the left panel, open the tree view and navigate to WebSphere Administrative Domain > your_servername > Default Server and highlight Default Server.
j. In the toolbar, click the arrow to start WebSphere.
l. In the Information Dialog window, click OK.
m. Close the Admin Console.
CONFIGURE HTTP SERVER:
a. Open a browser and type your computer name.
b. Click Configure server.
c. Enter your username and password and click OK.
c. In the left panel, click the arrow next to Basic Settings to expand the view.
d. Click Server Options.
e. In the right panel, select “one or more of the following” and check the box next to Indexes.
f. Click Submit.
g. In the left panel, click the arrow next to Indexing to expand the view.
h. Click Files.
i. In the right panel, click Add.
j. In the Path box, type index.htm and click Apply.
k. Do the same for default.html and default.htm, then click Submit.
l. In the upper right corner, click the Restart Server button.
m. Close the browser.
VERIFY THAT THE INSTALLATION WAS SUCCESSFUL:
a. Open a browser and type: http://machine/servlet/HelloWorldServlet
If you see Hello World, everything is ready and you may continue. If you don’t see this, something went wrong. Go back through the installation steps.
INSTALL ArcIMS 3.1:
a. Run ArcIMS setup.exe.
b. At the Welcome screen, click View Readme to read about last-minute changes to the ArcIMS installation instructions. Close the window when done. Click Next. At the License Agreement screen, click I Agree.
c. At the Installation Type screen, click Typical and click Next.
d. At the Installation Directory screen, click Browse to change the installation directory, if desired, and click OK. Click Next.
e. If JRE 1.3.0_02 is not installed or not detected, a Java Runtime Environment Installation screen displays. You must have JRE installed to install and run ArcIMS Manager and the Java Viewers.
Note: NOTE: The setup program looks for a specific registry entry to determine if JRE is installed on your computer. Java Development Kit (JDK) 1.3 does not create the registry entry even though it contains a valid JRE.
Click OK to begin JRE installation or Browse to an existing JDK location. After JRE installation, click Next to continue ArcIMS installation.
f. At the Host Name and Working Directories screen, choose a protocol and change the Web Server Host Name, if needed.
If you are setting up an Internet web site or a multiple ArcIMS Spatial Server configuration, you must include your domain name, for example, esri.esri.com. If your web server has a port number other than the default HTTP port (80), then it should have the syntax webservername:port number, for example, esri.esri.com:81.
g. For the Web Site Working Directory, accept the default location to store web pages and ArcIMS output, or click Browse to change the directory.
Note: NOTE: If you choose the default, after installation you must create virtual directories for output and website. See step 7 below for instructions.
If you browse to the location of your web server root directory, then you don’t need to create virtual directories for output and website.
h. For the User’s Working Directory, accept the default location or click Browse to navigate to another location. Click Next.
i. At the Application Server Information screen, change the Registry Port and Connector Port, if desired.
The ArcIMS Spatial Server, Monitor, and Tasker communicate with the ArcIMS Application Server via the Registry port.
The Servlet Connector and ArcIMS Application Server communicate via the Connector port.
j. At the Servlet Connector Directory screen, Browse to the location of your Servlet directory, for example \WebSphere\AppServer\servlets.
If you don’t know this location, click Help for a list of the most common Servlet directory locations.
If you are unsure, use this location: <ArcIMS Installation Directory>\Connectors\Servlet and contact your system administrator. In this case, the servlet connector (com directory and associated files) must be moved from <ArcIMS Installation Directory>\Connectors\Servlet to the appropriate web server directory before using ArcIMS. See step 5 below for details.
k. At the Windows Services Authorization screen, change your Domain\User Name, if necessary. The User Name and Password must be for the installation account and must have administrator privileges.
This information gives ArcIMS the ability to start Windows services (ArcIMS Application Server, Monitor, and Tasker) and gives the ArcIMS Spatial Server the necessary privileges to access resources on the local computer and/or network.
l. Type your Password for the selected User Name and type it again to confirm it. Click Next.
m. At the Summary of Installation Information screen, verify that the information displayed is correct. After installation, it is written to a log file located at <ArcIMS Installation Directory>\Common\InstallSummary.log.
Click Next to begin installation.
Note: NOTE: Microsoft’s Java VM 3186 or later is required for the ArcIMS Windows Services. The installation prompts you to update your system if Microsoft Java VM is not detected or if you have an older version.
n. At the Installation Successful screen, click Finish to restart your computer.
Note: NOTE: You must restart your computer to complete ArcIMS installation.
o. After ArcIMS installation, it is recommended that you update your Services file. This file contains a record of what ports are in use. It is typically located at <drive>:\WINNT\system32\drivers\etc.
Open the Services file in a text editor, scroll to the place where the port numbers fit in, and add the Connector and Registry port numbers to the file, for example,
Code: esri_conn 5300/tcp #ArcIMS connector port esri_reg 5353/tcp #ArcIMS registry port
Save the file.
This tells your system administrator which ports are in use, so they will not be duplicated. The port numbers are listed on the ArcIMS Summary screen; this information is written to a summary log file located at <ArcIMS Installation Directory>\Common.
CONFIGURE IBM HTTP Server WITH WebSphere TO WORK WITH ArcIMS:
a. Verify that the following items are at \WebSphere\AppServer\servlets: · com directory · Esrimap_prop · jaxp.jar · parser.jar · ServletConnector_Res.properties · ServletConnector_Res_en_US.properties files · WMSEsrimap_prop
If not, on Windows NT, choose Start | Settings | Control Panel | Services; on Windows 2000, choose Start | Settings | Control Panel | Administrative Tools | Component Services. Stop your web server, navigate to <ArcIMS Installation Directory>\Connectors\Servlet and copy the following items to the appropriate location: · com directory · Esrimap_prop · jaxp.jar · parser.jar · ServletConnector_Res.properties · ServletConnector_Res_en_US.properties files · WMSEsrimap_prop Then Start your web server. 2. Open \WebSphere\AppServer\bin\admin.config. Find the line com.ibm.ejs.sm.adminserver.classpath= and add the following at the end of the line: ;<drive>\:/WebSphere/AppServer/servlets/jaxp.jar; <drive>\:/WebSphere/AppServer/servlets/parser.jar Save the file. Then Stop and Start your web server and close the Services window.
USE THE DIAGNOSTICS TOOL TO TEST YOUR ArcIMS INSTALLATION: a. Choose Start > Programs > Esri > ArcIMS 3.1 > ArcIMS Diagnostics. The ArcIMS Diagnostics displays.
b. Select your web server protocol, type your web server name including domain, and type your port number. The default is 80.
c. Click Test to test the ArcIMS Servlet Connector and ArcIMS Application Server.
If this test is successful, your ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly.
If you receive an error message, select the error number in the dropdown list and click View. The error number and a description display. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.
CREATE VIRTUAL DIRECTORIES:
a. Open IBM HTTP server admin and logon.
b. Click the Mappings folder on the left sidebar and click Aliases.
c. In the Defined aliases list, click Add. Click URL path and for the Alias for directory or filename, type “/Manager/”. For the Actual directory or filename, type “<install drive>:/Program Files/Esri/ArcIMS4.0/Manager/” or the alternate location you selected during installation. Click Apply. Click Submit on the right.
Note: Note: If you browsed to the location of your web server root directory to create directories for output and website during ArcIMS installation, see ‘Step 5: Configure ArcIMS,’ in the ArcIMS Installation Guide for the final step required to get ArcIMS running.
d. In the Defined aliases list, click Add. Click URL path and for the Alias for directory or filename, type “/Website/”. For the Actual directory or filename, type the appropriate path, for example, C:/ArcIMS/Website/. Click Apply. Click Submit on the right.
e. In the Defined aliases list, click Add. Click URL path and for the Alias for directory or filename, type “/Output/”. For the Actual directory or filename, type the appropriate path, for example, C:/ArcIMS/Output/. Click Apply. Click Submit on the right.
f. Log off the IBM HTTP server.
See "Step 5: Configure ArcIMS" in the ArcIMS 3.1 Installation Guide for the final step required to get ArcIMS running.