| 1 | = !MapGuide 2.4.1 Release Notes = |
| 2 | |
| 3 | MapGuide Open Source 2.4.1 is now available. These release notes only cover what's changed from MapGuide Open Source 2.4. |
| 4 | |
| 5 | For what's new and changed in MapGuide Open Source 2.4, see the [http://trac.osgeo.org/mapguide/wiki/Release/2.4/Notes 2.4 release notes] |
| 6 | |
| 7 | [[TOC]] |
| 8 | |
| 9 | == Installation == |
| 10 | |
| 11 | Windows 32 bit installer: |
| 12 | * [http://download.osgeo.org/mapguide/releases/2.4.1/Release/MapGuideOpenSource-2.4.1.7766-Final-x86.exe MapGuideOpenSource-2.4.1.7766-Final-x86.exe] |
| 13 | * Size: TBD |
| 14 | * md5: TBD |
| 15 | Windows 64 bit installer: |
| 16 | * [http://download.osgeo.org/mapguide/releases/2.4.1/Release/MapGuideOpenSource-2.4.1.7766-Final-x64.exe MapGuideOpenSource-2.4.1.7766-Final-x64.exe] |
| 17 | * Size: TBD |
| 18 | * md5: TBD |
| 19 | Windows 32-bit InstantSetup bundle: |
| 20 | * [http://download.osgeo.org/mapguide/releases/2.4.1/Release/MapGuideOpenSource-2.4.1.7766-InstantSetup-x86.exe MapGuideOpenSource-2.4.1.7766-InstantSetup-x86.exe] |
| 21 | * Size: TBD |
| 22 | * md5: TBD |
| 23 | Windows 64-bit InstantSetup bundle: |
| 24 | * [http://download.osgeo.org/mapguide/releases/2.4.1/Release/MapGuideOpenSource-2.4.1.7766-InstantSetup-x64.exe MapGuideOpenSource-2.4.1.7766-InstantSetup-x64.exe] |
| 25 | * Size: TBD |
| 26 | * md5: TBD |
| 27 | Ubuntu 12.04 install script (32-bit): |
| 28 | * [http://download.osgeo.org/mapguide/releases/2.4.1/Release/mginstallubuntu.sh mginstallubuntu.sh] |
| 29 | * Size: TBD |
| 30 | * md5: TBD |
| 31 | CentOS 6.x install script (32-bit): |
| 32 | * [http://download.osgeo.org/mapguide/releases/2.4.1/Release/mginstallcentos.sh mginstallcentos.sh] |
| 33 | * Size: TBD |
| 34 | * md5: TBD |
| 35 | |
| 36 | == Fusion build tools == |
| 37 | |
| 38 | 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. |
| 39 | |
| 40 | 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 |
| 41 | |
| 42 | In order to use the Fusion build tools, you need to have [http://ant.apache.org Apache Ant] installed. |
| 43 | |
| 44 | * [http://download.osgeo.org/mapguide/releases/2.4.1/Release/fusion-buildtools.zip fusion-buildtools.zip] |
| 45 | * Size: TBD |
| 46 | * md5: TBD |
| 47 | |
| 48 | 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: |
| 49 | |
| 50 | {{{ |
| 51 | ant compress |
| 52 | }}} |
| 53 | |
| 54 | This will re-build fusionSF.js and fusionSF-compressed.js under fusion\lib |
| 55 | |
| 56 | 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. |
| 57 | |
| 58 | == Windows Compatibility == |
| 59 | |
| 60 | ||||32-bit||64-bit|| |
| 61 | ||Windows XP SP3||Yes||Maybe*|| |
| 62 | ||Windows Server 2003||Yes||Maybe*|| |
| 63 | ||Windows Vista||Maybe+||Maybe+|| |
| 64 | ||Windows 7||Yes||Yes|| |
| 65 | ||Windows Server 2008||Yes+||Yes+|| |
| 66 | ||Windows Server 2008 R2||N/A||Yes|| |
| 67 | ||Windows 8||Yes1||Yes1|| |
| 68 | ||Windows Server 2012||N/A||Yes1|| |
| 69 | |
| 70 | + Not tested, but similar enough to Windows 7 to theoretically work |
| 71 | |
| 72 | * IIS configuration will probably not work. Apache config should work due to its self-contained nature |
| 73 | |
| 74 | 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 |
| 75 | |
| 76 | Windows RT (ie. Windows 8 on ARM devices) is not a supported platform for installing MapGuide Open Source |
| 77 | |
| 78 | == Installer Notes == |
| 79 | |
| 80 | * The windows installer is an '''in-place''' upgrade to MapGuide Open Source 2.4, you cannot have 2.4 and 2.4.1 installed side-by-side with the windows installer and you must uninstall 2.4 before installing 2.4.1. 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. |
| 81 | * On linux, the install path is {{{/usr/local/mapguideopensource-2.4.1}}} and the FDO install path is {{{/usr/local/fdo-3.8.0}}}. You must uninstall 2.4 before installing 2.4.1. Be sure to back up any data and applications before carrying out the new installation. |
| 82 | |
| 83 | == API Changes == |
| 84 | |
| 85 | * For security reasons, EXECUTESQLQUERY has been removed from the mapagent. If you require such functionality, you can implement an equivalent handler with the MapGuide API, but take careful consideration in validating the input SQL that your handler receives before passing it down to MgFeatureService.ExecuteSqlQuery() |
| 86 | |
| 87 | == MapGuide Changes/Fixes == |
| 88 | |
| 89 | MapGuide Open Source 2.4.1 fixes the following issues |
| 90 | |
| 91 | * #2165: MgFeatureService.UpdateFeatures() does not rollback internal transaction if useTransaction = true |
| 92 | * #2189, #2190: MgLayerCollection.Remove() and MgLayerGroupCollection.Remove() returns true even if removing something that doesn't exist |
| 93 | * #2199: Empty POST request crashes mapagent handler |
| 94 | * #2213: New serverconfig.ini option to use the GwsQueryEngine as a fallback for Feature Joins |
| 95 | * #2214: Fix inability to select from a SQL Server joined feature class using RFC123 optimizations |
| 96 | * #2218, #2251: MgExceptions thrown by MgFeatureService.UpdateFeatures() improperly sent back from the server tier to web tier. |
| 97 | * #1981: Selection always uses the first layer style |
| 98 | * #2284: Basic point symbol previews now consider rotation |
| 99 | * #2270: GetLegendImage disregards image format |
| 100 | * #2315: Fix meaningless System.Exception for any un-mapped proxy MgException that is thrown |
| 101 | * #2316: MgResourceTagNotFoundException not exposed to PHP/.net/Java |
| 102 | * #833: MgLayer/MgLayerGroup has empty labels if revealed from an initially hidden state |
| 103 | * #2263: Buffer fails against a feature class with multiple geometry properties |
| 104 | * #2267: parent.InMeasure is not a function |
| 105 | * #2331: Select Polygon hangs when digitizing invalid polygon |
| 106 | * #2329: Legend is not correctly displayed in both basic and flexible web layout |
| 107 | * #2334: Improve label text and group/layer indentation for GETLEGENDIMAGE |
| 108 | * #2323: WMS should not throw exception if no coordinate system set up |
| 109 | * #2312: WMS request fails for Drawing Source Layer |
| 110 | |
| 111 | == FDO Notes == |
| 112 | |
| 113 | MGOS 2.4.1 is compatible with FDO 3.7. |
| 114 | |
| 115 | This release is built against the FDO 3.7 branch. |
| 116 | |
| 117 | === FDO Changes === |
| 118 | |
| 119 | * [http://trac.osgeo.org/fdo/ticket/864 #864] - Fix incorrect SQL generated by the GenericRdbms core for a query with an attribute and a spatial filter (eg. A rendering query from a Layer Definition that has a filter) |