= !MapGuide 4.0.0 Preview 1 Release Notes = 

MapGuide Open Source 4.0.0 Preview 1 is now available.

[[TOC]]

== Downloads ==

**NOTE: As of MapGuide Open Source 4.0, 32-bit Windows builds are no longer provided and SHA-1 checksums are provided for all binary aritfacts listed**

||Download||Size||SHA-1||
||'''Windows'''||
||[https://download.osgeo.org/mapguide/releases/4.0.0/Preview1/MapGuideOpenSource-4.0.0.9592-Preview-x64.exe 64-bit Windows Installer]||127,267,355 bytes|| af7f84176fe08b0fbf2572ea67f5024a66973c00||
||[https://download.osgeo.org/mapguide/releases/4.0.0/Preview1/MapGuideOpenSource-4.0.0.9592-InstantSetup-x64.exe 64-bit Windows InstantSetup bundle]||105,607,552 bytes|| 1526eaf2012b9a372c986446e7c4e2f7a639de74||

== New Features in 4.0 Preview 1 ==

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

* Massive tile set improvements
  * 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
  * 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
  * 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 `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 ==

 * #2806: `QUERYMAPFEATURES` v4.0.0 request may throw `MgObjectNotFoundException` writing selection keys
   * No known workaround exists besides going back to an older version of this operation, will be addressed by the next preview release.

== 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 (r7843)

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

 * Improved WFS services support for WFS FDO provider

== 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) 

== Sample Data ==

 * [http://download.osgeo.org/mapguide/releases/3.0.0/extras/Sheboygan.mgp Sheboygan.mgp]
   * Size: 13,604,700 bytes
   * md5: 351b21e2c432b493fe2f073d7ab10205

== 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 ==

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