Pitney Bowes MapXtreme - Manual (Page 52)

Chapter 2: Getting Started
Deploying Your Application
MapXtreme v7.1 52 Developer Guide
< modules >
< add name ="WebSessionActivator"
type ="MapInfo.Engine.WebSessionActivator, MapInfo.CoreEngine,
Version=7.1.0.90, Culture=neutral, PublicKeyToken=93e298a0f6b95eb1" />
</
modules >
< handlers >
< add name ="MapController" verb ="*" path ="MapController.ashx"
type ="MapInfo.WebControls.MapController, MapInfo.WebControls,
Version=7.1.0.90, Culture=neutral, PublicKeyToken=0a9556cc66c0af57" />
</
handlers >
</ system.webServer >
7. Save Web.config. Build the project and run the application.
Deploying Your Application
There are essentially two strategies for installing the MapXtreme components on the server machine
where you wish to host your application: either 1) use the included runtime installer or, 2) create your
own installer and add the appropriate merge modules (MSM).
The MapXtreme SDK ships with the MXTRunNCP.exe runtime installer for the NCP version. The
SCP version of the SDK ships with MXTRunSCP.exe.
Deploying With the Runtime Installer
Use the runtime installer (MXTRunNCP.exe or MXTRunSCP.exe) as part of your custom installation
process. This will install the MapXtreme assemblies and create the needed registry entries. It will
also include the required .NET Framework v4.0. Runtime assemblies and files are included for both
Web and Desktop applications. Additionally, you will need to install your runtime license file which
you get from Pitney Bowes Software or your reseller in the path Program Files\Common
Files\MapInfo\MapXtreme\7.x.x. See
Runtime Licenses for Deployment .
For web-based applications, using the runtime installer is the better strategy. All of the runtime
components are installed in their default locations. There are no user-configurable options.
One disadvantage of using the runtime installer executable is that, depending on your application,
unnecessary files may be installed. Additionally, if you expect to install more than one
MapXtreme-enabled application, you will need to maintain your own reference counts when using
the runtime installer. By using the MSMs directly with your own installer, references are maintained
automatically.
Steps for Deploying an Application Using the Runtime Installer
You must have Administrator permissions on the computer in order to run the installer. You also
need IIS permissions to install to the Web server.
1. From the MapXtreme product media, choose Install. The Install options page appears.
2. Choose Deployment Installation and choose Install Runtime Environment. The install wizard
opens.