Pitney Bowes MapXtreme - Manual (Page 349)

Chapter 19: Web Map Service
Setting up a MapXtreme WMS Server
MapXtreme v7.1 356 Developer Guide
To support integration of authentication into existing MapXtreme WMS Client implementations, the
semantics of the WmsRequest UserDefinedParameters have been extended to include support for a
set of well-known authentication parameters, which maps directly to the set of authentication
properties on the WmsRequest object model. Setting the authentication properties via the object
model directly, or indirectly via the UserDefinedParameters has the exact same effect.
For more information, see the WmsRequest class in the Developer Reference.
Setting up a MapXtreme WMS Server
MapXtreme provides a WMS server that is compliant with the OGC WMS 1.3.0 and 1.1.1
specifications.
To set up your own WMS Server you must configure a server connection to IIS and create the XML
file necessary for providing the data connection required to host a Web Map Service. We assume
you have a working knowledge of WMS and the MapXtreme workspace schema???.
The WMS Server runs inside of Microsoft Internet Information Services (IIS). The following are the
configuration steps for setting up a WMS Server.
Step1: Create or modify a Web.config file to include the MapXtreme-specific WMS information and
the correct handlers for IIS classic or integrated pipeline mode.
Step 2: Create a valid WMS configuration file that contains information about the data you are
hosting. This file must validate against the WMS schema file (MXP_WMS_Configuration_1_2.xsd)
to avoid errors when you run the WMS Server.
Step 3: Configure and test the WMS Server setup. Instructions for IIS7 and IIS6 configuration are
provided.
On the MapXtreme product media, we provide sample Web.config and WMS configuration files that
you can review and modify for your own needs. The Web.config file defines how the ASP.NET
process is handled and the WMS server’s relationship to MapXtreme. The WMSSample.xml defines
the data sources and layer definitions that you can use as a model for your WMS server
implementation.
Step 1: Create a Web.config File
The Web.config is a standard configuration file for a web application. Here the file is modified to
provide MapXtreme-specific WMS information and to define how the ASP.NET process will be
handled.
MapXtreme supports IIS 7.x in both classic and Integrated pipeline modes and IIS 6.
1. Create a folder to contain the Web.config and the configuration file WMSSample.xml. In this
example, the location is called c:\wms. Copy the Web.config and WMSSample.xml from the
MapXtreme product media to this folder.
2. Open Web.config In a text editor and modify the line to point to the WMS
configuration file.