MapGuide 4.0.0 Beta 1 Release Notes

MapGuide Open Source 4.0.0 Beta 1 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 artifacts listed

Download	Size	SHA-1
Windows Installer	​Download	fc4ea2cdee4b6863790a62362f158ddfb6ecbc51
Windows InstantSetup bundle	​Download	acf3455fc4b14afa9e938b56b9944ae53b2697ca
Windows .pdb files	​Download	5730dfadbb116b09eede47a4479b3d99d6526961
Ubuntu 22.04 installer	​Download	11eb91dbe4a92f9d416e67fb871cd1ea4f8c9a7f
CentOS 7 installer	​Download	2e499afa4afd63a3b8533c624f6102c2fa699b09
Sheboygan Sample Data	​Sheboygan.mgp	a3f75c4d1abadff3baad57f4efe2c5679719a682

Changes since 4.0 Preview 4

• General
  • Layer Definition v4.0.0 schema: The IncludeFeatureBounds element introduced with this version is now optional (MapGuideRfc186)
  • #772: New Layer Definition support for label justification for basic stylization (MapGuideRfc186)
  • Updated Sheboygan dataset
    • SlateCommercial flexible layout update
      • Fixed Bing hybrid layer name
      • Removed Google layers and street view widget references
      • Removed GoogleScript extension tag
      • Removed VirtaulEarthScript extension tag (the URL is a 404 and it is actually no longer required for Bing Maps support)
      • Bing Maps layers require an API key and a ADD_BING_MAP_KEY_HERE is present in this flexible layout to be replaced with a valid API key
• Server Tier
  • Fixed UTF8 legality check to work under French Localization
  • #2863: Fix incorrect tile extent calculation at zoom=0 resulting in blank tiles
• MapGuide API Bindings
  • Now generated with SWIG 4.1.1
  • .net: Fix proxy class resolution failure for certain MgGeometry classes
• Web Tier / Applications
  • Fusion fixes:
    • Fix undefined mapAgentUrl in getSiteVersion function
    • Patched OpenLayers.Layer.Bing to gracefully handle metadata errors (ie. Due to missing Bing Maps API key)
    • CoordinateTracker widget made more robust (patch by Pierre Cardinal)
  • #2844: New French string localization bundles for AJAX viewer and Fusion (contributed by Pierre Cardinal)
  • #2864: New webconfig.ini properties to allow denying mapagent GETRESOURCECONTENT/GETRESOURCEDATA/GETRESOURCEHEADER access to certain resources for Anonymous users or session ids.
  • #2297: Verified performance report now gracefully handles broken layers
  • OpenLayers library (for application/openlayers representation in WMS GetMap requests) now updated to 7.3.0
  • GeoJSON output fixes and improvements
    • WFS/WMS:crs property now included so GeoJSON content can now self-identify its coordinate system
      • #2809: For WFS GetFeatures
      • #2858: For WMS GetFeatureInfo
    • #2857: Output from mapagent now has application/json mime type
    • #2856: WFS GetFeature now properly transforms feature coordinates to the specified SRS
  • #979: MgWebLayout can now properly load un-formatted WebLayout XML
  • Updated web tier components
    • PHP 8.1.11 -> 8.1.17
    • httpd 2.4.52 -> 2.4.56
    • Tomcat 9.0.37 -> 9.0.73

Known Issues

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

FDO Notes

MGOS 4.0.0 Beta 1 is built against FDO trunk (rev 8186)

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 8186) is near identical to FDO 4.1 in terms of functionality with the following changes:

• Internal GDAL updated to 2.4.4
  • Internal copy of zlib updated to 1.2.12
• 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
• Restore support for Count(1) expression in MySQL Provider
• Improved WFS services support for WFS FDO provider
• Improved WFS/WMS schema support for layer names with trailing underscores
• SQL Server Provider:
  • Now supports databases hosted on SQL Azure PaaS
  • Improve SRID sampling performance
• 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	Status
Windows 11	Yes
Windows 10	Yes
Windows Vista	Maybe+
Windows 7	Yes
Windows Server 2008	Yes+
Windows Server 2008 R2	Yes
Windows 8	Yes1
Windows Server 2012	Yes1
Windows Server 2016	Yes
Windows 8.1	Maybe1

Please report any issues you find.