[[PageOutline(1-2)]]

= Version History & Preconfectioned Download =

This page lists rasdaman versions, together with the change history.
Starting with version 8.2 we provide summaries of the main changes done with each roll-out.

Alternative ways of obtaining rasdaman are listed in the [wiki:Download] area.

== Version 9.0.x ==
 * For download and installation check the ([wiki:RasdamanQuickInstall debian]) [wiki:Install installation] and [wiki:RasdamanReleaseProcess release process] guides.

=== Changes and new features ===
 * '''`rasdaman`''' Array DMBS
   * tile ids are now stored as ''long int'' in the database rather than ''double''.
     * '''note:''' this is a backwards incompatible change over `rasdaman 8.x`, i.e. once `update_db.sh` is run, the database (RASBASE) will be converted to the new format and will be only readable by `rasdaman 9+`
   * new `'select version()'` query in RasQL, to return the currently installed version of rasdaman
   * enhanced logging: catch segfaults in the `rasdaman` server and print stacktraces in the log (only works if `--without-debug-symbols` has not been specified at `./configure`)
   * fine-grained locking of tiles in `rasdaman`, allowing parallel ingestion for example[[BR]][[BR]]
 * '''''Petascope''''' Web servlet
   * the `petascopedb` [PetascopeDevGuide metadata database schema] has been completely redesigned to work in cooperation with [wiki:SecoreUserGuide SECORE] and to better follow the GMLCOV model, extending support for CRS-aligned [wiki:PetascopeUserGuide#Offsetvectorsandcoefficients irregularly gridded coverages].
     * '''note:''' ''Petascope'' 9.0 is incompatible with the old `petascopedb` schema, and requires upgrade (`'update_petascopedb.sh'`)
     * the [wiki:PetascopeUserGuide#Updatingthedatabaseschema upgrade] supports both migration of existing coverages and restore of pre-upgrade db snapshot
     * some first [wiki:PetascopeUserGuide#SQLmacros stored procedures] are available for devs and advanced users
   * servlet path has been changed to `rasdaman/ows/wcps`, `rasdaman/ows/wcs`, etc., and the `war` file deployed in Tomcat is now ''rasdaman.war''
   * Full OGC WCS 2.0 Core compliance for coverages with rectified/referenceable grid and multipoint geometries. 
   * [browser:systemtest/testcases_services/test_wcs/queries/ WC*S subsets] now support asterisks `*` and [http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateOptionalTimeParser() ISO8601 timestamps].
   * support for Index CRSs for unreferenced nD datasets 
   * support for compound CRS index, spatial, [PetascopeTimeHandling temporal], or spatio-temporal, with 1+ temporal axes
   * support for CRS slicing (interim `@<axis_left1>,__,<axis_leftN>` notation).
   * WCS service and service provider metadata is moved from Java templates to the database.
   * GML/GMLCOV coverage metadata is richer and more flexible: many GML fields are configurable in the database.
     * fixes in GML encoding for coverages (especially CRS and grid axis orders)
     * minimum bounding box is returned
     * configurable OWS metadata enablement
     * configurable SWE metadata (NIL values, allowed intervals, label, description, definition URI)
     * handling of coverage points' sample spaces (point is area on regular axes, point is point on irregular axes)
     * CRS coordinates to follow the [wiki:PetascopeUserGuide#GridaxislabelsandCRSaxislabels axis order] defined in its definition
     * fix domainSet/rangeSet point order agreement
   * safe decoupling of WC*S coverages and `rasdaman` collections: one coverage is represented by a single marray
   * initial support for [MultiPointCoverages multipoint coverages] (to enable this feature PostGIS 2.0+ is required, otherwise it will be disabled.
   * fix WCS scaling, range subsetting and processing extensions.[[BR]][[BR]]
 * '''''rasgeo''''' component
   * revised rasimport/raserase working with the new 9.0 `petascopedb` schema (thanks to Alex Herzig) and supporting irregular series of images (see also the [RasgeoUserGuide user guide])[[BR]][[BR]]
 * '''SECORE''' resolver
   * [SecoreUserGuide SECORE] only supports URLs now, URN support is removed as OGC URNs have been deprecated for a long time already.
     * '''note:''' this is an incompatible change, so an existing SECORE database must be removed (rm -rf $CATALINA_HOME/webapps/secoredb/*), so that a new database containing only URL identifiers can be initialized.
     * two separate dictionaries of definitions: the EPSG and a user-defined one, now containing a first set of Index and Temporal CRS definitions.[[BR]][[BR]]
 * ''miscellanea''
   * more powerful systemtests, with oracles support, known failures skip and scripting.


==== ''Quick upgrade guide (for rasdaman 8.x)''
1. `$ rm -rf $CATALINA_HOME/webapps/secoredb`
1. `$ autoreconf -fi && ./configure [...] && make clean && make && make install`
1. edit and update ''Petascope'' (`$RMANHOME/etc/petascope.properties`) and ''rasgeo'' (`$HOME/.rasdaman/rasconnect`) configuration files (note that rasconnect has two new parameters, see the [wiki:Install#rasgeo example configuration])
1. `$ update_db.sh`
1. `$ update_petascopedb.sh`

'''NOTE for PostgreSQL < 9.1 users''' : migration of existing coverages in `petascopedb` assumes backslashes are treated literally in string literals. While this is the default behavior in versions >= 9.1 of PostgreSQL, this must be manually set in prior versions (see #675). Hence, before executing `update_petascopedb.sh` you should run:

{{{
petascopedb=# ALTER ROLE petauser SET standard_conforming_strings = on;
}}}

(The problem has been addressed already in the development branch and will be available in rasdaman v9.0.1)

=== Fixes ===
[[TicketQuery(status=closed,milestone=9.0-beta1,order=id)]]
[[TicketQuery(status=closed,milestone=9.0,order=id)]]

=== Patch Version 9.0.1 ===
List generated with:
{{{
$ git log --pretty=format:"* changeset:%h | %s (%an)" v9.0.0..v9.0.1 | sort -k 3 -t ':'
}}}
* changeset:e806a26 | ticket:15 - fix test (Dimitar Misev)
* changeset:e8c027d | ticket:169 - add comments to rasgeo's config file (Dimitar Misev)
* changeset:db096ba | ticket:242 - OIDs are returned from INSERTs. (Heinrich Stamerjohanns)
* changeset:d5eca14 | ticket:281 - 0D coverage for referenceable grids too. (Piero Campalani)
* changeset:56fcac8 | ticket:292 - 1)added tests for decode function; 2)removed gdal parameters from decode; 3) reverted encode function to initial state (George Merticariu)
* changeset:49a003b | ticket:292 - added decode functionality (George Merticariu)
* changeset:663dab7 | ticket:292 - fixed tests (George Merticariu)
* changeset:8852d1d | ticket:292 - follow up- fixed tests (George Merticariu)
* changeset:f926d12 | ticket:325 - handle segfaults in rasimport and raserase (Dimitar Misev)
* changeset:b67033b | ticket:412 - Check bison or byacc for presence (Veranika Liaukevich)
* changeset:09dd2a9 | ticket:507 - Remove wildcard from regular file test in update_petascopedb.sh. (Piero Campalani)
* changeset:0ff494f | ticket:542 - Function calls in complex constructor (Veranika Liaukevich)
* changeset:8b717f0 | ticket:543 - Condensing over complex numbers (Veranika Liaukevich)
* changeset:6434f7d | ticket:543 - Fix types comparison (Veranika Liaukevich)
* changeset:2d86fb9 | ticket:567 - Drop spurious SchemaSpy files for old ps9_ tables. (Piero Campalani)
* changeset:40cd00d | ticket:571 - Create a Bbox object for multipoint coverages (Alireza RM)
* changeset:889bdc0 | ticket:579 - Update license headers for Java source files and add utility for automatic (re)update. (Piero Campalani)
* changeset:30850fc | ticket:621 - lockmgr: Adapts the documentation of the whole code after removing clientId. (Kinga Lipskoch)
* changeset:596ceb0 | ticket:621 - lockmgr: Removes attribute clientId from table, code, and queries. (Kinga Lipskoch)
* changeset:7487a46 | ticket:621 - lockmgr: Removes "IF EXISTS" from update4.sql and sets the updatenumber to 5. (Kinga Lipskoch)
* changeset:9c3fa78 | ticket:630 - properly set rw lock when lockmgr is disabled (Dimitar Misev)
* changeset:5cb4af1 | ticket:671 - Check flex for presence (Veranika Liaukevich)
* changeset:648d171 | ticket:672 - Fix WMS path in WMS import tools. (Piero Campalani)
* changeset:8f46ab0 | ticket:673 - CSV conversion for complex numbers (Veranika Liaukevich)
* changeset:e910167 | ticket:673 - Fix broken tests of CSV conversion (Veranika Liaukevich)
* changeset:e3c9915 | ticket:673 - Test for complex number CSV conversion (Veranika Liaukevich)
* changeset:3f5338b | ticket:674 - Fix literal concatenation when constructing query for gmlcov metadata migration. (Piero Campalani)
* changeset:4816e4b | ticket:675 - Explicitly set PostgreSQL standard_conforming_strings variable before updating petascopedb. (Piero Campalani)
* changeset:514eab4 | ticket:676 - Fix root document reference for UoM parsing. (Piero Campalani)
* changeset:0da1d6f | ticket:677 - Remove supported authorities from CRS URI validity check. (Piero Campalani)
* changeset:d529f93 | ticket:681 - Fetching coefficients on irregular untrimmed axis. (Piero Campalani)
* changeset:53768e7 | ticket:682 - Fix minimal bounding box on irregular axes. (Piero Campalani)
* changeset:bdd8887 | ticket:684 - add test (Dimitar Misev)
* changeset:ae69314 | ticket:685 - fix petascope.properties initialization in RPM installations (Dimitar Misev)
* changeset:2aaa6d7 | ticket:686 - Drop duplicate (wrong) check on index min-max consistency and add test. (Piero Campalani)
* changeset:dd33a59 | ticket:687 - Fix timestamp to numeric time coordinate conversion on vectors with norm different from 1 and add new irr_cube_2 test dataset. (Piero Campalani)
* changeset:45e47d6 | ticket:688 - Declare proper tuple and coordinate separators in coverage range values. (Piero Campalani)
* changeset:7147230 | ticket:693 - C++ examples fail to compile (fix on master) (fxavier)
* changeset:8896f99 | ticket:695 - PostGIS version can also be quoted in some distributions. (Piero Campalani)
* changeset:7a689ff | ticket:696 - fix WCS multipoint oracles (Dimitar Misev)
* changeset:c9a7ac2 | ticket:696 - WCPS multipoint tests are randomly failing (Alireza RM)
* changeset:57cedf5 | ticket:698 - Synchronize Petascope demo insertion and add feedback. (Piero Campalani)
* changeset:ce6a813 | ticket:699 - Interrupt signal handlers while updating petascopedb. (Piero Campalani)
* changeset:fb8da58 | ticket:700 - Row-major values order in CSV conversion (Veranika Liaukevich)
* changeset:2d36820 | ticket:700 - updated 12.2 (Peter BaumanN)
* changeset:70106dc | ticket:703 - Typo in create_db.sh.in (Piero Campalani)


== Version 8.5.x ==
=== Fixes ===
[[TicketQuery(status=closed,milestone=8.5,order=id)]]
[[TicketQuery(status=closed,milestone=8.5.1,order=id)]]
[[TicketQuery(status=closed,milestone=8.5.3,order=id)]]

=== Patch Version 8.5.3 ===
List generated with:
{{{
$ git log --pretty=format:"* changeset:%h | %s (%an)" v8.5.2..v8.5.3 | sort -k 3 -t ':'
}}}
* changeset:522364c | ticket:417 - fix tile cache leak in v8.5 (Dimitar Misev)
* changeset:9b9f2c4 | ticket:417 - more robust blob reading (Dimitar Misev)
* changeset:5956682 | ticket:605 - Fix cell bounds of mr and rgb. (Piero Campalani)
* changeset:4d5c934 | ticket:609 - Fix datatypes for mr and rgb test coverages. (Piero Campalani)
* changeset:6da4b85 | ticket:618 - fix data ingestion uses more memory than necessary (Dimitar Misev)
* changeset:a71d381 | ticket:618 - fix insertppm segfault (Dimitar Misev)
* changeset:3de6c1d | ticket:618 - fix segfault in clientcomm 8.5 (Dimitar Misev)
* changeset:3868a0f | ticket:618 - fix segfault in rasimport (Dimitar Misev)


== Version 8.4.x ==
 * Source tarball download link: [attachment:rasdaman-v8.4.0.tgz rasdaman-v8.4.0.tgz] 
 * From git repository (we have a new [wiki:RasdamanReleaseProcess release procedure] under definition)
 * Interface and features [wiki:Features?version=52 table]
 * fixes and enhancements: [milestone:8.4 tickets closed]

=== Fixes ===
[[TicketQuery(status=closed,milestone=8.4,order=id)]]
[[TicketQuery(status=closed,milestone=8.4.1,order=id)]]
[[TicketQuery(status=closed,milestone=8.4.2,order=id)]]
[[TicketQuery(status=closed,milestone=8.4.3,order=id)]]

=== Known Issues ===

[[TicketQuery(status=!closed,type=defect,priority=blocker|critical|major,version=8.4,order=id)]]


== Version 8.3.0 ==

Download link: [http://www.rasdaman.com/Download/rasdaman-8.3.0.tar.gz rasdaman 8.3.0]

=== Known Issues ===

 * the ''make'' process breaks if no ''--war-dir'' option is specified in the ''./configure'' step.


=== Server ===
 * compilation on OS X
 * rasgeo tool for GDAL-based image file import added to applications
 * rasdaman web client toolkit (raswct) has been added to applications
  * accompanying developer's manual can be found in manuals_and_examples/manuals
 * fixed returning wrong error code on exception in rasgeo
 * CSV formatter properly prints point queries
 * fix exporting data of base type uint8, int8, uint32, float, etc. to TIFF
 * added support for multiband TIFF images
 * synchronized RPM spec file
 * specific netcdf variable can be imported/exported, e.g. netcdf($1, "var=Base_reflectivity")
 * fix the default definition of the RPC server in rasmgr.conf
 * added --with-docs option to the configure script, to control whether doxygen documentation should be generated during installation.
 * added option for generating position independent code (PIC), usually necessary on 64bit systems for generating proper shared objects.
 * fix rasdl segfaulting when executed with invalid parametars
 * fix rasdl segfaulting when types with a specified extent are present in the database
 * fix type checking when updating with a file in some specific format. At the type-checking stage the actual type is not yet known as the conversion hasn't been evaluated.
 * fix rasmgr segfaulting on Debian Wheezy 64bit, gcc 4.6
 * fix make clean for java
 * add rview binary and modify Makefiles so that it's properly installed on make install
 * add includes for mkdir in rasmgr_config.cc

=== Petascope ===
 * moved to the applications directory
 * integration with the 52n WPS server
 * deploying via 'make deploy' instead of 'make install'
 * cleanup WCPS logging and fix performance bug
 * performance speedup by caching in WCPS
 * fix req 11, request version was not matched well.
 * the server should not fail if it fails reading some of the coverages
 * fix parsing of CRS in WCS 2.0
 * fix failed post req2 by including an ows:Constraint under OperationsMetadata in the Capabilities response
 * fix failed core req8 (URLs in OperationMetadata were same for different servlet locations), and failed core req12 (invalid KVP request didn't result with exception).
 * fix req17 by adding XML schema validation of XML requests.
 * perform initialization at servlet startup instead of at the first request.
 * fix installation of petascope settings
 * remove the version attribute of the ServiceMetadata element
 * update CRS identifiers to URLs

=== Fixes ===
 * #60 importing and outputting multi-band tiff files via rasql
 * #67 fix compilation of the png converter with libpng14 or greater
 * #70 fix GetCoverage ill-formed XML response
 * #71 fix petascope DB initialization
 * #72 add proper rview/labels.txt
 * #74 problem exporting float32 data
 * #75 fix csv conversion for structs
 * #83 clear cache in petascope at every request
 * #84 fix subset parameters in WCS 2.0 GET-KVP
 * #86 CSV converter fails if result is 0 dimensioned
 * #87 internal error: The index found more cells than allowed
 * #91 fix handling of WCS 1.1 in petascope
 * #92 fix the SOAP protocol extension in petascope
 * #93 fix struct component selection via an index
 * #99 fix pixel shift in rasgeo


== Version 8.2.1 ==

Download link: [http://www.rasdaman.com/Download/rasdaman-8.2.1.tar.gz rasdaman 8.2.1]

=== Fixes ===
   * fixed PostgreSQL connection leak
   * eliminated compiler warnings
   * fix: use hostname for system identifier in rasmgr.conf instead of base DBMS name
   * fixed multidimentional csv export and other csv bugs
   * fixed some buffer oflo situations
   * fixed code examples
   * fix 64bit compilation errors
   * many general bug fixes (see patch logs for details)
   * proper installation of C++ example Makefile and documentation
   * improved usage of predefined installation directory structure

=== Enhancements ===
   * beta support for IQL (Integrated Query Language)
   * extended sdom operation to also work on any general expressions. Needed to support GDAL driver.
   * add NetCDF support
   * optional compilation of NetCDF and HDF4
   * enable csv conversion of structured types
   * improve out-of-the-box use of petascope
   * added petascope support for WCS 2.0
   * automatice system test, Makefile target "check"
   * added doxygen to make process
   * improved installation information, removed some redundancy
   * improved PDF documentation

=== Changes ===
   * in induced operations, changed division of integer numbers to produce double result instead of integer
   * added storage layout language
   * merged petascope into rasdaman source tree
   * rasmgr logs to rasmgr.<pid>.log instead nohup.out
   * fixed log output: rasserver logs into only one logfile now, does not write into rasmgr log any more
   * make server log less verbose: Eliminate "server available" sign of life message.
   * renamed rasmgr_auth to rasmgr.auth for homogenization of system files