Install MapGuide 2.4 on IIS

Step-by-step instructions to installing MapGuide 2.4 on IIS. This guide has also been successfully tested with MapGuide 2.5 (Preview release).

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

For 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 -> .NET Extensibility
   • 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
     

Prerequisite: FastCGI for IIS

For IIS6 and below, install ​FastCGI for IIS.

For IIS7 and above, enable ​FastCGI in IIS.

Install MapGuide

For Windows 7/Windows Server 2008 R2 and below, use the installer and select IIS configuration to automatically configure IIS.

For Windows 8/Windows Server 2012 (untested), use the installer and select manual configuration. IIS will need to be manually configured.

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
   • .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
   • 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
   • 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
     
   • 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
   • 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
      
    • 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
    • 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
    • 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