= !MapGuide 2.2 Release Candidate 3 Release Notes = !MapGuide Open Source 2.2 Release Candidate 3 is now available! Your feedback is important to ensuring a stable !MapGuide release. Please report any issues to the mapguide-users email list. A Release Candidate 4 build is tentatively scheduled for March 11th with the !MapGuide 2.2.0 Final Release scheduled for March 25th assuming positive feedback from the community is received on the Release Candidate 3 build. * Release wiki: [wiki:Release/2.2] * Milestone: [milestone:2.2 2.2] * [query:?status=closed&group=component&resolution=fixed&milestone=2.2&order=status Resolved Tickets] == Installation == Binaries for Windows and Linux have been posted to OSGeo Windows 32 bit installer: * [http://download.osgeo.org/mapguide/releases/2.2.0/RC3/MapGuideOpenSource-2.2.0.5518-RC3.exe MapGuideOpenSource-2.2.0.5518-RC3.exe] * size:123,371,520 bytes * md5sum:b23b823679204476811e9118da01b932 Windows 64 bit installer: * [http://download.osgeo.org/mapguide/releases/2.2.0/RC3/MapGuideOpenSource-2.2.0.5518-RC3-x64.exe MapGuideOpenSource-2.2.0.5518-RC3-x64.exe] * size:123,584,512 bytes * md5sum:53707843d96d7734308b4b9894f4c3d9 CentOS 5.4 / !RedHat 5.4 binary tarballs for FDO and !MapGuide: * [http://download.osgeo.org/fdo/3.5.0/rc2/binaries/linux/fdosdk-centos5-3.5.0_5667.tar.gz fdosdk-centos5-3.5.0_5667.tar.gz] * size:27,285,752 bytes * md5sum:15e55e875af902c92dba2ae900373603 * [http://download.osgeo.org/mapguide/releases/2.2.0/RC3/mapguideopensource-2.2.0.5518-centos5.tar.gz mapguideopensource-2.2.0.5518-centos5.tar.gz] * size: 185,299,109 bytes * md5sum:b23444beb94cc6b0c1b1f0ea6cb8b762 Ubuntu 9.10 install script: * 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. * [http://download.osgeo.org/mapguide/releases/2.2.0/RC3/ubuntu9/mginstallubuntu.sh mginstallubuntu.sh] * size:1875 bytes * md5sum:605ff797dc7e3d2dadade7b04d1294b7 == Fixes from !MapGuide 2.2 RC1 Build == === !MapGuide === * [http://trac.osgeo.org/mapguide/ticket/1236 "Sticky" tooltips] * [http://trac.osgeo.org/mapguide/ticket/1481 getselectedfeatures should use more efficient centroid processing] * [http://trac.osgeo.org/mapguide/ticket/1474 Properties don't show up in Ajax viewer] * [http://trac.osgeo.org/mapguide/ticket/1476 mgserver lock up using GDAL Plugins (mrsid)] * [http://trac.osgeo.org/mapguide/ticket/1501 taskframe.php fails to load absolute initial task urls] * [http://trac.osgeo.org/mapguide/ticket/1510 Home button does not make correct url if initial task pane url has parameters] * [http://trac.osgeo.org/mapguide/ticket/1227 Return to home page task button fails in MGOS 2.1] * [http://trac.osgeo.org/mapguide/ticket/1583 Tile service doesn't work with JPG] * [http://trac.osgeo.org/mapguide/ticket/1584 Feature source create or update locks up server while under load] * [http://trac.osgeo.org/mapguide/ticket/1535 Mapguide 2.2RC Linux It is not possible to obtain full version number (included build number)] === Fusion === * [http://trac.osgeo.org/fusion/ticket/408 IE9-beta createElement fix] * [http://trac.osgeo.org/fusion/ticket/368 Measure: double click can't always end segment drawing in IE7] * [http://trac.osgeo.org/fusion/ticket/411 update templates to use Google v3 API] * [http://trac.osgeo.org/fusion/ticket/414 issues about clicking 'cancel' button in Buffer panel] * [http://trac.osgeo.org/fusion/ticket/415 In latest Chrome/Safari, the icon of Pan is incorrect] * [http://trac.osgeo.org/fusion/ticket/417 Base layer for MapGuide will not be shown if SingleTile is set to be true in application definition] * [http://trac.osgeo.org/fusion/ticket/424 IE9 beta:use addEventListener to monitor "contextmenu" event will lost mouseEvent information] * [http://trac.osgeo.org/fusion/ticket/420 Failed to enter values for the Query/Theme in Fusion in IE9 Beat] * [http://trac.osgeo.org/fusion/ticket/430 "Map Data" panel popup which using Google maps as commercial layers] * [http://trac.osgeo.org/fusion/ticket/429 IE9 Beta:Toolbar ( Main Menu) in TB Web doesn't display] * [http://trac.osgeo.org/fusion/ticket/431 Accented characters in layer legend label cause XML parser error in Legend.php] * [http://trac.osgeo.org/fusion/ticket/433 Map tips are broken in branches/2.2] == Major New Items == * GDAL Raster Provider Support. See [http://trac.osgeo.org/mapguide/wiki/MGOS22GdalProvider MapGuide 2.2 GDAL Raster Provider] Thanks to the ever growing team of developers who are contributing to make the !MapGuide Open Source project a more self-sustaining project. Please [wiki:SubmitTicket report any defects]. == Compatibility == Click [wiki:2.2MigrationInstructions here] for instructions on how to migrate to MGOS 2.2 from older releases. MGOS 2.2.0 is compatible with [http://fdo.osgeo.org/content/fdo-350-downloads FDO 3.5.0]. == FDO == FDO 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. FDO 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. == Installer notes == The installer has been updated to allow for greater customisation of the initial configuration: * User-defined server/web port numbers * User-defined virtual directory name for both Apache and IIS * User-defined Apache port number * The choice of which web site to install the web extensions under (IIS 6.0) Currently the installer is still only 32-bit. == API changes ==#ApiChanges [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 boolean element was added to !WebLayout. Since these are new APIs, there is no impact on existing code. [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. [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. [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. [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]] [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. [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. [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. [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. [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. [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]] [wiki:MapGuideRfc89 RFC 89] introduced a number of changes required by the upgrade to PHP 5.3. '''These changes break existing code.''' {{{ MgException class changes: Change GetMessage() to GetExceptionMessage() MgResources class changes: Change GetMessage() to GetResourceMessage() MgCoodinateSystem class changes: Change GetCode() to GetCsCode() Change SetCode() to SetCsCode() for consistency. Change IsLegalCode() to IsLegalCsCode() for consistency. MgCoodinateSystemDatum class changes: Change GetCode() to GetDtCode() Change SetCode() to SetDtCode() for consistency. Change IsLegalCode() to IsLegalDtCode() for consistency. MgCoodinateSystemEllipsoid class changes: Change GetCode() to GetElCode() Change SetCode() to SetElCode() for consistency. Change IsLegalCode() to IsLegalElCode() for consistency. MgWebInvokeScriptCommand class changes: Change GetCode() to GetScriptCode() Change SetCode() to SetScriptCode() for consistency. }}} The RFC 87 API changes will impact: * Viewers * Sample applications * Development guides * Existing applications == New Server Configuration (serverconfig.ini) Options == == New Web Configuration (webconfig.ini) Options == == Disk Space == The installer requires at least 1.5GB of disk space on C: during installation. Otherwise installation may not proceed. If 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. == Submissions == The complete list of submissions can be found [http://trac.osgeo.org/mapguide/timeline?from=05%2F3%2F10&daysback=348&changeset=on&update=Update here].