Configuring the ESRI OGC 1.0.0 compliant WMS connector for ArcIMS 4 on Tomcat 4

Introduction

This document explains the setup of the default WMS connector comming with ESRI-ArcIMS 4. A better connector is currently available for ArcIMS and can be downloaded from the ESRI website from the Interoperability and Standards section.
ESRI ArcIMS 9 has the connector included with the software. An updated version of that connector can also be downloaded from the Interoperability and Standards section.

Step 1

Create or select one ArcIMS map service that you will use as your default map service. Write down/remember it's name (Case sensitive!)

Step 2

Install the servlet connector in the webserver root context if this was not done yet. (ussualy this is c:\program files\apache tomcat\webapps\ROOT\WEB-INF\classes)

Check for the following files to be sure it's there:

(assuming c:\program files\apache tomcat\webapps\ROOT is your webservers ROOT directory)

c:\program files\apache tomcat\webapps\ROOT\WEB-INF\classes\WMSEsrimap_prop

c:\program files\apache tomcat\webapps\ROOT\WEB-INF\classes\com\esri\wms\Esrimap.class (other .class files are also present here)

Step 3

Create the following directories in e.g. your ArcIMS directory:

c:\arcims\capabilities

c:\arcims\workingdirectory

Step 4

Open your tomcat 4 server.xml configuration file in a text editor (located in c:\program files\apache tomcat 4.0\conf\server.xml)

Add the following two lines after the line

<Context path="/output" docBase="c:\arcims\output" debug="0" privileged="true"/>

(you added this line when installing ArcIMS):

Step 5

Edit the WMSEsrimap_prop file in the WEB-INF\classes directory

• set 'enable=True'
• set the appServerMachine property
• set the capabilities directory and make sure that directory is accessable through Tomcat by creating a context for it
• create a working directory. This is where the logfiles will be stored
• set the defaultService property to your default map service. THIS IS CASE SENSTIVE! Make sure you use exactly the same name as the servicename, including capitals etc..

Step 6

Download the following file: capabilities_1_0_0.dtd

This file can be found at: http://www.digitalearth.gov/wmt/xml/capabilities_1_0_0.dtd

Save it into the capabilities directory

Step 7

restart Tomcat

Step 8

Check your WMS servlet is actually alive by writing the following URL in your browser:

http://localhost/servlet/com.esri.wms.Esrimap?cmd=ping

(replace localhost with your server's name if you want) If the result is: ArcIMS WMS-OGC Connector Version 3.1 Running at localhost:80 your servlet is running properly.

Step 9

Now try to get a capabilities file for your default mapservice by typing the following URL:

http://localhost/servlet/com.esri.wms.Esrimap?WMTVER=1.0&REQUEST=capabilities

The respons should be an XML file that opens in your browser or can be saved to your harddrive.

Step 10

Request the default map by typing in the following URL:

http://[localhost]/servlet/com.esri.wms.Esrimap?WMTVER=1.0.0&REQUEST=map&LAYERS=Countries,

WorldGrid&STYLES=default&SRS=EPSG:4326&BBOX=-180,-90,180,90&WIDTH=256&HEIGHT=128&FORMAT=PNG

Step 11

Request another map service capabilities file: Beware, you have to add an additional parameter, namely ServiceName=....

http://bergtop/servlet/com.esri.wms.Esrimap?ServiceName=World&WMTVER=1.0&REQUEST=capabilities

Step 12

Request another map service map, e.g.:

http://[localhost]/servlet/com.esri.wms.Esrimap?ServiceName=World&WMTVER=1.0.0&REQUEST=map

&LAYERS=cities,rivers,lakes,country,world30&STYLES=default&SRS=EPSG:4326&BBOX=-180,-90,180,90

&WIDTH=256&HEIGHT=128&FORMAT=PNG