Configuring WebSphere for ArcIMS

After installing ArcIMS, you must configure your Web server for ArcIMS. If your Web server and servlet engine are not operational, contact your system administrator before you proceed. See http://www-4.ibm.com/software/webservers for information on problems with WebSphere. Follow these steps to configure WebSphere for ArcIMS:

 

  1. Verify that the following items are at <WebSphere Installation directory>\AppServer\installedApps\<servername>\arcimsservletconnector.war.ear\arcimsservletconnector.war\WEB-INF\classes\:

 

If you can not verify the above:

 

  1. In a text editor (such as Notepad), open <WebSphere Installation directory>\AppServer\installedApps\<servername>\arcimsservletconnector.war.ear\arcimsservletconnector.war\WEB-INF\classes\Esrimap_prop. Edit APPSMACHINE to reflect your ArcIMS host name. Save and close the file.

 

Creating virtual directories

After installing ArcIMS, you must create virtual directories for Manager, output, and website. A virtual directory is a mapped location on the Web server to a physical path.

Note: If you browsed to the location of your Web server root directory to create directories for output and website (the Web Site Working Directories) during ArcIMS installation, you don't need to create virtual directories for output and website.

 

  1. Go to the <IBMHttpServer Installation directory>\conf directory and open httpd.conf.  

 

  1. Look at the very first line of the file- it should say, “ServerName <yourname>”.  If not, edit this line to reflect the Web server host name.

 

  1. Find the line for DirectoryIndex and add “default.htm default.html index.htm” if it is not already listed.

 

  1. Find the Alias section and add the following:

Alias /output <path to output dir>

Alias /website <path to website dir>

<Directory “path to website dir”>

Options Indexes MultiViews

AllowOverride None

Order allow,deny

Allow from all

</Directory>

Alias /manager <path to Manager dir>

<Directory “path to manager dir”>

Options Indexes MultiViews

AllowOverride None

Order allow,deny

Allow from all

</Directory>

 

  1. Find “UseCanonicalName on” and comment this out as you might have some server errors due to this.  

 

  1. Save and close the file.

 

  1. Stop and start IBM HTTP Server

 

  1. Stop and start WebSphere

 

Using the Diagnostics tool to test your ArcIMS installation

  1. Verify your ArcIMS installation was successful:

a. Click Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics. The ArcIMS Diagnostics tool 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 1 to test the ArcIMS Servlet Connector and 2 to test the ArcIMS Application Server.

 

If these tests are 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.

 

See Configuring WebSphere for Service Administrator for information on configuring ArcIMS Service Administrator.

 

See Configuring WebSphere for Metadata Explorer for information on configuring Metadata Explorer.

 

See Step 5: Configure ArcIMS for the final step required to get ArcIMS running.