Getting Started with Version 2.0.x

Getting Started with Version 2.0.x

Getting MapGuide Up and Running

To get MapGuide Open Source up and running on your system, follow these five steps:

1. Download and install the MapGuide Server and MapGuide Web Server Extensions. For Windows visit the downloads page and download and execute the MgServerSetup-2.0.x.exe and MgWebServerExtensionsSetup-2.0.x.exe installers.

For Linux visit the MapGuide Open Source downloads page and the Feature Data Objects

downloads page and download mapguideopensource-2.0.x.tar.gz,

mapguideaptinstaller-2.0.x.tar.gz, and the FDO 3.3.x tar.gz files. Then follow the steps in the

Building MapGuide on Linux document to configure, make, and install the software.

  1. Download and extract the sample application. Visit the downloads page and download On Windows extract the files to C:\Program Files\MapGuideOpenSource\WebServerExtensions\www. On Linux extract the files to /usr/local/mapguideopensource/webserverextensions/www. Note that in both cases it should create a folder called phpviewersample under www.

  2. Download the sample data. Visit the downloads page and download the resource package Sheboygan.mgp. On Windows copy the file to C:\Program Files\MapGuideOpenSource\Server\Packages. On Linux copy the file to /usr/local/mapguideopensource/server/packages.

  3. Load the sample data using the Site Administrator application. Open a web browser to the following URL: http://localhost:8008/mapguide/mapadmin/login.php. Login using the user id "Administrator" and the default password "admin". When you see the Manage Servers page appear, select "Load Packages" in the left navigation bar. Select the radio button next to Sheboygan.mgp and click "Load Package".

  4. Launch the sample application. Finally open a web browser to the following URL: http://localhost: 8008/mapguide/phpviewersample/ajaxtiledviewersample.php to launch the sample application.

At this point you should have MapGuide Open Source up and running. To find out more read the rest of this guide, look through the FAQ, and visit the documentation page to view the developer documetation.

Components of the MapGuide Platform

The MapGuide Open Source platform consists of components that run in one of three tiers, as shown below. These components can all run on a single computer or may be distributed across multiple computers as shown in the diagram.

MapGuide Server

The MapGuide Server hosts the MapGuide Open Source services and responds to requests from client applications through TCP/IP protocol. The server provides seven services : Site Service, Resource Service, Drawing Service, Feature Service, Mapping Service, Rendering Service, Tile Service and KML Service. The MapGuide Server runs on either Microsoft Windows or Linux.

MapGuide Web Server Extensions

The MapGuide Web Server Extensions are internal components that have no UI but are accessed through the MapGuide Web API. The Web Extensions include a MapAgent CGI/ISAPI/Apache mod that exposes the services offered by the MapGuide Server to client applications over the Internet or an intranet using the HTTP protocol. The MapGuide Web API supports three development languages/environments: ASP.NET, Java/JSP, and PHP. The MapGuide Web Server Extensions run on either Microsoft Windows or Linux and work with either the Apache Web Server or Microsoft IIS.

MapGuide Viewer

MapGuide Open Source offers three viewer technologies: a DWF™-based viewer and two AJAX-based viewers.

 DWF Viewer - The DWF Viewer embeds the downloadable Autodesk DWF Viewer which is based on a Microsoft ActiveX Control with full support for the Autodesk DWF format. This viewer works in Microsoft Internet Explorer only.

 AJAX Viewer - The AJAX Viewer is a pure DHTML viewer based on AJAX technology that does not require any downloadable plug-ins. This viewer works in Microsoft Internet Explorer, Mozilla Firefox, and Safari.

 Fusion Viewer - Built primarily in JavaScript, Fusion is a web mapping application development framework. Fusion allows web designers and developers to build rich mapping applications quickly and easily. Using “widgets” that provide the interface functionality within Fusion’s modular architecture, developers are able to add, remove, or modify functionality using standard-compliant HTML and CSS. Fusion requires no proprietary browser plug-ins, and it produces applications that work in all major browsers on Windows, Mac, and Linux. Fusion provides a flexible means of interacting with MapGuide Open Source. Using a growing suite of widgets, this modular-based system allows you to build powerful, interactive AJAX applications quickly with minimal programming experience. For applications requiring special functionality, Fusion provides an extensible platform that allows you to develop your own widgets.

MapGuide Maestro

MapGuide Maestro is an application dedicated to managing spatial data for MapGuide Open Source. It is an open source GUI tool and client that is used for authoring your data, layers, maps and layouts. More information about MapGuide Maestro can be found at:

Autodesk MapGuide™ Studio

Autodesk MapGuide Studio is a complete proprietary authoring tool for MapGuide Open Source offered by Autodesk. More information about Autodesk MapGuide Studio is available at: However, as of release 2010, it is only available to Autodesk MapGuide Enterprise customers and cannot be purchased separately.

MapGuide Site Administrator

The MapGuide Site Administrator is an application for managing your site and its servers. This application uses a web-based interface that you can access from any web browser. To start the program, open a browser and enter: http://servername:port/mapguide/mapadmin/login.php, using the name of the site server and port that you specified during installation. You use the MapGuide Site Administrator to add and remove servers, take servers offline for maintenance, modify the configuration of a server, assign services to the servers, and monitor the status of any server. The MapGuide Site Administrator is not a separate product component, but it is installed as a part of the MapGuide Web Server Extensions.

Feature Data Objects

The Feature Data Objects (FDO) API is a set of commands for manipulating, defining, and analyzing geospatial information. MapGuide Open Source uses FDO to access data in a variety of geospatial data sources. An FDO Provider is a specific implementation of the FDO API. It is the software component that provides access to data in a particular data format or data store. FDO is a seperate open source project available from