Changes between Initial Version and Version 1 of Release/3.1.1/Notes


Ignore:
Timestamp:
03/20/18 08:53:27 (7 years ago)
Author:
jng
Comment:

Initial 3.1.1 release notes

Legend:

Unmodified
Added
Removed
Modified
  • Release/3.1.1/Notes

    v1 v1  
     1= !MapGuide 3.1.1 Release Notes =
     2
     3MapGuide Open Source 3.1.1 RC is now available. These release notes only cover what's changed from MapGuide Open Source 3.1.0
     4
     5For what's new and changed in MapGuide Open Source 3.1.0, see the [https://trac.osgeo.org/mapguide/wiki/Release/3.1/Notes 3.1 release notes]
     6
     7[[TOC]]
     8
     9== Downloads ==
     10
     11||Download||Size||MD5||
     12||'''Windows'''||
     13||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/windows/MapGuideOpenSource-3.1.0.9064-Final-x86.exe 32-bit installer]||111,254,256||bbd8719ad3863e311b16bbaaef205cb2||
     14||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/windows/MapGuideOpenSource-3.1.0.9064-Final-x64.exe 64-bit installer]||118,325,579||589f311caefe88472851da674b6a921c||
     15||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/windows/MapGuideOpenSource-3.1.0.9064-InstantSetup-x86.exe 32-bit InstantSetup bundle]||91,346,101||d57d94abe80c571fad6085a72359c7f1||
     16||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/windows/MapGuideOpenSource-3.1.0.9064-InstantSetup-x64.exe 64-bit InstantSetup bundle]||97,279,413||d5bfdc579fb811fddb7261c382c7a14f||
     17||'''Ubuntu 14.04 (32-bit)'''||
     18||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/ubuntu14_x86/mginstallubuntu.sh Install script]||26,776||02b553ef15f5f456beba3f8131c3ad05||
     19||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/ubuntu14_x86/mguninstallubuntu.sh Uninstall script]||1,425||c8794eba45069355203bd14522298069||
     20||'''Ubuntu 14.04 (64-bit)'''||
     21||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/ubuntu14_x64/mginstallubuntu.sh Install script]||26,778||04ba8dc787d796dc546a9154cb13f5f0||
     22||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/ubuntu14_x64/mguninstallubuntu.sh Uninstall script]||1,425||c8794eba45069355203bd14522298069||
     23||'''CentOS 6.x (32-bit)'''||
     24||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/centos6_x86/mginstallcentos.sh Install script]||4,153||cd73ad96c31b0a4c712102fe072f65d9||
     25||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/centos6_x86/mguninstallcentos.sh Uninstall script]||1,599||e7667dd4af45903a3c88f6c7133152e0||
     26||'''CentOS 6.x (64-bit)'''||
     27||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/centos6_x64/mginstallcentos.sh Install script]||4,155||f9290832261bbe5dae1f8311cd199f83||
     28||[http://download.osgeo.org/mapguide/releases/3.1.0/Final/centos6_x64/mguninstallcentos.sh Uninstall script]||1,599||e7667dd4af45903a3c88f6c7133152e0||
     29
     30== Sample Data ==
     31
     32This release includes a new version of the Sheboygan Sample data set demonstrating features introduced in this and recent versions of MapGuide
     33
     34 * [http://download.osgeo.org/mapguide/releases/3.0.0/extras/Sheboygan.mgp Sheboygan.mgp]
     35   * Size: 13,604,700 bytes
     36   * md5: 351b21e2c432b493fe2f073d7ab10205
     37
     38== Extra Files ==
     39
     40The install packages for this release of MapGuide omit several USA-specific CS-Map grid data files which are only required if your spatial data uses a coordinate system that involves an NSRS datum. See [http://trac.osgeo.org/csmap/wiki/CsMapRfc7 CS-Map RFC 7] for more information.
     41
     42As a result, our installation packages are now up to 150 MB lighter as a result of this omission.
     43
     44Should you require these grid data files, you can download them here:
     45
     46 * [http://download.osgeo.org/mapguide/releases/3.0.0/extras/CsMap_Usa_NSRS_GridFiles.zip]
     47   * Size: 147,411,504 bytes
     48   * md5: 9f90097d78f16b132a2319a885646b0d
     49
     50To install these files, unzip them into the `Usa` directory of your CS-Map installation (eg. C:\Program Files\OSGeo\MapGuide\CS-Map\Dictionaries\Usa) and restart your MapGuide Server
     51
     52== Fusion build tools ==
     53
     54Fusion build tools is a zip file containing the build.xml and associated build tools required to "re-compile" fusionSF.js and fusionSF-compressed.js on a production fusion installation.
     55
     56Use the Fusion build tools if you have made patches and/or modifications to your fusion installation, and you need to build a new fusionSF.js and/or fusionSF-compressed.js
     57
     58In order to use the Fusion build tools, you need to have [http://ant.apache.org Apache Ant] installed.
     59
     60 * [http://download.osgeo.org/mapguide/releases/3.1.0/Final/windows/fusion-3.1.0-buildtools.zip fusion-3.1.0-buildtools.zip]
     61   * Size: 7,047,652 bytes
     62   * md5: 23158d432ff3159c7c13cca6fc46f062
     63
     64To use the Fusion build tools, extract the zip file contents into your fusion directory and navigate to this directory in the command prompt and execute the following command:
     65
     66{{{
     67ant compress
     68}}}
     69
     70This will re-build fusionSF.js and fusionSF-compressed.js under fusion\lib
     71
     72Due to the default installation location (under Program Files), you may need to do this under a UAC-elevated command prompt or fix the directory permissions so that normal users can create/modify files.
     73
     74== Windows Compatibility ==
     75
     76||OS||32-bit||64-bit||
     77||Windows 10||Yes+||Yes||
     78||Windows Vista||Maybe+||Maybe+||
     79||Windows 7||Yes||Yes||
     80||Windows Server 2008||Yes+||Yes+||
     81||Windows Server 2008 R2||N/A||Yes||
     82||Windows 8||Yes1||Yes1||
     83||Windows Server 2012||N/A||Yes1||
     84||Windows 8.1||Maybe1||Maybe1||
     85
     86+ Not tested, but similar enough to Windows 7 to theoretically work
     87
     88* IIS configuration will probably not work. Apache config should work due to its self-contained nature
     89
     901 IIS/.Net successfully tested on Windows 8 64-bit and Windows Server 2012. Windows 8 32-bit is similar enough to theoretically work. Apache config untested
     91
     92Windows RT (ie. Windows 8 on ARM devices) is not a supported platform for installing MapGuide Open Source
     93
     94== Changes since 3.1.0 ==
     95
     96=== MapGuide ===
     97
     98 * Updated Web Tier components ([wiki:MapGuideRfc165])
     99   * Apache HTTPD 2.4.29
     100   * PHP 5.6.33
     101   * Tomcat 7.0.85
     102 * Fix ApiVersion being reported as 2.6 in {{{GETSITESTATUS}}} mapagent operation
     103 * Hardened various PHP scripts in the mapagent
     104 * Ubuntu install script improvements/fixes:
     105   * New flags that are applicable when {{{--headless}}} is specified:
     106     * Support {{{--no-service-install}}}: To skip automatic installation of service scripts
     107     * Support {{{--no-mgserver-start}}}: To skip auto-starting mgserver
     108     * Support {{{--no-tomcat-start}}}: To skip auto-starting tomcat
     109     * Support {{{--no-httpd-start}}}: To skip auto-starting httpd
     110     * #2760: Remove bash-isms
     111 * #2752: Fix CREATERUNTIMEMAP for raster and DWF layers
     112 * #2749: Fix bloated NuGet packages due to extra junk files slipping through packaging
     113 * #2754: Fail to stylize layer when expression in symbol definition has invalid value
     114 * #2750: Isapi mapagent crashes when server error message is too long
     115 * #2767: Add missing JSON format conversion support for various mapagent APIs
     116 * #2764: AJAX Viewer Select Within returns all features when actually no result should be found
     117 * #2582: Include bad resource identifier string in exception message if "new MgResourceIdentifer()" throws
     118 * #2480: Return -1 for {{{GetPropertyIndex}}} reader calls with bad property names instead of throwing
     119
     120=== FDO ===
     121
     122 * [https://trac.osgeo.org/fdo/ticket/941 #941]: Fix expression function sin(int) returning invalid value
     123 * [https://trac.osgeo.org/fdo/ticket/946 #946]: Fix expression engine segfault when parsing identifiers with mixed quotes
     124 * [https://trac.osgeo.org/fdo/ticket/912 #912]: GDAL/OGR/WMS providers updated to use GDAL 2.2.3
     125    - You can swap out the GDAL dll with an equivalent custom GDAL build from gisinternals (http://www.gisinternals.com/stable.php). Make sure you are downloading the MSVC 2015 build for this.
     126    - Updated instructions here: [wiki:MGOS311GdalProvider]
     127    - Reminder that by using drivers like ECW/MrSID/etc you are bound by their terms of use in their respective licensing agreements.
     128    - Another reminder that swapping the GDAL dll with a custom one is not supported by us. Use at your own risk/discretion.
     129 - OGR provider fixes:
     130    - [https://trac.osgeo.org/fdo/ticket/937 #937]: Better handling/support of VRT data sources
     131    - [https://trac.osgeo.org/fdo/ticket/938 #938]: Don't advertise insert/update/delete commands for read-only connections
     132    - Ensure dots in property names are replaced with tildes (~) as dot characters are illegal characters in FDO property names.
     133    - Better FDO exception error propagation from failed GDAL/OGR API calls within the provider.
     134    - New GDAL 2.x capabilities are surfaced to their FDO counterparts
     135        - int64 data types
     136        - nullable fields
     137        - default values
     138 - WFS provider fixes:
     139    - [https://trac.osgeo.org/fdo/ticket/915 #915]: Features not fully loaded
     140    - [https://trac.osgeo.org/fdo/ticket/917 #917]: Curve strings properly serialized to their GML counterparts
     141    - [https://trac.osgeo.org/fdo/ticket/932 #932]: xsd:long values no longer capped at 2147483647 if value is beyond that.
     142 - WMS provider fixes:
     143    - [https://trac.osgeo.org/fdo/ticket/931 #931]: Fix SSL connect error if connecting to a WMS server using TLS 1.2
     144 - PostgreSQL provider fixes:
     145    - [https://trac.osgeo.org/fdo/ticket/923 #923]: Better handling of check constraint clauses (eg. '10'::integer)
     146    - [https://trac.osgeo.org/fdo/ticket/761 #761]: Fix segfaults on 64-bit Linux in geometry serialization
     147    - [https://trac.osgeo.org/fdo/ticket/943 #943]: Add support for detecting materialized views
     148 - SHP provider fixes:
     149    - Fix SHP file cannot be read if it had been opened for writing
     150 - SQL Server provider fixes:
     151    - [https://trac.osgeo.org/fdo/ticket/933 #933]: ***No longer tries to connect to and list every database on the SQL Server, only the ones your login credentials can actually access***.
     152    - [https://trac.osgeo.org/fdo/ticket/920 #920]: Computed columns now properly advertised as read-only properties in the FDO schema
     153    - [https://trac.osgeo.org/fdo/ticket/930 #930]: Allow spatial contexts for tables with dots (.) in their names to be retrieved
     154    - (Long standing) patches from Bruno Scott:
     155       - [https://trac.osgeo.org/fdo/ticket/875 #875]: Date columns not appearing in FDO schemas
     156       - [https://trac.osgeo.org/fdo/ticket/766 #766]: Use locale-independent date formatting
     157
     158=== Fusion ===
     159
     160 - Updated to use Bing Maps instead of VirtualEarth, whose APIs were shutdown in mid-2017. A Bing Maps API key is now required to consume these services.
     161   - [https://trac.osgeo.org/fusion/ticket/658 #658]: Add missing {{{AerialsWithLabels}}} base layer type
     162 - Use HTTP POST for creating session ids
     163 - [https://trac.osgeo.org/fusion/ticket/654 #654]: Update to handle the corrected {{{CREATERUNTIMEMAP}}} response (#2752)
     164 - [https://trac.osgeo.org/fusion/ticket/656 #656]: Fix error selecting redline objects
     165 - [https://trac.osgeo.org/fusion/ticket/657 #657]: Fix search widget not working for FDO properties with spaces in their names
     166 - [https://trac.osgeo.org/fusion/ticket/660 #660]: Better gracefully handle bad app def resource ids passed in
     167 - #2772: Fix de-selecting features not updating selection pane
     168 - #2770: Fall back to selection XML based zooming for search widget if centroid of the current feature cannot be extracted
     169 - Hide group in legend tree if it is empty.
     170 - Set map initial active state in "Maps" menu.
     171 - If there are more than one base layer groups and one of them is invisible initially, the features of the layer in the group cannot be selected after show the group.
     172 - Suppress Fusion error in client when query features/get map tip
     173 - Turn off map tip by default
     174 - Fix: Features are selected when using measure tool.
     175 - Measure widget fixes:
     176   - fusion error if zoom after click 'Measure' button
     177   - If there are 2 'Measure' defined (one for distance, the other for area), when switch between the 2 buttons, the 'Unload' of previous page is always after the new page's 'activate', which results in values of some global variables e.g. isDigitizing are not correct
     178 
     179
     180=== Other ===
     181
     182Please [wiki:SubmitTicket report any defects].
     183
     184== FDO Notes ==
     185
     186MGOS 3.1.1 is built against the FDO 4.1 branch
     187
     188'''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'''
     189
     190== Installer notes ==
     191
     192You cannot use the windows installer to in-place upgrade an existing MapGuide Open Source 3.1.0 installation, you cannot have 3.1.0 and 3.1.1 installed side-by-side with the windows installer and you must uninstall 3.1.0 before installing 3.1.1. 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.
     193
     194On linux, the install path is {{{/usr/local/mapguideopensource-3.1.1}}} and the FDO install path is {{{/usr/local/fdo-4.1.0}}}. You must uninstall 3.1.0 before installing 3.1.1. Be sure to back up any data and applications before carrying out the new installation.
     195
     196== Known Issues ==
     197
     198 * SQL Server Spatial: FDO Provider may render out incomplete schema XML for tables with dots (.) in their name
     199 * Ubuntu: Tomcat/Java is not optional will always be installed by the installation script whether you use it or not
     200 * Fusion: Geolocation widget will no longer work on Chrome 50+ on insecure origins (https://developers.google.com/web/updates/2016/04/geolocation-on-secure-contexts-only?hl=en). Solution: Host the fusion application on a site over HTTPS.
     201 * Fusion: Google Street View may not load properly in Chrome (https://productforums.google.com/forum/#!topic/maps/7DiQ4FQj8ts). Workaround: Disable "Accelerated 2D canvas" in chrome flags settings.
     202 * Installing msttcorefonts for your specific distro is strongly recommended to avoid the case of "hieroglyphic" labels. You can specify the path of your msttcorefonts installation in serverconfig.ini to have MapGuide load these fonts in on startup.
     203 * Using the Linux builds of MapGuide on distributions they were not built for is not supported. If you want to run MapGuide on:
     204   * Versions of Ubuntu that is not 14.04
     205   * CentOS 7 or higher
     206   * A different Linux distribution
     207   
     208   Then consider running MapGuide in a [https://www.docker.com/ docker container] that is based on Ubuntu 14.04 or CentOS 6.x. This installation method is not supported and is only mentioned here for informational purposes.
     209 * The 64-bit Linux builds of MapGuide are made available for testing/feedback. These builds should still be considered experimental.
     210   * The following FDO providers may or may not not be functional in 64-bit Linux builds of MapGuide
     211     * SHP (spatial indexing code not working properly in 64-bit, will cause incorrect spatial queries. Workaround: Use OGR provider)
     212     * MySQL (un-tested, please provide feedback)
     213     * PostgreSQL (un-tested, please provide feedback)
     214     * King.Oracle (un-tested, please provide feedback)
     215     * WFS (un-tested, please provide feedback)
     216     * WMS (un-tested, please provide feedback)
     217   * The following FDO providers have been validated in a 64-bit Linux environment by their respective FDO unit test suites (ie. All tests pass). Feedback on these providers in 64-bit Linux still welcome/appreciated:
     218     * SDF
     219     * SQLite
     220     * GDAL
     221     * OGR
     222
     223 * Fusion: Bing/VirtualEarth commercial layers may conflict with Google layers if they are both specified in a Flexible Layout. If you have a Bing/VirtualEarth layer as the default, switching to a Google layer in your Fusion application will cause the Google layer to be displaced and vice versa.
     224 * #2252: It is not possible to call MgFeatureService::UpdateFeatures() with a NULL MgTransaction in the PHP API
     225 * Installer may generate a providers.xml entry for the ArcSDE provider if all providers are enabled in the "Feature Selection" dialog even if the installer does not actually bundle the ArcSDE provider. You can simply remove this entry from providers.xml after installation if this is the case.
     226 * CentOS: mgserver may throw double-free errors on service startup or server shutdown. Should not affect server behaviour.
     227 * The Performance Profiler on Linux may not work due to insufficient permissions to save the generated report files. To fix this, ensure the directory {{{/usr/local/mapguideopensource-3.1.0/webserverextensions/www/mapadmin/profilingmapxml}}} on linux has sufficient write permissions for the user account that the PHP executable runs under.
     228 * For an InstantSetup-based install with an Apache configuration, the Performance Profiler is [http://trac.osgeo.org/mapguide/browser/branches/3.0/MgDev/Web/src/mapadmin/performanceReport_MapViewer.php#L43 hard-coded to always use mapviewerjava if it exists for displaying the map viewer] for capturing extents for profiling. If you did not choose a Java configuration you will get the ajaxviewer.jsp source instead of the expected map viewer. To resolve this, delete the mapviewerjava directory
     229 * Uninstallation can leave "ghost" IIS virtual directories behind, which currently is any virtual directory / application you create inside the mapguide virtual directory that '''was not created by the installer'''
     230   These "ghost" directories may impact on future installations. To ensure these "ghost" directories are completely gone after uninstallation, use the appcmd.exe utility to remove these virtual directories. You can find out what virtual directories are still there by running
     231{{{appcmd.exe list vdir}}}
     232 * PHP Viewer and Developer's Guide samples will not work if the PHP viewer feature is not enabled. Likewise for .net and Java. Nothing in the installer will prevent you from making such a choice.
     233 * For the IIS configuration or Apache configuration with a custom http port, you will have to update the WFS and WMS server name configuration properties via the MapGuide Site Administrator after installation if you intend to use such features. This is currently set to localhost:8008 for both.