= !MapGuide 2.5.2 Release Notes = 

MapGuide Open Source 2.5.2 is now available. These release notes only cover what's changed from MapGuide Open Source 2.5.1

For what's new and changed in MapGuide Open Source 2.5.1 or older, see the previous release notes:
 * [http://trac.osgeo.org/mapguide/wiki/Release/2.5.1/Notes 2.5.1 release notes]
 * [http://trac.osgeo.org/mapguide/wiki/Release/2.5/Notes 2.5 release notes]

[[TOC]]

== Installation ==

Windows 32 bit installer:
 * [http://download.osgeo.org/mapguide/releases/2.5.2/MapGuideOpenSource-2.5.2.7949-Final-x86.exe MapGuideOpenSource-2.5.2.7949-Final-x86.exe]
   * Size: 146,991,565 bytes
   * md5: 385334c566bca38469bcf5d573fe7d92
Windows 64 bit installer:
 * [http://download.osgeo.org/mapguide/releases/2.5.2/MapGuideOpenSource-2.5.2.7949-Final-x64.exe MapGuideOpenSource-2.5.2.7949-Final-x64.exe]
   * Size: 151,722,586 bytes
   * md5: c9d39da568bc066180320de2d98f19f6
Windows 32-bit MgInstantSetup bundle:
 * [http://download.osgeo.org/mapguide/releases/2.5.2/MapGuideOpenSource-2.5.2.7949-InstantSetup-x86.exe MapGuideOpenSource-2.5.2.7949-InstantSetup-x86.exe]
   * Size: 145,904,842 bytes
   * md5: aee23c365e0cb27059106d1c7d562782
Windows 64-bit MgInstantSetup bundle:
 * [http://download.osgeo.org/mapguide/releases/2.5.2/MapGuideOpenSource-2.5.2.7949-InstantSetup-x64.exe MapGuideOpenSource-2.5.2.7949-InstantSetup-x64.exe]
   * Size: 149,744,576 bytes
   * md5: 50573cbe37351b5b465f81521c352d0f
Ubuntu 12.04 install script (32-bit):
 * [http://download.osgeo.org/mapguide/releases/2.5.2/mginstallubuntu.sh mginstallubuntu.sh]
   * Size: 15,539 bytes
   * md5: d7b960bdffb1a88dcf808f3f48076117
CentOS 6.x install script (32-bit):
 * [http://download.osgeo.org/mapguide/releases/2.5.2/mginstallcentos.sh mginstallcentos.sh]
   * Size: 2,163 bytes
   * md5: 37c151af7c7fb07f4a0179b5a9f09c53

== Fusion build tools ==

Fusion build tools is a zip file containing the build.xml and associated build tools required to "re-compile" fusionSF.js and fusionSF-compressed.js on a production fusion installation.

Use the Fusion build tools if you have made patches and/or modifications to your fusion installation, and you need to build a new fusionSF.js and/or fusionSF-compressed.js

In order to use the Fusion build tools, you need to have [http://ant.apache.org Apache Ant] installed.

 * [http://download.osgeo.org/mapguide/releases/2.5.2/fusion-buildtools.zip fusion-buildtools.zip]
   * Size: 1,376,469 bytes
   * md5: 1bae34b91751d99c4471b64d329f8023

To use the Fusion build tools, extract the zip file contents into your fusion directory and navigate to this directory in the command prompt and execute the following command:

{{{
ant compress
}}}

This will re-build fusionSF.js and fusionSF-compressed.js under fusion\lib

Due to the default installation location (under Program Files), you may need to do this under a UAC-elevated command prompt or fix the directory permissions so that normal users can create/modify files.

== Windows Compatibility ==

||||32-bit||64-bit||
||Windows XP SP3||Yes||Maybe*||
||Windows Server 2003||Yes||Maybe*||
||Windows Vista||Maybe+||Maybe+||
||Windows 7||Yes||Yes||
||Windows Server 2008||Yes+||Yes+||
||Windows Server 2008 R2||N/A||Yes||
||Windows 8||Yes1||Yes1||
||Windows Server 2012||N/A||Yes1||

+ Not tested, but similar enough to Windows 7 to theoretically work

* IIS configuration will probably not work. Apache config should work due to its self-contained nature

1 IIS/.Net successfully tested on Windows 8 64-bit and Windows Server 2012. Windows 8 32-bit is similar enough to theoretically work. Apache config untested

Windows RT (ie. Windows 8 on ARM devices) is not a supported platform for installing MapGuide Open Source

== Installer Notes ==

 * You cannot use the windows installer to '''in-place''' upgrade an existing MapGuide Open Source 2.5 installation, you cannot have 2.5.2 and an older 2.5.x release installed side-by-side with the windows installer and you must uninstall the older 2.5.x release before installing 2.5.2. Use the InstantSetup bundle if side-by-side installs are required. Be sure to back up any data and applications before carrying out the new installation.
 * On linux, the install path is {{{/usr/local/mapguideopensource-2.5.2}}} and the FDO install path is {{{/usr/local/fdo-3.8.0}}}. You must uninstall the older 2.5.x release before installing 2.5.2. For Ubuntu, it is recommended to use the [http://download.osgeo.org/mapguide/releases/2.5.2/mguninstallubuntu.sh uninstall script] to uninstall the existing version. Be sure to back up any data and applications before carrying out the new installation.

== API Changes ==

None

== MapGuide Changes/Fixes ==

MapGuide Open Source 2.5.2 fixes the following issues

 * #2346: Fix dbxml "Document not found" on certain resource operations
 * #2368: Missing element id for tbFrame in AJAX Viewer
 * #1987: Poor DWF hatch rendering in AGG renderer
 * #2285: DWF DOT patterns not rendered in AGG renderer
 * #2374: AJAX Viewer OpenFlyout() fails if flyout contains separator
 * #2376: AJAX Viewer legend pane not re-doing layout if resized in Chrome
 * #2379: GETMAPLEGENDIMAGE does not respect ShowInLegend property and doesn't handle multi-style ranges properly
 * #2380: GETMAPLEGENDIMAGE renders visible layer groups with no visible child layers
 * #2384: Shrink down schema report sidebar width
 * #2387: MapGuide API documentation missing sidebar tree and inheritance diagrams
 * Linux: Install packages were missing RDBMS FDO providers (MySQL, PostgreSQL, ODBC)
 * Ubuntu Linux: Installer script no longer double-registers FDO RDBMS providers to providers.xml
 * Ubuntu Linux: FDO deb packages no longer have fdo-core 3.8.0-14601 as a dependency

== FDO Notes ==

MGOS 2.5.2 is compatible with FDO 3.8. 

This release is built against the FDO 3.8 branch.