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


Ignore:
Timestamp:
Apr 30, 2011, 7:44:00 AM (13 years ago)
Author:
trevorwekel
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Release/2.2/Notes

    v1 v1  
     1= !MapGuide 2.2 Release Notes =
     2
     3!MapGuide Open Source 2.2 Official Release is now available!
     4
     5 * Release wiki: [wiki:Release/2.2]
     6 * Milestone: [milestone:2.2 2.2]
     7 * [query:?status=closed&group=component&resolution=fixed&milestone=2.2&order=status Resolved Tickets]
     8
     9== Installation ==
     10
     11Binaries for Windows and Linux have been posted to OSGeo
     12
     13Windows 32 bit installer packaged in a zip:
     14 * [http://download.osgeo.org/mapguide/releases/2.2.0/Release/MapGuideOpenSource-2.2.0.5703-Release.zip MapGuideOpenSource-2.2.0.5703-Release.zip]
     15  * size:123,383,930 bytes
     16  * md5sum:c59d6afc50ac20f90163e3e743e211c7
     17Windows 64 bit installer packaged in a zip:
     18 * [http://download.osgeo.org/mapguide/releases/2.2.0/Release/MapGuideOpenSource-2.2.0.5703-Release-x64.zip MapGuideOpenSource-2.2.0.5703-Release-x64.zip]
     19  * size:123,606,367 bytes
     20  * md5sum:19cbe9f862c0eb38641a76738fe0ab1e
     21CentOS 5.4 / !RedHat 5.4 binary tarballs for FDO and !MapGuide:
     22 * [http://download.osgeo.org/fdo/3.5.0/release/binaries/linux/fdosdk-centos5-3.5.0.tar.gz fdosdk-centos5-3.5.0.tar.gz]
     23  * size:27,082,408 bytes
     24  * md5sum:78ee57fd1993794bbbc0e730d8fa64a6
     25 * [http://download.osgeo.org/mapguide/releases/2.2.0/Release/mapguideopensource-2.2.0.5703-centos5.tar.gz mapguideopensource-2.2.0.5703-centos5.tar.gz]
     26  * size: 185,288,425 bytes
     27  * md5sum:fe908b929d09f66a82afb66caaceac80
     28Ubuntu 9.10 install script:
     29 * Due to compilation limitations, the Ubuntu build is based on CentOS 5.4 binaries.  The installation script installs additional Ubuntu packages and creates symlinks to native Ubuntu libraries to resolve package differences between CentOS 5.4 and Ubuntu 9.10.
     30 * [http://download.osgeo.org/mapguide/releases/2.2.0/Release/ubuntu9/mginstallubuntu.sh mginstallubuntu.sh]
     31  * size:1987 bytes
     32  * md5sum:440753be9d36b1ba14ecd4dba50c726d
     33
     34== Fixes from !MapGuide 2.2 RC3 Build ==
     35=== !MapGuide ===
     36 * [http://trac.osgeo.org/mapguide/ticket/1601 MgLayer constructor is not thread safe]
     37 * [http://trac.osgeo.org/mapguide/ticket/1613 Cannot establish connection with login.php on Ubuntu 10.04 LTS]
     38 * [http://trac.osgeo.org/mapguide/ticket/1614 Updated MapGuide Developer's Guide]
     39
     40=== Fusion ===
     41 * [http://trac.osgeo.org/fusion/ticket/428 MapGroup problem with tiled and dynamic mapguide layers]
     42
     43
     44== Major New Items ==
     45
     46 * GDAL Raster Provider Support.  See [http://trac.osgeo.org/mapguide/wiki/MGOS22GdalProvider MapGuide 2.2 GDAL Raster Provider]
     47
     48Thanks to the ever growing team of developers who are contributing to make the !MapGuide Open Source project a more self-sustaining project. 
     49
     50Please [wiki:SubmitTicket report any defects].
     51
     52== Compatibility ==
     53Click [wiki:2.2MigrationInstructions here] for instructions on how to migrate to MGOS 2.2 from older releases.
     54
     55MGOS 2.2.0 is compatible with [http://fdo.osgeo.org/content/fdo-350-downloads FDO 3.5.0].
     56
     57== FDO ==
     58
     59FDO is compiled against the Oracle 11.2 instant client available from [http://www.oracle.com/technology/software/tech/oci/instantclient/index.html?rssid=rss_otn_soft Instant Client Downloads].  For a Linux installation, the Oracle shared library path should be included in LD_LIBRARY_PATH or ldconfig.
     60
     61FDO 3.5 (which this release uses) introduces a [http://trac.osgeo.org/fdo/wiki/FDORfc22 simplified CONCAT expression function]. This function is available for theming and filtering purposes.
     62
     63== Installer notes ==
     64
     65The installer has been updated to allow for greater customisation of the initial configuration:
     66
     67 * User-defined server/web port numbers
     68 * User-defined virtual directory name for both Apache and IIS
     69 * User-defined Apache port number
     70 * The choice of which web site to install the web extensions under (IIS 6.0)
     71
     72Currently the installer is still only 32-bit.
     73
     74== API changes ==#ApiChanges
     75[wiki:MapGuideRfc66 RFC 66] added client side pinging for the !AjaxViewer to keep sessions alive.  API changes include a new HTTP GETSESSIONTIMEOUT and !MgSiteConnection.!GetSessionTimeout().  An <!EnablePingServer> boolean element was added to !WebLayout.  Since these are new APIs, there is no impact on existing code.
     76
     77[wiki:MapGuideRfc70 RFC 70] introduces new API for creating and modifying the schema of a feature source.  Delete methods are added to !MgFeatureSchema, !MgClassDefinition and !MgPropertyDefinition.  A new !ApplySchema() method was added to !MgFeatureService.  A Decimal property was added to !MgPropertyType for schema purposes. Since these are new APIs, there is no impact on existing code. 
     78
     79
     80[wiki:MapGuideRfc73 RFC 73] introduces a new !GetResourceContents() API to !MgResourceService.  This new functionality is used internally by !MgMap to reduce web extensions / server crosstalk when creating an !MgMap object from a map definition.  Since this is new API, there is no impact on existing code.
     81
     82[wiki:MapGuideRfc74 RFC 74] introduces a boolean "cascade" parameter to !MgResourceService.!MoveResource().  If cascade is enabled, dependant resources will be updated to point at the new location for the moved resource. Since this is new API, there is no impact on existing code.
     83
     84[wiki:MapGuideRfc78 RFC 77] allows !MgFeatureService.!CreateFeatureSource() to create a feature source without defining the feature class and spatial context.  The previous implementation would throw an !MgInvalidArgumentException.  '''This behaviour change may affect existing code.'''[[BR]]
     85
     86[wiki:MapGuideRfc78 RFC 78] introduces explicit transaction management for Feature Service.  A new !MgTransaction object is created and !MgFeatureService !ExecuteSqlQuery, !ExecuteSqlNonQuery, and !UpdateFeatures are overloaded to use the new transaction object.  Since this is new API, there is no impact on existing code.
     87
     88[wiki:MapGuideRfc79 RFC 79] adds more detailed exception classes derived from !MgFdoException.  The derived classes provide more information than the generic !MgFdoException.  Existing code should continue to work with !MgFdoException and should be updated to make use of the derived exception classes.
     89
     90[wiki:MapGuideRfc80 RFC 80] adds parameter binding support to !MgFeatureService !ExecuteSqlQuery and !ExecuteSqlNonQuery.  Since this is new API, there is no impact on existing code.
     91
     92[wiki:MapGuideRfc82 RFC 82] extends the !MapGuide readers to support property access by index in addition to property name.  Accessing properties by index instead of property name may be faster for tight loop processing.  Since this is new API, there is no impact on existing code.
     93
     94[wiki:MapGuideRfc84 RFC 84] adds database row fetch size to !MgFeatureQueryOptions and !MgFeatureService.!ExecuteSqlQuery.  Specifying a fetch size may improve FDO performance by reducing database round trips.    Since this is new API, there is no impact on existing code.
     95
     96[wiki:MapGuideRfc87 RFC 87] adds to the schema returned from the HTTP GETSITEINFO request.  If version 2.2.0 of GETSITEINFO is used, the following addiitional information will be returned working set, virtual memory, server cache size and server cache dropped entries.  Since this is new version of GETSITEINFO, there is no impact on existing code.[[BR]][[BR]]
     97 
     98[wiki:MapGuideRfc89 RFC 89] introduced a number of changes required by the upgrade to PHP 5.3.  '''These changes break existing code.'''
     99{{{
     100MgException class changes:
     101Change GetMessage() to GetExceptionMessage()
     102
     103MgResources class changes:
     104Change GetMessage() to GetResourceMessage()
     105
     106MgCoodinateSystem class changes:
     107Change GetCode() to GetCsCode()
     108Change SetCode() to SetCsCode() for consistency.
     109Change IsLegalCode() to IsLegalCsCode() for consistency.
     110
     111MgCoodinateSystemDatum class changes:
     112Change GetCode() to GetDtCode()
     113Change SetCode() to SetDtCode() for consistency.
     114Change IsLegalCode() to IsLegalDtCode() for consistency.
     115
     116MgCoodinateSystemEllipsoid class changes:
     117Change GetCode() to GetElCode()
     118Change SetCode() to SetElCode() for consistency.
     119Change IsLegalCode() to IsLegalElCode() for consistency.
     120
     121MgWebInvokeScriptCommand class changes:
     122Change GetCode() to GetScriptCode()
     123Change SetCode() to SetScriptCode() for consistency.
     124}}}
     125
     126The RFC 87 API changes will impact:
     127 * Viewers
     128 * Sample applications
     129 * Development guides
     130 * Existing applications
     131
     132
     133== New Server Configuration (serverconfig.ini) Options ==
     134
     135== New Web Configuration (webconfig.ini) Options ==
     136
     137== Disk Space ==
     138
     139The installer requires at least 1.5GB of disk space on C: during installation. Otherwise installation may not proceed.
     140
     141If you do not have sufficient space on C:, you can open the installer file with [http://www.7-zip.org 7-zip] and extract the contents to another drive, and run the extracted setup.exe from there.  It may also be helpful to set your TEMP environment variable to a different drive.
     142
     143== Submissions ==
     144
     145The complete list of submissions can be found [http://trac.osgeo.org/mapguide/timeline?from=05%2F3%2F10&daysback=348&changeset=on&update=Update here].