Installing MapGuide Open Source 2.0 Web Server Extensions on Vista / IIS 7

For now, this Wiki page only contains a PDF document of the instructions. This will eventually be converted to Wiki format, but for now, we wanted to get this on the site for people to use.

Installing MapGuide Open Source 2.0 Web Server Extensions on Windows Server 2008 / IIS 7

These steps do not require IIS 6 compatibility mode to be installed. (Sorry that there are no pictures, but perhaps someone could add them.)

• Install the web tier selecting "Manual Configuration".
• Start the "IIS Manager" applet
• On the "Default Web Site", right click and do an "Add Virtual Directory...". Then in the dialog:
  • Alias: mapguide
  • Physical path: C:\Program Files\!MapGuideOpenSource2.0\WebServerExtensions\www
• Select your newly added mapguide node, double click "Handler Mappings", select "Add Script Map..."
  • Request Path: *.php
  • Executable: C:\Program Files\!MapGuideOpenSource2.0\WebServerExtensions\Php\php5isapi.dll
  • Name: PHP
  • After clicking OK, press Yes on the "Add Script Map" dialog.
• Right click on "mapagent" and select "Convert to Application"
  • Use defaults and press OK
• Select "mapagent", double click "Handler Mapping", select CGI-exe, click "Edit Feature Permissions", check "Execute", press OK
• Continuing from above, select "Add Module Mapping..."
  • Request path: mapagent.fcgi
  • Module: IsapiModule
  • Executable: C:\Program Files\!MapGuideOpenSource2.0\WebServerExtensions\www\mapagent\isapi_MapAgent.dll
  • Name: MapGuide ISAPI agent
  • After pressing OK, press Yes in the subsequent dialog to enable the mapping
• Edit php.ini so that the extension_dir points to C:\Program Files\!MapGuideOpenSource2.0\WebServerExtensions\Php\ext
• Add PHP (C:\Program Files\!MapGuideOpenSource2.0\WebServerExtensions\Php) to the system path. Will need to restart Windows because of this.
• Select "mapguide", double click on error pages, select the 401 line, click "Remove".
• Right click on "mapguide" and select "Convert to Application"
• For using the PHP API:
  • Right click on "mapguide" and select "Add Virtual Directory..."
    • Alias: mapviewerajax
    • Physical path: C:\Program Files\!MapGuideOpenSource2.0\WebServerExtensions\www\mapviewerphp
  • Select "mapviewerajax", double click "Default Document", click "Add..."
    • Name: ajaxviewer.php
• For using the .NET API:
  • Right click on "mapguide" and select "Add Virtual Directory..."
    • Alias: mapviewerajax
    • Physical path: C:\Program Files\!MapGuideOpenSource2.0\WebServerExtensions\www\mapviewernet
  • Select "mapviewerajax", double click on "Default Document", click "Add..."
    • Name: ajaxviewer.aspx
  • Right-click on "mapviewerajax" and select "Convert to Application"
  • NOTE: Any other applications you create (e.g., Sheboygan sample) will also need to be converted to an application.

One final thing. It seems that you may get a system error dialog that periodically shows up. I think that this has something to do with the App Pool default idle time out. To get around this, try creating a MapGuide App Pool and give it a timeout of 0 minutes (i.e., no timeout). Then for all the applications that you create for MapGuide, set the application pool to be the MapGuide one. (BTW, the Application Pools node is just below the root level node with your machine name.)