The WMS Connector Administrator handles all WMS administration.
Before you are allowed access to the Administrator, you must follow these steps.
http://<hostname>/<deploy_name>/index.htm
where
If this is your first time logging in to the Administrator, you are prompted to create a new username and password and to confirm your password by typing it again. This user name and password is required for all future sessions.
The WMS Connector Properties page allows you to set up or update the WMS Connector environment. The following properties are set on this page.
This property specifies whether the WMS Connector is enabled or disabled. When enabled, WMS requests can be made through the connector. When disabled, all WMS services still exist along with their Capabilities files, but they are inaccessible to WMS requests. The only allowable command is "connectorPing", which tests communication with the WMS Connector. An example URL to test a connectorPing is
http://<hostname>/<deploy_name>/com.esri.wms.Esrimap?CMD=connectorPing
where
Name of the machine on which the ArcIMS Application Server is running. If your site has more than one machine with an Application Server, select the primary machine.
The port on which the ArcIMS Servlet Connector communicates with the ArcIMS Application Server. By default, the port is 5300. If your site uses more than one port, use the port number that matches the port for the primary host machine.
Sets the default ArcIMS service the WMS Connector recognizes. The WMS Connector can support many services. Non-default services are accessible by including the service name in the URL or by using the SERVICENAME parameter in a request. SERVICENAME is a vendor-specific parameter, and the default service is available without using this parameter.
The location where the WMS Capabilities files get placed. A Capabilities file specifies the contents of a WMS service. Capabilities files are created for each WMS-enabled ArcIMS service.
The directory can be placed anywhere on your network that is visible to the host machine. It does not need to be in a location accessible to the Web server. If the directory name you choose does not exist, a new directory is created.
If you have other versions of the WMS Connector on your site, this Capabilities directory must be unique and should not be in the same location as any other Capabilities directory. For more information on compatibility with different version of the WMS Connector, see WMS Connector Compatibility.
Note: If a new directory is created when setting the Capabilities directory, this directory can be only one level down from an exsiting directory. For example, if c:\wms already exists, you can create a new directory called c:\wms\capabilities. However, you cannot create a new directory called c:\wms\capabilities\new.
Charset is available for international users who need to set a character set value. For example, a common charset for Japan is shift_jis. Once this value is set, the WMS Connector will work properly with international data and locales. The default is UTF-8.
Specifies whether to reaspect the returned image. When reaspect is TRUE, the pixel height and width ratio stay the same. At full extent, the map may not fill the entire viewing area. When reaspect is FALSE, the pixel height and width are stretched to fill the entire viewing area. The default is FALSE.
The WMS specification requires reaspect to be FALSE. Although you have the option to set reaspect to TRUE, it is recommended that you keep reaspect set to FALSE. A GetMap request is the only operation that has been designed to work with a reaspect value of TRUE. GetFeatureInfo requests may not work properly when reaspect is set to TRUE.
Known limit: ArcMap Image Services always have reaspect set to TRUE and cannot be set to FALSE. Image Services do not have this limitation.
Specifies whether logging is enabled. The default is false.
Errors and messages can be logged in one of two files:
If the Debug property is false, this property is ignored, and there is no logging. The default value is servlet.
ArcIMS supports both PNG 8-bit and PNG 24-bit for image output. The WMS specification allows for only PNG. You can select which format you want for your output images.
When you have filled out all the parameters on the page, click Submit. The information is registered automatically by the WMS Connector.
A note about the WMSEsrimap_prop property file: Once you have submitted the parameters in Administrator, a property file named WMSEsrimap_prop is updated. This file is located in the expanded WAR file's WEB-INF/classes directory. The location of the expanded WAR file directory varies depending on the servlet engine you are using. However, the structure of the expanded WAR file is always the same.
<Application Name>where
You should not edit WMSEsrimap_prop in a text file. Instead, you should use the Administrator. If you do edit WMSEsrimap_prop, you must manually restart your servlet engine for the changes to take effect.
You should occasionally change your password to the WMS Connector Administrator. To do this:
After you have logged in and set properties for the WMS Connector, you will see the main Services page. This page lists all ArcIMS Image and ArcMap Image Services available for your server. You can enable some or all of these services for WMS.
This column lists all ArcIMS Image and ArcMap Image Services available on the server.
Caution: Any edits you may have made to a Capabilities file are lost.
When the ArcIMS Monitor or Application Server is not running, you may see some unexpected behavior when enabling or disabling services. Services can be disabled as usual, and the Capabilities files are deleted. When you try to enable a service, you will get an error message:
The service could not be enabled for WMS. There was a problem creating one or more capabilities file.
When you see this error, check that the ArcIMS Monitor and Application Server are running.
Caution: If you make edits in a Capabilities file and click Update, a new file is generated and overwrites the file you edited.
When a service is enabled for WMS, you can view the full extent of the map by clicking View Map. The map appears in a pop-up window.
ERR3002: An error occurred communicating with the ArcIMS Application Server. The service list could not be generated.
When you restart the Application Server and update the services list, the list will return as before. No Capabilities files are deleted.
If a problem arises during administration you will receive an error or warning message. An error message indicates the process was unsuccessful. A warning message indicates that the process was successful but the results may be incorrect.
The following table lists some common error and warning messages when using the Administrator.
| Problem | Error message |
|---|---|
| ERR3002 | An error occurred communicating with the ArcIMS Application Server. The Service List could not be generated.
Check if the Application Server is running. If not, restart it. After restarting, you may need to click Update Service List to see the list of services. |
| ERR3006 | One or more capabilities file(s) for this service could not be deleted.
Check if the files are read-only or are being used by another application such as a text editor. |
| ERR3007 | The directory containing the capability files for this service could not be deleted.
Check if the directory has permission to be deleted, is not being shared, or is locked by another process. |
| ERR3009 | The service could not be enabled for WMS. There was a problem creating one or more capabilities file.
Check if the ArcIMS Monitor and Application Server are running. If they are, check if the ArcIMS service is running. |
| WRN3001 | The map configuration file used as input to a service has no projection information. FILTERCOORDSYS and FEATURECOORDSYS are missing in the PROPERTIES section of the map configuration file.
The capabilities files are built with the following information:
Check if you have included FILTERCOORDSYS and FEATURECOODSYS in your map configuration file. For more information, see Knowledge Base article 26877 at http://support.esri.com. Additional information is also available in the ArcIMS Programmers Reference Guide. |
| WRN3002 | ArcIMS services that use custom projection strings are handled in a special manner.
The capabilities files will include the following information:
|
Overview of administering the WMS Connector