Install MapGuide 2.4/2.5 on IIS

Step-by-step instructions to installing MapGuide 2.4/2.5 on IIS.

Prerequisite: Microsoft .NET Framework 4

If Microsoft .NET Framework 4 or 4.5 is not installed, install ​Microsoft .NET Framework 4 (Web Installer).

Prerequisite: IIS

Windows Server 2008

1. Open Start -> Server Manager -> Roles
2. Roles Summary -> If "Web Server (IIS)" is not installed, Add Role
3. Web Server (IIS) -> Add Role Services
4. Install
   • Web Server (IIS) -> Application Development Features -> ASP.NET, which also selects ISAPI Extensions and ISAPI Filters
   • Web Server (IIS) -> Application Development Features -> CGI, which also enables FastCGI in IIS7 and above

Windows 7

1. Open Start -> Control Panel -> Programs -> Programs and Features -> Turn Windows features on or off
2. Install
   • Internet Information Services, which also selects several default components
   • Internet Information Services -> World Wide Web Services -> Application Development Features -> ASP.NET, which also selects ISAPI Extensions and ISAPI Filters
   • Internet Information Services -> World Wide Web Services -> Application Development Features -> CGI, which also enables FastCGI in IIS7 and above
     

Prerequisite: FastCGI for IIS

IIS6 and below

Install ​FastCGI for IIS.

IIS7 and above

​FastCGI is enabled when CGI is installed in IIS7.

Upgrade from MapGuide 2.2 or older

If upgrading from MapGuide 2.2 or older, the repository must be upgraded using the following procedure: ​Upgrade to Autodesk Infrastructure Map Server 2013 from a 2009 or Later Release

Use the following definitions:

• MapGuide Enterprise 2011 Server or Infrastructure Map Server 2012 = MapGuide 2.2 or older
• Autodesk Infrastructure Map Server 2013 = MapGuide 2.4/2.5

Install MapGuide

Run the installer and select:

• IIS configuration to allow the installer to configure IIS, or
• Manual configuration if you want to manually configure IIS.

Manual configuration: IIS

If MapGuide has been installed with a manual configuration, IIS will need to be manually configured.

1. For Windows 7, open Start -> Control Panel -> System and Security -> Administrative Tools -> Internet Information Services (IIS) Manager
2. Open [root]\Application Pools -> Actions -> Add Application Pool...
   • Name: MapGuide24AppPool (or MapGuide25AppPool)
   • .NET Framework version: .NET Framework v4.0.30319
   • Managed pipeline mode: Integrated
   • Start application pool immediately: True
     
3. Open [root] -> FastCGI Settings -> Actions -> Add Application...
   • Full Path: C:\Program Files\OSGeo\MapGuide\Web\Php\php-cgi.exe
   • FastCGI Properties:
     • Max Instances: 0
     • Activity Timeout: 70
     
     
4. Open [root] -> ISAPI and CGI Restrictions -> Actions -> Add...
   • ISAPI or CGI path: C:\Program Files\OSGeo\MapGuide\Web\www\mapagent\isapi_MapAgent.dll
   • Description: MapGuide 2.4 MapAgent ISAPI handle (or MapGuide 2.5 MapAgent ISAPI handle)
   • Allow extension path to execute: True
     
5. Open [root] -> MIME Types -> Actions -> Add...
   • File name extension: .json
   • MIME type: application/json
     
6. Open [root]\Sites\Default Web Site -> Actions -> View Applications -> Actions -> Add Application...
   • Alias: mapguide
   • Application pool: MapGuide24AppPool (or MapGuide25AppPool)
   • Physical path: C:\Program Files\OSGeo\MapGuide\Web\www
     
7. Open [root]\Sites\Default Web Site\mapguide -> Error Pages -> Select "401" -> Actions -> Remove
   • Are you sure that you want to remove the selected custom error page? Yes
8. Open [root]\Sites\Default Web Site\mapguide -> Handler Mappings -> Actions -> Add Module Mapping...
   • Request path: *.php
   • Module: FastCgiModule
   • Executable (optional): C:\Program Files\OSGeo\MapGuide\Web\Php\php-cgi.exe
   • Name: MapGuide_2.4_PHP_via_FastCGI (or MapGuide_2.5_PHP_via_FastCGI)
     
   • Do you want to create a FastCGI application for this executable? Yes
9. Right-click [root]\Sites\Default Web Site\mapguide\mapagent -> Convert to Application
   • Alias: mapagent
   • Application pool: MapGuide24AppPool (or MapGuide25AppPool)
   • Physical path: C:\Program Files\OSGeo\MapGuide\Web\www\mapagent
     
10. Open [root]\Sites\Default Web Site\mapguide\mapagent -> Handler Mappings -> Select "CGI-exe" -> Actions -> Edit Feature Permissions...
    • Read: True
    • Write: True
    • Execute: True
      
11. Open [root]\Sites\Default Web Site\mapguide\mapagent -> Handler Mappings -> Actions -> Add Script Map...
    • Request path: mapagent.fcgi
    • Executable: C:\Program Files\OSGeo\MapGuide\Web\www\mapagent\isapi_MapAgent.dll
    • Name: MapGuide 2.4 MapAgent ISAPI handler (or MapGuide 2.5 MapAgent ISAPI handler)
      
    • Open Request Restrictions...
      • Mappings -> Invoke handler only if request is mapped to: False
        
    • Do you want to allow this ISAPI extension? Yes
12. Right-click [root]\Sites\Default Web Site\mapguide\mapviewernet -> Convert to Application
    • Alias: mapviewernet
    • Application pool: MapGuide24AppPool (or MapGuide25AppPool)
    • Physical path: C:\Program Files\OSGeo\MapGuide\Web\www\mapviewernet
      
13. For .NET API: Right-click [root]\Sites\Default Web Site\mapguide -> Add Application...
    • Alias: mapviewerajax
    • Application pool: MapGuide24AppPool (or MapGuide25AppPool)
    • Physical path: C:\Program Files\OSGeo\MapGuide\Web\www\mapviewernet
      
14. For .NET API: Open [root]\Sites\Default Web Site\mapguide\mapviewerajax -> Default Document -> Add...
    • Name: ajaxviewer.aspx

Test

1. Open http:
   localhost\mapguide\mapagent\index.html -> Other -> Create Session -> Submit
   • Username: Administrator
   • Password: admin

Previous releases

• Configure MapGuide 2.2 on Windows
• Installing MapGuide Open Source 2.0 Web Server Extensions on Vista / Windows Server 2008 / IIS7