MapGuide 4.0.0 Beta 2 Release Notes

MapGuide Open Source 4.0.0 Beta 2 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

NOTE: CentOS build is not available for this release. We will evaluate if it is feasible to continue providing CentOS builds for future releases

Item	Download	SHA-1
Windows Installer	​MapGuideOpenSource-4.0.0.10094-Beta2-x64.exe	52a45ccd3bc339552932bdb0f4cb197fcb11a08a
Windows InstantSetup bundle	​MapGuideOpenSource-4.0.0.10094-InstantSetup-x64.exe	22601f7fc165f4ee6b6ec6973cdbfe6e3f96623f
Windows .pdb files	​mapguideopensource-4.0.0.10094-pdbs.7z	dc3c595fb3179450eed84e3a529886bf2306be12
Ubuntu 22.04 installer	​mapguideopensource-4.0.0.10094-ubuntu22-install.run	6806aa624d8a64a1316cedf770ef60e4fce82d9c
Sheboygan Sample Data	​Sheboygan.mgp	b2d301e7067f373b827724beb022cf55f62be95f
Fusion build tools	​fusion-4.0.0-buildtools.zip	5d14057df31f6c3a142e694420c446475a3ecc8a

Post-release patches

Changes since 4.0 Beta 1

• Installer
  • #2882: Newer libpq.dll (PostgreSQL 16.3) bundled with Windows installer
• Server Tier
  • #2874: Fix instability on Linux due to criss-crossed resolution of sqlite3 and geos symbols to our shared libraries instead of the distro-provided versions
  • #2879: Repository admin tools have been momentarily pulled from this and future beta releases until the admin scripts have been updated and/or rewritten
    • As a workaround, use MapGuide Package files to backup/restore repository content
  • #2880: Removed immature MVT tile rendering support
    • If you want to produce Mapbox Vector Tiles, use any tool from ​this list
• Web Tier
  • #2870: Fix QUERYMAPFEATURES SelectionKey containing a newline char, breaking client-side reconciliation of selected features
  • #2873: More PHP8 compatibility fixes in PHP AJAX Viewer
  • #2876: Fix bad instanceof exception checks in PHP AJAX Viewer
  • #2868: More PHP8 compatibility fixes in Site Administrator
  • #2878: Buffer overflow fixes in WMS/WFS service layer
  • #2881: New optional --bind-to parameter for MgDevHttpServer
• InstantSetup
  • Fix crash if no setup log path specified when configuring
• Samples
  • #2872: Fix bad extents in SheboyganXYZ tileset
• Updated web tier components
  • PHP 8.1.17 -> 8.1.29
  • httpd 2.4.56 -> 2.4.62
  • Tomcat 9.0.73 -> 9.0.89

Known Issues

• PostGIS driver support in the OGR provider on Linux is flaky and may not render selections or features in a given bounding box. Consider accessing PostGIS data sources via the OSGeo.PostgreSQL FDO provider instead.
• If you have a .net project consuming the MapGuide nuget packages and the .net project targets legacy .net Framework 4.x and uses packages.config for tracking package references, the native dll copying targets will not activate.
  • For this to work in this type of project, you need to migrate packages.config over to use PackageReference elements. Once migrated, the native dll copying targets will activate.

FDO Notes

MGOS 4.0.0 Beta 2 is built against FDO trunk (rev 8263)

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 8263) 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 collisions with an externally compiled GDAL dll (that may bring its own copies of xalan/xerces dlls)
• Better support and handling of empty geometries
• [SUPERCEDED]: Windows: Internal OpenSSL updated to 1.1.1k
• [SUPERCEDED]: 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
• [New in Beta 2]: Improved WFS provider performance on large layer lists
• [New in Beta 2]: Improved WFS provider schema/class enumeration performance
• [New in Beta 2]: Improved WFS provider handling of 3D coordinate data
• [New in Beta 2]: Windows: Internal libcurl updated to 8.4.0
• [New in Beta 2]: Windows: Internal OpenSSL updated to 3.0.12
• [New in Beta 2]: Fixed description metadata in PostgreSQL provider to no longer refer to MySQL (cause of #2875)
• [New in Beta 2]: Backported security fixes for internal SQLite used by SDF provider
• SQL Server Provider:
  • Now supports databases hosted on SQL Azure PaaS
  • Improve SRID sampling performance
  • [New for Beta 2] Added coordsys alias for GDA2020
• 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 - 16.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 Server 2016	Yes

+ Reported as compatible by users

Please report any issues you find.