== 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: 
  * Name: !MapGuide ISAPI agaent
  * 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 "Default Document", click "Add..."
   * name: 
  * 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.