MapGuide 4.0.0 Preview 3 Release Notes

MapGuide Open Source 4.0.0 Preview 3 is now available.

Downloads

NOTE: We now only provide 64-bit builds for both Windows and Linux and SHA-1 checksums are provided for all binary aritfacts listed

Download	Size	SHA-1
Windows Installer	​Download	25e5dcef4249d85ee57d7671d5fe1090ba59db51
Windows InstantSetup bundle	​Download	86c82dc936809c542e072151e0d9b4d28e04b910
Windows .pdb files	​Download	2260272d46779ea0d143506e21c9fb8ce59161b9
Ubuntu 16.04 installer	​Download	f31be0a15ae447365a7ff141cd947c07858a3639
Sheboygan Sample Data	​Sheboygan.mgp	3d04772c6247ffb8557a9e8cca2ec470b88dc578

Changes since 4.0 Preview 2

• Java viewer is functional again with bundled Tomcat 9 on Linux (#2828)
  • A consequence of producing this fix is that MapGuideApi.jar no longer shipped with this release. All java viewer code now uses MapGuideApiEx.jar, which contains the API changes as described in MapGuideRfc129, which has been shipped in MapGuide Open Source since 2.5.0
• MgInstantSetup tool in the instant setup bundle now properly creates web tier temp directory. Failure to create this directory causes things like logging into the MapGuide Site Administrator to fail (#2838)
• No more tile border artifacts in MVT rendering (#2836, #2835)
• Max map image size is no longer hard-coded to 16834x16834 pixels and is now configurable (via MaxRenderImageWidth and MaxRenderImageHeight) in serverconfig.ini (#2829)
• Global raster stylization lock is now toggleable in serverconfig.ini (#2830)
• Fix: Coordinate rounding issues in GeoJSON output (#2832)
• Existing OpenLayers examples updated against bundled ol.js (#2810)
  • WMS example modifed to also demonstrate using GetFeatureInfo for GeoJSON "selection overlays"
  • New example demonstrating consuming Retina XYZ tiles
  • New example demonstrating usage of the new Geo-Processing APIs in the mapagent

Known Issues

• MVT tile rendering may still fail to render vector tiles at certain zoom levels on certain datasets (#2836)

Maestro Authoring Known Issues

The current release of MapGuide Maestro (6.0m10) has some known issues when connecting to a 4.0 preview 3 server. These issues will be addressed with the next milestone release.

• Local map previews will fail. (​https://github.com/jumpinjackie/mapguide-maestro/issues/78)
  • Workaround: Use the browser-based resource preview until the next milestone release.
• Map Definition editor UI still assumes tileset linkage restrictions that were lifted with RFC 173 (​https://github.com/jumpinjackie/mapguide-maestro/issues/75)
  • Workaround: Edit the Map Definition XML directly

FDO Notes

MGOS 4.0.0 Preview 3 is built against FDO trunk (rev 8138)

Due to unavailable build resources (the build maintainer does not have access to the ESRI SDK), this release does not include the ArcSDE FDO provider

FDO trunk (rev 8138) is near identical to FDO 4.1 in terms of functionality with the following changes:

• Internal GDAL updated to 2.4.4
• Windows: Better swap-ability of internal GDAL dll with externally compiled one
  • OGR/GDAL/WMS providers changed to use GDAL/OGR C API surface to avoid potential ABI compatibility problems swapping with an externally compiled GDAL dll not compiled with the same MSVC compiler version we're using
  • Internal xalan/xerces dlls renamed with "fdo" suffix to avoid collisons with an externally compiled GDAL dll (that may bring its own copies of xalan/xerces dlls)
• Better support and handling of empty geometries
• Windows: Internal OpenSSL updated to 1.1.1k
• Windows: Internal libcurl updated to 7.73
• Fixed multiple memory leaks in GDAL provider
• SQL Server provider now supports databases hosted on SQL Azure PaaS
• Restore support for Count(1) expression in MySQL Provider

• Improved WFS services support for WFS FDO provider

• MySQL Provider:
  • Support for the full suite of spatial operations for MySQL >= 5.6
  • Experimental support for MariaDB
  • Experimental support for MySQL 8.0
  • Improve SRID sampling query performance
• PostGIS Provider:
  • Added support for PostgreSQL 12.0
  • No longer joins to pg_authid when listing tables/views
  • Support for curve strings and curve polygons
• SHP Provider: Fix memory leaks in extended select implementation

The King Oracle provider is built against and now requires Oracle Instant Client 12cR2

Installer notes

You cannot use the windows installer to in-place upgrade an existing MapGuide Open Source 3.1.x or older installation. Only one MapGuide installation (via the Windows installer) can exist on any given machine. 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.

Before upgrading, it is recommended that you take a backup of your existing repository (whether that is through creating MGP packages with the MapGuide Site Administrator or using the provided repository backup tools/scripts)

Extra Files

Due to size constraints, the binary packages for this release of MapGuide omit the following CS-Map data files:

• USA:
  • NSRS 2007/2011 datum shift files
  • 1996/1999/2003 Geoid height data files
• Australia:
  • GDA 2020 datum shift files

These extra files are available for download as a separate 7-zip archive:

• ​Dictionaries_Extra.7z
  • Size: 230,627,172 bytes
  • SHA-1: 798b189f88a2d50c71f1d01cfdcdeac9939ccb11

To install these files, extract the contents into your Dictionaries folder of your CS-Map installation. On Windows, this would normally be:

• C:\Program Files\OSGeo\MapGuide\CS-Map\Dictionaries

Restart your MapGuide Server after extracting the files.

Unless you work with data in one or more coordinate systems that involves one of the above datums, you do not need these files.

Windows Compatibility

OS	32-bit	64-bit
Windows 10	Yes+	Yes
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 Server 2016	N/A	Yes
Windows 8.1	Maybe1	Maybe1

Please report any issues you find.