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


Ignore:
Timestamp:
Mar 17, 2016, 6:06:00 AM (6 years ago)
Author:
jng
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Release/3.1/Notes

    v1 v1  
     1= !MapGuide 3.1 Release Notes =
     2
     3MapGuide Open Source 3.1 Beta 1 is now available
     4
     5 * Milestone: [http://trac.osgeo.org/mapguide/milestone/3.1 3.1]
     6 * [http://trac.osgeo.org/mapguide/query?status=closed&group=component&resolution=fixed&milestone=3.1&order=status Resolved Tickets]
     7
     8[[TOC]]
     9
     10== Installation ==
     11
     12Windows 32 bit installer:
     13 * [TBD]
     14   * Size: TBD
     15   * md5: TBD
     16Windows 64 bit installer:
     17 * [TBD]
     18   * Size: TBD
     19   * md5: TBD
     20Windows 32-bit MgInstantSetup bundle:
     21 * [TBD]
     22   * Size: TBD
     23   * md5: TBD
     24Windows 64-bit MgInstantSetup bundle:
     25 * [TBD]
     26   * Size: TBD
     27   * md5: TBD
     28Ubuntu 12.04 install script (32-bit):
     29 * [TBD]
     30   * Size: TBD
     31   * md5: TBD
     32 * Uninstall script: [TBD]
     33   * Size: TBD
     34   * md5: TBD
     35Ubuntu 12.04 install script (64-bit):
     36 * [TBD]
     37   * Size: TBD
     38   * md5: TBD
     39 * Uninstall script: [TBD]
     40   * Size: TBD
     41   * md5: TBD
     42CentOS 6.x install script (32-bit):
     43 * [TBD]
     44   * Size: TBD
     45   * md5: TBD
     46 * Uninstall script: [TBD]
     47   * Size: TBD
     48   * md5: TBD
     49CentOS 6.x install script (64-bit):
     50 * [TBD]
     51   * Size: TBD
     52   * md5: TBD
     53 * Uninstall script: [TBD]
     54   * Size: TBD
     55   * md5: TBD
     56
     57== Sample Data ==
     58
     59This release includes a new version of the Sheboygan Sample data set demonstrating features introduced in this and recent versions of MapGuide
     60
     61 * [TBD]
     62   * Size: TBD
     63   * md5: TBD
     64
     65== Extra Files ==
     66
     67The 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.
     68
     69As a result, our installation packages are now up to 150 MB lighter as a result of this omission.
     70
     71Should you require these grid data files, you can download them here:
     72
     73 * [TBD]
     74   * Size: TBD
     75   * md5: TBD
     76
     77To 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
     78
     79== Fusion build tools ==
     80
     81Fusion 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.
     82
     83Use 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
     84
     85In order to use the Fusion build tools, you need to have [http://ant.apache.org Apache Ant] installed.
     86
     87 * [TBD]
     88   * Size: TBD
     89   * md5: TBD
     90
     91To 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:
     92
     93{{{
     94ant compress
     95}}}
     96
     97This will re-build fusionSF.js and fusionSF-compressed.js under fusion\lib
     98
     99Due 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.
     100
     101== Windows Compatibility ==
     102
     103||||32-bit||64-bit||
     104||Windows 10||Yes+||Yes+||
     105||Windows Vista||Maybe+||Maybe+||
     106||Windows 7||Yes||Yes||
     107||Windows Server 2008||Yes+||Yes+||
     108||Windows Server 2008 R2||N/A||Yes||
     109||Windows 8||Yes1||Yes1||
     110||Windows Server 2012||N/A||Yes1||
     111||Windows 8.1||Maybe1||Maybe1||
     112
     113+ Not tested, but similar enough to Windows 7 to theoretically work
     114
     115* IIS configuration will probably not work. Apache config should work due to its self-contained nature
     116
     1171 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
     118
     119Windows RT (ie. Windows 8 on ARM devices) is not a supported platform for installing MapGuide Open Source
     120
     121== Major New Items ==
     122
     123=== MapGuide ===
     124
     125 * New Layer Definition cache for faster Layer Definition access [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc151 MapGuide RFC 151]
     126 * Web Tier component updates [https://trac.osgeo.org/mapguide/wiki/MapGuideRfc155 MapGuide RFC 155]
     127    * PHP updated to 5.5.33
     128    * Apache updated to 2.4.18
     129    * Tomcat updates to 7.0.68
     130
     131=== Fusion ===
     132
     133 * TBD
     134
     135=== New schema revisions ===
     136
     137 * None
     138
     139=== New/Changed APIs ===
     140
     141 * None
     142
     143=== Other ===
     144
     145Please [wiki:SubmitTicket report any defects].
     146
     147== FDO Notes ==
     148
     149MGOS 3.1 is compatible with FDO 4.1
     150
     151This release is built against the FDO 4.1 branch
     152
     153== Installer notes ==
     154
     155Installing MGOS 3.1 (via the windows installer) alongside any older release '''is not a currently supported configuration'''. Consider using the MgInstantSetup bundle instead if you desire side-by-side installation
     156
     157The installer '''does not''' currently support IIS Express as an IIS configuration option.
     158
     159Please observe the updated software requirements if you are using .net and/or IIS configuration:
     160
     161 * IIS (all versions) require FastCGI for IIS to be installed. For IIS7 and above, you can install FastCGI by enabling the CGI feature of your IIS installation. See [http://learn.iis.net/page.aspx/246/using-fastcgi-to-host-php-applications-on-iis/#EnableFastCGI this link] for more information.
     162 * The supported .net Framework version for the MapGuide .net API is '''4.0'''. You must have this version of the .net Framework installed before proceeding with installation.
     163
     164Java configuration requires Java 6 (1.6.0) or higher.
     165
     166The MgInstantSetup bundles only work with '''IIS7 or higher''' if you choose to use this web server. You must still satisfy  the .net and FastCGI software requirements required for this configuration.
     167
     168To assist new MapGuide users and developers, the installer also now bundles the following optional components:
     169
     170 * .net/PHP/Java viewer samples
     171 * MapGuide Developer's Guide in HTML format with updated content
     172 * .net/PHP/Java Developer's Guide Samples
     173
     174All bundled samples require the [http://download.osgeo.org/mapguide/releases/3.0.0/Beta1/Sheboygan.mgp Sheboygan dataset] to be loaded into the MapGuide Server.
     175
     176A restart of Apache and/or IIS may be required for PHP to work.
     177
     178For the InstantSetup bundles, the MgInstantSetup utility requires .net Framework 4.0 to run. This is in addition to whatever existing software requirements imposed by this release of MapGuide Open Source.
     179
     180For Tomcat configuration, the installer currently does not install Tomcat as a service (#953). You will have to do this manually post-installation by [http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.68/bin/apache-tomcat-7.0.68.exe grabbing the tomcat windows service installer from the Tomcat download site]
     181
     182Also ensure that you install the JVM of the same bitness as your installation of MapGuide. For example, you will get a {{{java.lang.UnsatisfiedLinkError}}} if you attempt to run a Tomcat from a 32-bit MapGuide installation on a 64-bit JVM. If you have both 32 and 64-bit JVMs installed, you must ensure that the Tomcat bundled with MapGuide is using the correct one. Tomcat will generally use the one indicated by the {{{JAVA_HOME}}} environment variable, so this may have to be set and/or overridden.
     183up
     184
     185Note that upgrading Apache from 2.2.x to 2.4.x has introduced changes to some configuration directives. If you have any custom httpd directives defined in your current MapGuide installation, please consult the [https://httpd.apache.org/docs/2.4/upgrading.html upgrade notes] for any changes you have to do when migrating/upgrading your Apache-based MapGuide installation to this release.
     186
     187If you have PHP-based MapGuide applications, consult the [http://php.net/manual/en/migration54.php 5.3 to 5.4 migration guide] and [http://php.net/manual/en/migration55.php 5.4 to 5.5 migration guide] for any API and compatibility issues that may be present in your MapGuide application as a result of moving to PHP 5.5
     188
     189Should you choose to uninstall the Linux build of this release at any time, download and the respective uninstaller script. This ensures that any proper service un-registration is also performed.
     190
     191== Known Issues ==
     192 
     193 * On Ubuntu, bash needs to be the default shell due to bash-isms in the service control scripts (#2497)
     194 * 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.
     195 * Using the Linux builds of MapGuide on distributions they were not built for is not supported. If you want to run MapGuide on:
     196   * Versions of Ubuntu newer than 12.04
     197   * CentOS 7 or higher
     198   * A different Linux distribution
     199   
     200   Then consider running MapGuide in a [https://www.docker.com/ docker container] that is based on Ubuntu 12.04 or CentOS 6.x. This installation method is not supported and is only mentioned here for informational purposes.
     201 
     202 * The following FDO providers may or may not not be functional in 64-bit Linux builds of MapGuide
     203   * SHP (spatial indexing code not working properly in 64-bit, will cause incorrect spatial queries. Workaround: Use OGR provider)
     204   * MySQL (un-tested, please provide feedback)
     205   * PostgreSQL (un-tested, please provide feedback)
     206   * King.Oracle (un-tested, please provide feedback)
     207   * WFS (un-tested, please provide feedback)
     208   * WMS (un-tested, please provide feedback)
     209
     210 * 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:
     211   * SDF
     212   * SQLite
     213   * GDAL
     214   * OGR
     215
     216 * 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.
     217 * #2252: It is not possible to call MgFeatureService::UpdateFeatures() with a NULL MgTransaction in the PHP API
     218 * 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.
     219 * CentOS: mgserver may throw double-free errors on service startup or server shutdown. Should not affect server behaviour.
     220 * 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.
     221 * 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
     222 * 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'''
     223   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
     224{{{appcmd.exe list vdir}}}
     225 * 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.
     226 * 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.