= !MapGuide 3.0 Release Notes = MapGuide Open Source 3.0 Final is now available * Milestone: [http://trac.osgeo.org/mapguide/milestone/3.0 3.0] * [http://trac.osgeo.org/mapguide/query?status=closed&group=component&resolution=fixed&milestone=3.0&order=status Resolved Tickets] [[TOC]] == Installation == Windows 32 bit installer: * [http://download.osgeo.org/mapguide/releases/3.0.0/Final/windows/MapGuideOpenSource-3.0.0.8701-Final-x86.exe MapGuideOpenSource-3.0.0.8701-Final-x86.exe] * Size: 89,442,071 bytes * md5: 48c354bfb33ec5f25a37dbc198a7501c Windows 64 bit installer: * [http://download.osgeo.org/mapguide/releases/3.0.0/Final/windows/MapGuideOpenSource-3.0.0.8701-Final-x64.exe MapGuideOpenSource-3.0.0.8701-Final-x64.exe] * Size: 95,179,371 bytes * md5: cfc901ce6cbe1fa1dec614b57540f92c Windows 32-bit MgInstantSetup bundle: * [http://download.osgeo.org/mapguide/releases/3.0.0/Final/windows/MapGuideOpenSource-3.0.0.8701-InstantSetup-x86.exe MapGuideOpenSource-3.0.0.8701-InstantSetup-x86.exe] * Size: 82,562,715 bytes * md5: 638ead0709e47cc07598435aa196ecd5 Windows 64-bit MgInstantSetup bundle: * [http://download.osgeo.org/mapguide/releases/3.0.0/Final/windows/MapGuideOpenSource-3.0.0.8701-InstantSetup-x64.exe MapGuideOpenSource-3.0.0.8701-InstantSetup-x64.exe] * Size: 87,734,595 bytes * md5: d794c0d1dbe693e4b29766838c4110fe Ubuntu 12.04 install script (32-bit): * [http://download.osgeo.org/mapguide/releases/3.0.0/Final/ubuntu_x86/mginstallubuntu.sh mginstallubuntu.sh] * Size: 26,503 bytes * md5: ec2d28b153d39f4d146fd8f4dfd16c88 * Uninstall script: [http://download.osgeo.org/mapguide/releases/3.0.0/Final/ubuntu_x86/mguninstallubuntu.sh mguninstallubuntu.sh] * Size: 1,425 bytes * md5: c8794eba45069355203bd14522298069 Ubuntu 12.04 install script (64-bit): * [http://download.osgeo.org/mapguide/releases/3.0.0/Final/ubuntu_x64/mginstallubuntu.sh mginstallubuntu.sh] * Size: 26,505 bytes * md5: b919c399b00d21b07ddd455859cec89a * Uninstall script: [http://download.osgeo.org/mapguide/releases/3.0.0/Final/ubuntu_x64/mguninstallubuntu.sh mguninstallubuntu.sh] * Size: 1,425 bytes * md5: c8794eba45069355203bd14522298069 CentOS 6.x install script (32-bit): * [http://download.osgeo.org/mapguide/releases/3.0.0/Final/centos_x86/mginstallcentos.sh mginstallcentos.sh] * Size: 3,962 bytes * md5: fc0ba26b7d6853730b154682c6cc0870 * Uninstall script: [http://download.osgeo.org/mapguide/releases/3.0.0/Final/centos_x86/mguninstallcentos.sh mguninstallcentos.sh] * Size: 1,487 bytes * md5: d856a8bf18b7a7849cf29ec7ee12cb22 CentOS 6.x install script (64-bit): * [http://download.osgeo.org/mapguide/releases/3.0.0/Final/centos_x64/mginstallcentos.sh mginstallcentos.sh] * Size: 3,964 bytes * md5: 51d0194e6bd2f8f450949df440d6106d * Uninstall script: [http://download.osgeo.org/mapguide/releases/3.0.0/Final/centos_x64/mguninstallcentos.sh mguninstallcentos.sh] * Size: 1,487 bytes * md5: d856a8bf18b7a7849cf29ec7ee12cb22 == Sample Data == This release includes a new version of the Sheboygan Sample data set demonstrating features introduced in this and recent versions of MapGuide * [http://download.osgeo.org/mapguide/releases/3.0.0/extras/Sheboygan.mgp Sheboygan.mgp] * Size: 13,604,700 bytes * md5: 351b21e2c432b493fe2f073d7ab10205 == Extra Files == The install packages for this release of MapGuide omit several USA-specific CS-Map grid data files which are only required if your spatial data uses a coordinate system that involves an NSRS datum. See [http://trac.osgeo.org/csmap/wiki/CsMapRfc7 CS-Map RFC 7] for more information. As a result, our installation packages are now up to 150 MB lighter as a result of this omission. Should you require these grid data files, you can download them here: * [http://download.osgeo.org/mapguide/releases/3.0.0/extras/CsMap_Usa_NSRS_GridFiles.zip] * Size: 147,411,504 bytes * md5: 9f90097d78f16b132a2319a885646b0d To install these files, unzip them into the `Usa` directory of your CS-Map installation (eg. C:\Program Files\OSGeo\MapGuide\CS-Map\Dictionaries\Usa) and restart your MapGuide Server == 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/3.0.0/Final/extras/fusion-3.0.0-buildtools.zip fusion-3.0.0-buildtools.zip] * Size: 7,047,651 bytes * md5: f6e5f4dce8c03405789df0cd97faf019 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 == '''IMPORTANT: ''' MapGuide Open Source 3.0 does not support Windows XP or Windows Server 2003 in either IIS or Apache configurations. [http://trac.osgeo.org/mapguide/wiki/Release/2.5/Notes MapGuide Open Source 2.5] is the last release to support Windows XP and Windows Server 2003 ||||32-bit||64-bit|| ||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|| ||Windows 8.1||Maybe1||Maybe1|| + 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 == Major New Items == === MapGuide === * 64-bit Linux support (available in 3.0 as a preview release) * Various deprecated APIs have been removed [http://trac.osgeo.org/mapguide/wiki/MapGuideRfc139 MapGuide RFC 139] * Additional Convenience APIs [http://trac.osgeo.org/mapguide/wiki/MapGuideRfc143 MapGuide RFC 143] * Enhanced Tile Service support [http://trac.osgeo.org/mapguide/wiki/MapGuideRfc140 MapGuide RFC 140] * New resource type (TileSetDefinition) to define re-usable tile sets * Support for XYZ tile sets * Thirdparty component updates * GEOS upgarded to 3.4.2 [http://trac.osgeo.org/mapguide/wiki/MapGuideRfc141 MapGuide RFC 141] * ACE upgraded to 6.2.6 [http://trac.osgeo.org/mapguide/wiki/MapGuideRfc142 MapGuide RFC 142] * DWF Toolkit upgraded to 7.7 [http://trac.osgeo.org/mapguide/wiki/MapGuideRfc144 MapGuide RFC 144] * Linux improvements: * New serverconfig.ini option to specify font search paths [http://themapguyde.blogspot.com.au/2014/09/mapguide-tidbits-strange-fonts-on-linux.html to avoid "hieroglyphic" fonts] * New service control scripts for ease of service control and registration === Fusion === * Support for Stamen tiles as external base layers [http://trac.osgeo.org/mapguide/wiki/MapGuideRfc146 MapGuide RFC 146] === New schema revisions === * RuntimeMap v3.0.0 supports extra tile set information for Map Definitions that are linked to Tile Sets [http://trac.osgeo.org/mapguide/wiki/MapGuideRfc140 MapGuide RFC 140] === New/Changed APIs === * TBD === Other === Please [wiki:SubmitTicket report any defects]. === Changes from RC1 === * #2562: Fix select features on feature classes with string keys === Changes from Beta 2 === * Enable OpenSSL extension in PHP by default on Windows * Rollback r8626 which caused SelectFeatures to not return all features * FDO: [http://trac.osgeo.org/fdo/changeset/7226 Fix ReadNext() in SDF scrollable feature reader] * FDO: [http://trac.osgeo.org/fdo/changeset/7227 Fix property count not be properly initialized in SQLite reader] * Fusion: Update browserdetect.js * Fusion [http://trac.osgeo.org/fusion/ticket/631 Fix base map shift at scale 1000 and lower] * Fix missing tree sidebar in Web API documentation === Changes from Beta 1 === * Several big USA-specific coordinate system grid files have been omitted from all installation packages, resulting in smaller installation packages all round. See the Extra Files section if you require these files * Fix memory leak in SAX2 parsing code * #2555: Installer now properly writes FDO version 4.0 in providers.xml * #2547: Fix: Attribute values are wrong in Selection Panel if feature source is joined. * #2551: Fix: Zoom in/out raster file (sid file) in flexible web layout results in server down. * #2552: Fix: Zoom slider not available in IE 10 with basic layout and without compatibility mode. * #1996: Fix: ReadNext reader method loops when using SQLite database * FDO: Internal openssl updated to 1.0.1m * Fusion [http://trac.osgeo.org/fusion/ticket/632 #632]: Fix: Select feature doesn't work well in IE11 * Fusion [http://trac.osgeo.org/fusion/ticket/566 #566]: Fix: Allow buffer/redline and other widgets that introduce temporary layers to work against fully tiled maps * Fusion [http://trac.osgeo.org/fusion/ticket/631 #631]: Fix: Base maps are shifted with scale < 1000 and have wrong size. === Changes from Preview Release 1 === * #2550: RFC 140 Errata: The coordinate system of XYZ tile sets has been changed from {{{LL84}}} to {{{WGS84.PseudoMercator}}}. The result of this change is improved image quality of rendered XYZ tiles. This has no effect on public APIs. If you have already cached XYZ tiles from a PR1 installation, you should clear and re-seed that tile cache. * #2524, #2534: Improved error message quality * #2530: Added limited support for ordered query results from SDF/SHP providers * #2538: Fix failure to create MgMap from a linked Tile Set Definition if both have different coordinate systems * #2548: Fix inability to clear selections with QUEYRMAPFEATURES * #2523: Fix broken include paths in PHP developer's guide samples * #2526: Fix MgUnclassifiedException in QUERYMAPFEATURES when PERSIST=0 * #2554: Headless install option for Ubuntu install script == FDO Notes == MGOS 3.0 is compatible with FDO 4.0 This release is built against the FDO 4.0 branch Key items in FDO 4.0 of benefit to MapGuide include: * SHP provider implements [http://trac.osgeo.org/fdo/wiki/FDORfc23 FDO RFC 23] (fixes #175) * An OGR Provider with enhanced FDO expression capabilities and many bug fixes [http://trac.osgeo.org/fdo/wiki/FDORfc69 FDO RFC 69] == Installer notes == Installing MGOS 3.0 (via the windows installer) alongside MGOS 2.6 or older releases '''is not a currently supported configuration'''. Consider using the MgInstantSetup bundle instead if you desire side-by-side installation The installer '''does not''' currently support IIS Express as an IIS configuration option. Please observe the updated software requirements if you are using .net and/or IIS configuration: * IIS (all versions) require FastCGI for IIS to be installed. For IIS7 and above, you can install FastCGI by enabling the CGI feature of your IIS installation. See [http://learn.iis.net/page.aspx/246/using-fastcgi-to-host-php-applications-on-iis/#EnableFastCGI this link] for more information. * The supported .net Framework version for the MapGuide .net API is '''4.0'''. You must have this version of the .net Framework installed before proceeding with installation. Java configuration requires Java 6 (1.6.0) or higher. The MgInstantSetup bundles only work with '''IIS7 or higher''' if you choose to use this web server. You must still satisfy the .net and FastCGI software requirements required for this configuration. To assist new MapGuide users and developers, the installer also now bundles the following optional components: * .net/PHP/Java viewer samples * MapGuide Developer's Guide in HTML format with updated content * .net/PHP/Java Developer's Guide Samples All bundled samples require the [http://download.osgeo.org/mapguide/releases/3.0.0/Beta1/Sheboygan.mgp Sheboygan dataset] to be loaded into the MapGuide Server. A restart of Apache and/or IIS may be required for PHP to work. For the InstantSetup bundles, the MgInstantSetup utility requires .net Framework 4.0 to run. This is in addition to whatever existing software requirements imposed by this release of MapGuide Open Source. For Tomcat configuration, the installer currently does not install Tomcat as a service (#953). You will have to do this manually post-installation by [http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.56/bin/apache-tomcat-7.0.56.exe grabbing the tomcat windows service installer from the Tomcat download site] Also ensure that you install the JVM of the same bitness as your installation of MapGuide. For example, you will get a {{{java.lang.UnsatisfiedLinkError}}} if you attempt to run a Tomcat from a 32-bit MapGuide installation on a 64-bit JVM. If you have both 32 and 64-bit JVMs installed, you must ensure that the Tomcat bundled with MapGuide is using the correct one. Tomcat will generally use the one indicated by the {{{JAVA_HOME}}} environment variable, so this may have to be set and/or overridden. up Note that upgrading Apache from 2.2.x to 2.4.x has introduced changes to some configuration directives. If you have any custom httpd directives defined in your current MapGuide installation, please consult the [https://httpd.apache.org/docs/2.4/upgrading.html upgrade notes] for any changes you have to do when migrating/upgrading your Apache-based MapGuide installation to this release. If you have PHP-based MapGuide applications, consult the [http://php.net/manual/en/migration54.php 5.3 to 5.4 migration guide] and [http://php.net/manual/en/migration55.php 5.4 to 5.5 migration guide] for any API and compatibility issues that may be present in your MapGuide application as a result of moving to PHP 5.5 Should you choose to uninstall the Linux build of this release at any time, download and the respective uninstaller script. This ensures that any proper service un-registration is also performed. == Known Issues == * On Ubuntu, bash needs to be the default shell due to bash-isms in the service control scripts (#2497) * Installing msttcorefonts for your specific distro is strongly recommended to avoid the case of "hieroglyphic" labels. You can specify the path of your msttcorefonts installation in serverconfig.ini to have MapGuide load these fonts in on startup. * Using the Linux builds of MapGuide on distributions they were not built for is not supported. If you want to run MapGuide on: * Versions of Ubuntu newer than 12.04 * CentOS 7 or higher * A different Linux distribution Then consider running MapGuide in a [https://www.docker.com/ docker container] that is based on Ubuntu 12.04 or CentOS 6.x. This installation method is not supported and is only mentioned here for informational purposes. * The following FDO providers may or may not not be functional in 64-bit Linux builds of MapGuide * SHP (spatial indexing code not working properly in 64-bit, will cause incorrect spatial queries. Workaround: Use OGR provider) * MySQL (un-tested, please provide feedback) * PostgreSQL (un-tested, please provide feedback) * King.Oracle (un-tested, please provide feedback) * WFS (un-tested, please provide feedback) * WMS (un-tested, please provide feedback) * The following FDO providers have been validated in a 64-bit Linux environment by their respective FDO unit test suites (ie. All tests pass). Feedback on these providers in 64-bit Linux still welcome/appreciated: * SDF * SQLite * GDAL * OGR * Fusion: Bing/VirtualEarth commercial layers may conflict with Google layers if they are both specified in a Flexible Layout. If you have a Bing/VirtualEarth layer as the default, switching to a Google layer in your Fusion application will cause the Google layer to be displaced and vice versa. * #2252: It is not possible to call MgFeatureService::UpdateFeatures() with a NULL MgTransaction in the PHP API * Installer may generate a providers.xml entry for the ArcSDE provider if all providers are enabled in the "Feature Selection" dialog even if the installer does not actually bundle the ArcSDE provider. You can simply remove this entry from providers.xml after installation if this is the case. * CentOS: mgserver may throw double-free errors on service startup or server shutdown. Should not affect server behaviour. * The Performance Profiler on Linux may not work due to insufficient permissions to save the generated report files. To fix this, ensure the directory {{{/usr/local/mapguideopensource-3.0.0/webserverextensions/www/mapadmin/profilingmapxml}}} on linux has sufficient write permissions for the user account that the PHP executable runs under. * For an InstantSetup-based install with an Apache configuration, the Performance Profiler is [http://trac.osgeo.org/mapguide/browser/branches/3.0/MgDev/Web/src/mapadmin/performanceReport_MapViewer.php#L43 hard-coded to always use mapviewerjava if it exists for displaying the map viewer] for capturing extents for profiling. If you did not choose a Java configuration you will get the ajaxviewer.jsp source instead of the expected map viewer. To resolve this, delete the mapviewerjava directory * Uninstallation can leave "ghost" IIS virtual directories behind, which currently is any virtual directory / application you create inside the mapguide virtual directory that '''was not created by the installer''' These "ghost" directories may impact on future installations. To ensure these "ghost" directories are completely gone after uninstallation, use the appcmd.exe utility to remove these virtual directories. You can find out what virtual directories are still there by running {{{appcmd.exe list vdir}}} * PHP Viewer and Developer's Guide samples will not work if the PHP viewer feature is not enabled. Likewise for .net and Java. Nothing in the installer will prevent you from making such a choice. * For the IIS configuration or Apache configuration with a custom http port, you will have to update the WFS and WMS server name configuration properties via the MapGuide Site Administrator after installation if you intend to use such features. This is currently set to localhost:8008 for both.