Changes between Initial Version and Version 1 of Release/4.0.0/Beta3/Notes


Ignore:
Timestamp:
09/05/24 06:25:56 (2 months ago)
Author:
jng
Comment:

Initial notes for next beta to be updated as we go along

Legend:

Unmodified
Added
Removed
Modified
  • Release/4.0.0/Beta3/Notes

    v1 v1  
     1= !MapGuide 4.0.0 Beta 3 Release Notes =
     2
     3MapGuide Open Source 4.0.0 Beta 3 is now available.
     4
     5[[TOC]]
     6
     7== Downloads ==
     8
     9**NOTE: We now only provide 64-bit builds for both Windows and Linux and SHA-1 checksums are provided for all binary artifacts listed**
     10
     11||Item||Download||SHA-1||
     12||'''Windows Installer'''||||||
     13||'''Windows InstantSetup bundle'''||||||
     14||'''Windows .pdb files'''||||||
     15||'''Ubuntu 22.04 installer'''||||||
     16||'''Generic Linux installer'''||||||
     17||'''Sheboygan Sample Data'''||||||
     18||'''Fusion build tools''||||||
     19
     20== Post-release patches ==
     21
     22
     23== Changes since 4.0 Beta 2 ==
     24
     25 * General
     26   * New "Generic Linux" build for use in Linux distros other than Ubuntu 22.04. Use this build if you cannot run MapGuide on Ubuntu 22.04 or in a Ubuntu 22.04 docker container. This build of MapGuide was produced by [https://github.com/phusion/holy-build-box holy-build-box] and is as self-contained as possible with no additional dependencies beyond the essential libraries that should be available in every Linux distro.
     27 * Server
     28   * Stylization engine now delegates to renderer as to whether to clip instead of always clipping
     29
     30== Known Issues ==
     31
     32 * 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.
     33 * 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.
     34    * 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.
     35
     36== FDO Notes ==
     37
     38MGOS 4.0.0 Beta 3 is built against FDO (branch, rev TBD)
     39
     40'''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'''
     41
     42FDO trunk (branch, rev TBD) is near identical to FDO 4.1 in terms of functionality with the following changes:
     43
     44 * Internal GDAL updated to 2.4.4
     45   * Internal copy of zlib updated to 1.2.12
     46 * Windows: Better swap-ability of internal GDAL dll with externally compiled one
     47   * 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
     48   * 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)
     49 * Better support and handling of empty geometries
     50 * [SUPERCEDED]: Windows: Internal OpenSSL updated to `1.1.1k`
     51 * [SUPERCEDED]: Windows: Internal libcurl updated to `7.73`
     52 * Fixed multiple memory leaks in GDAL provider
     53 * Restore support for `Count(1)` expression in MySQL Provider
     54 * Improved WFS services support for WFS FDO provider
     55 * Improved WFS/WMS schema support for layer names with trailing underscores
     56 * [New in Beta 2]: Improved WFS provider performance on large layer lists
     57 * [New in Beta 2]: Improved WFS provider schema/class enumeration performance
     58 * [New in Beta 2]: Improved WFS provider handling of 3D coordinate data
     59 * [New in Beta 2]: Windows: Internal libcurl updated to `8.4.0`
     60 * [New in Beta 2]: Windows: Internal OpenSSL updated to `3.0.12`
     61 * [New in Beta 2]: Fixed description metadata in PostgreSQL provider to no longer refer to MySQL (cause of #2875)
     62 * [New in Beta 2]: Backported security fixes for internal SQLite used by SDF provider
     63 * SQL Server Provider:
     64   * Now supports databases hosted on SQL Azure PaaS
     65   * Improve SRID sampling performance
     66   * [New for Beta 2] Added coordsys alias for GDA2020
     67 * MySQL Provider:
     68   * Support for the full suite of spatial operations for MySQL >= 5.6
     69   * Experimental support for MariaDB
     70   * Experimental support for MySQL 8.0
     71   * Improve SRID sampling query performance
     72 * PostGIS Provider:
     73   * Added support for PostgreSQL 12.0 - 16.0
     74   * No longer joins to `pg_authid` when listing tables/views
     75   * Support for curve strings and curve polygons
     76 * SHP Provider: Fix memory leaks in extended select implementation
     77
     78The King Oracle provider is built against and now requires Oracle Instant Client 12cR2
     79
     80== Installer notes ==
     81
     82You 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.
     83
     84Before 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)
     85
     86== Extra Files ==
     87
     88Due to size constraints, the binary packages for this release of MapGuide omit the following CS-Map data files:
     89
     90 * USA:
     91   * NSRS 2007/2011 datum shift files
     92   * 1996/1999/2003 Geoid height data files
     93 * Australia:
     94   * GDA 2020 datum shift files
     95
     96These extra files are available for download as a separate 7-zip archive:
     97
     98 * [http://download.osgeo.org/mapguide/releases/4.0.0/Preview1/Dictionaries_Extra.7z Dictionaries_Extra.7z]
     99    * Size: 230,627,172 bytes
     100    * SHA-1: 798b189f88a2d50c71f1d01cfdcdeac9939ccb11
     101
     102To install these files, extract the contents into your `Dictionaries` folder of your CS-Map installation. On Windows, this would normally be:
     103
     104 * `C:\Program Files\OSGeo\MapGuide\CS-Map\Dictionaries`
     105
     106Restart your MapGuide Server after extracting the files.
     107
     108Unless you work with data in one or more coordinate systems that involves one of the above datums, **you do not need these files**.
     109
     110== Windows Compatibility ==
     111
     112||OS||Status||
     113||Windows 11||Yes+||
     114||Windows 10||Yes||
     115||Windows Server 2016||Yes||
     116
     117+ Reported as compatible by users
     118
     119Please [wiki:SubmitTicket report any issues you find].