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


Ignore:
Timestamp:
Oct 7, 2010, 3:56:06 PM (14 years ago)
Author:
trevorwekel
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Release/2.2RC1/Notes

    v1 v1  
     1= !MapGuide 2.2 Release Candidate 1 Release Notes =
     2
     3MapGuide Open Source 2.2 Release Candidate 1 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 installer:
     14 * [http://download.osgeo.org/mapguide/releases/2.2.0/Beta/MapGuideOpenSource-2.2.0.4829-Beta1.exe MapGuideOpenSource-2.2.0.4829-Beta1.exe]
     15  * size:121,507,944 bytes
     16  * md5sum:e5cd40d189a973c458684954e3ce4dda
     17CentOS 5.4 / !RedHat 5.4 binary tarballs for FDO and !MapGuide:
     18 * [http://download.osgeo.org/mapguide/releases/2.2.0/Beta/fdosdk-centos5-3.5.0.5460.tgz fdosdk-centos5-3.5.0.5460.tgz]
     19  * size:18,716,728 bytes
     20  * md5sum:b03db4f5537ca94dde81f1e6bd60c020
     21 * [http://download.osgeo.org/mapguide/releases/2.2.0/Beta/mapguideopensource-2.2.0.4898-centos5.tgz mapguideopensource-2.2.0.4898-centos5.tgz]
     22  * size:184,023,877 bytes
     23  * md5sum:360639df724735866870269324a3f43b
     24Ubuntu 9.10 install and uninstall scripts:
     25 * 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.
     26 * [http://download.osgeo.org/mapguide/releases/2.2.0/Beta/mginstallubuntu.sh mginstallubuntu.sh]
     27  * size:1860 bytes
     28  * md5sum:e97b958f9eae06d4b3ddc65da461b798
     29 * [http://download.osgeo.org/mapguide/releases/2.2.0/Beta/mguninstallubuntu.sh mguninstallubuntu.sh]
     30  * size:294 bytes
     31  * md5sum:7a5a7a22c707ec867e865648fc4261fa
     32
     33
     34 
     35
     36
     37
     38== Major New Items ==
     39
     40 * TBD
     41
     42Thanks to the ever growing team of developers who are contributing to make the !MapGuide Open Source project a more self-sustaining project. 
     43
     44Please [wiki:SubmitTicket report any defects].
     45
     46== Compatibility ==
     47Click [wiki:2.2MigrationInstructions here] for instructions on how to migrate to MGOS 2.2 from older releases.
     48
     49MGOS 2.2.0 is compatible with [http://fdo.osgeo.org/content/fdo-350-downloads FDO 3.5.0].
     50
     51== FDO ==
     52
     53FDO 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.
     54
     55FDO 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.
     56
     57== Installer notes ==
     58
     59The installer has been updated to allow for greater customisation of the initial configuration:
     60
     61 * User-defined server/web port numbers
     62 * User-defined virtual directory name for both Apache and IIS
     63 * User-defined Apache port number
     64 * The choice of which web site to install the web extensions under (IIS 6.0)
     65
     66The installer (post beta 1) also no longer requires a mandatory reboot for versions of Windows greater than XP.
     67
     68Currently the installer is still only 32-bit.
     69
     70== API changes ==#ApiChanges
     71[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.
     72
     73[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. 
     74
     75
     76[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.
     77
     78[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.
     79
     80[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]]
     81
     82[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.
     83
     84[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.
     85
     86[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.
     87
     88[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.
     89
     90[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.
     91
     92[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]]
     93 
     94[wiki:MapGuideRfc89 RFC 89] introduced a number of changes required by the upgrade to PHP 5.3.  '''These changes break existing code.'''
     95{{{
     96MgException class changes:
     97Change GetMessage() to GetExceptionMessage()
     98
     99MgResources class changes:
     100Change GetMessage() to GetResourceMessage()
     101
     102MgCoodinateSystem class changes:
     103Change GetCode() to GetCsCode()
     104Change SetCode() to SetCsCode() for consistency.
     105Change IsLegalCode() to IsLegalCsCode() for consistency.
     106
     107MgCoodinateSystemDatum class changes:
     108Change GetCode() to GetDtCode()
     109Change SetCode() to SetDtCode() for consistency.
     110Change IsLegalCode() to IsLegalDtCode() for consistency.
     111
     112MgCoodinateSystemEllipsoid class changes:
     113Change GetCode() to GetElCode()
     114Change SetCode() to SetElCode() for consistency.
     115Change IsLegalCode() to IsLegalElCode() for consistency.
     116
     117MgWebInvokeScriptCommand class changes:
     118Change GetCode() to GetScriptCode()
     119Change SetCode() to SetScriptCode() for consistency.
     120}}}
     121
     122The RFC 87 API changes will impact:
     123 * Viewers
     124 * Sample applications
     125 * Development guides
     126 * Existing applications
     127
     128
     129== New Server Configuration (serverconfig.ini) Options ==
     130
     131== New Web Configuration (webconfig.ini) Options ==
     132
     133== Disk Space ==
     134
     135The installer requires at least 1.5GB of disk space on C: during installation. Otherwise installation may not proceed.
     136
     137If 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.
     138
     139== Submissions ==
     140
     141The complete list of submissions can be found [http://trac.osgeo.org/mapguide/timeline?from=05%2F3%2F10&daysback=348&changeset=on&update=Update here].