= !MapGuide 4.0.0 Preview 2 Release Notes = 

MapGuide Open Source 4.0.0 Preview 2 is now available.

[[TOC]]

== 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'''||[https://download.osgeo.org/mapguide/releases/4.0.0/Preview2/MapGuideOpenSource-4.0.0.9740-Preview2-x64.exe Download]|| 9a178b6438c0ac4147ab8653df8a12277317464e||
||'''Windows InstantSetup bundle'''||[https://download.osgeo.org/mapguide/releases/4.0.0/Preview2/MapGuideOpenSource-4.0.0.9740-InstantSetup-x64.exe Download]|| f4b6d685f1728c2868c478453a1ce33b56aa1dba ||
||'''Ubuntu 16.04 installer'''||[https://download.osgeo.org/mapguide/releases/4.0.0/Preview2/mapguideopensource-4.0.0.9740-ubuntu16-install.run Download]|| 84ed8ed269093e0128cbd2675c8bf33b59ea349c ||
||'''Sheboygan Sample Data'''||[https://download.osgeo.org/mapguide/releases/4.0.0/Preview2/Sheboygan.mgp Sheboygan.mgp]|| 360dd5cef981bc8fe64fc9c6d1f4d428272d61a5 ||

== Changes since 4.0 Preview 1.1==

* #2206: Better quality `MgResourcesLoadFailedException` error message
* #2808: Windows builds now ship with optional .pdb files
* #2825: Fix several memory leaks in GwsQueryEngine
* Bundled Tomcat updated to 9.x and now requires Java 8 or higher installed (NOTE: Java support on Linux is broken. See Known Issues below)

== New Features in 4.0 (as of preview 2) ==

**NOTE: 4.0 Preview 2 is a snapshot of the current work in progress and is not indicative of what the 4.0 final release may look like**

* [New in Preview 2] New development HTTP web server to easily stand up a mapagent without IIS or Apache [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc181 MapGuide RFC 181]

* Massive tile set improvements
  * [New in Preview 2] Support for Mapbox Vector Tiles as tile output format [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc177 MapGuide RFC 177]
  * Support for UTFGrid as tile output format [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc159 MapGuide RFC 159]
  * [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc170 MapGuide RFC 170]
    * Support for meta-tile generation
    * Support for a localized version of the (previously serverconfig.ini global) `TileExtentOffset` setting
  * [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc173 MapGuide RFC 173]
    * Support for "retina" (aka. hi-dpi) tile generation 
    * Removed tile set restrictions for `MgMap` creation

* WFS/WMS improvements
  * [New in Preview 2] Built-in OpenLayers browser preview support [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc181 MapGuide RFC 181]
  * Support for GeoJSON output in WFS `GetFeature` and WMS `GetFeatureInfo` [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc163 MapGuide RFC 163]
    * Geometry output is configurable through resource metadata
  * Support for hit count mode (`resultType=hits`) for WFS `GetFeature` [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc175 MapGuide RFC 175]

* New APIs
  * [New in Preview 2] New init entry point to allow proper init of MapGuide API in a pure class library context [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc182 MapGuide RFC 182]
  * Geometry simplification APIs [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc153 MapGuide RFC 153]
  * Creating `MgMap` instances with initial display parameters [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc157 MapGuide RFC 157]
  * "Clean and simplified" JSON output in mapagent [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc158 MapGuide RFC 158]
    * mapagent operations that return feature data is outputted as GeoJSON under this mode
  * Geo-processing operations for mapagent [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc161 MapGuide RFC 161]
  * Batch coordinate transformation support in mapagent and transformation support for geometry data [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc162 MapGuide RFC 162]
  * New MgMap properties to describe newly surfaced tile set properties introduced with MapGuide RFC 173

* Other:
  * New Layer Definition schema revision to support toggle-able feature bounds [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc178 MapGuide RFC 178]
  * New `mgserver` commands for package loading and password setting [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc160 MapGuide RFC 160]
  * GD Renderer support has been removed [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc174 MapGuide RFC 174]

== Known Issues ==

TBD

== Maestro Authoring Known Issues ==

The current release of MapGuide Maestro (6.0m10) has some known issues when connecting to a 4.0 preview 1 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 1 is built against FDO trunk (TBD)

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

 * 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 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:

 * [http://download.osgeo.org/mapguide/releases/4.0.0/Preview1/Dictionaries_Extra.7z 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||

== Known Issues ==

 * Java support is not operational on Linux possibly due to some missing configuration needed since migrating to Tomcat 9.x (all {{{.jsp}}} requests cause Tomcat to return HTTP status 403). This does not happen on Windows. We lack the resources to properly investigate the cause and prescribe a proper fix. If you are able to assist in this matter or know what the fix is, please reply to (this ticket: #2828) or reply to the mapguide-users mailing list.

Please [wiki:SubmitTicket report any issues you find].