Release Notes -- Apache Jackrabbit Oak -- Version 1.0.40

Introduction
------------

Jackrabbit Oak is a scalable, high-performance hierarchical content
repository designed for use as the foundation of modern world-class
web sites and other demanding content applications.

Apache Jackrabbit Oak 1.0.40 is a patch release that contains fixes and
improvements over Oak 1.0. Jackrabbit Oak 1.0.x releases are considered
stable and targeted for production use.

The Oak effort is a part of the Apache Jackrabbit project.
Apache Jackrabbit is a project of the Apache Software Foundation.


Changes in Oak 1.0.40
---------------------


Sub-task

    [OAK-5299] - Introduce BlobFactory in OakDirectory

Technical task

    [OAK-6237] - Tomcat JDBC pool's StatementCache interceptor may cache borked PreparedStatements with DB2
    [OAK-6652] - RDB*Store: update postgresql JDBC driver reference to 42.1.4
    [OAK-6660] - RDB*Store: update mysql JDBC driver reference to 5.1.44 (2017-08-30)
    [OAK-6696] - RDB*Store: update Tomcat JDBC pool dependency to 7.0.81
    [OAK-6782] - RDBDocumentStore: inconsistent handling of cache invalidation on remove()
    [OAK-6903] - RDB*Store: update Tomcat JDBC pool dependency to 7.0.82
    [OAK-7068] - RDBBlobStore may wrap SQLExceptions into RuntimeExceptions
    [OAK-7069] - RDBDataSourceWrapper: properly name setTemporaryUpdateException


Bug

    [OAK-4518] - ConcurrentAddReferenceTest fails occasionally
    [OAK-5238] - IndexCopier causes concurrent update on NodeBuilder
    [OAK-5933] - Checkpoints are not sorted correctly in RepositorySidegrade
    [OAK-6011] - Test failure: JdbcToSegmentTest:validateMigration
    [OAK-6057] - incorrect system property check in blob/upgrade tests
    [OAK-6306] - upgrade uses lucene wrong version (transient dependency)
    [OAK-6360] - Failed to retrieve previously indexed checkpoint in composite node store
    [OAK-6454] - Inaccurate data in the oak-upgrade progress logger
    [OAK-6560] - Sidegrade uses too much memory
    [OAK-6611] - [upgrade][oak-blob-cloud] Many S3DataStore errors during migration with oak-upgrade
    [OAK-6633] - Overwriting a versionable node with the copy-versions=false doesn't remove versionable properties
    [OAK-6685] - Background operation may fail when document is malformed
    [OAK-6953] - CacheLIRS cannot be disabled
    [OAK-6970] - IncludeIndexTest failure
    [OAK-7101] - Stale documents in RDBDocumentStore cache


Improvement

    [OAK-2638] - Use message from causing exception in DocumentStoreException.convert()
    [OAK-4863] - Reduce query batch size for deleted documents
    [OAK-5317] - MongoBlobStore creates _id index unnecessarily
    [OAK-6003] - Allow to migrate checkpoints for all type of sidegrades
    [OAK-6131] - No need to rebuild the counter/uuid index anymore
    [OAK-6188] - Allow to exclude nodes containing name fragment during the migration
    [OAK-6190] - Allow to migrate checkpoints even if the custom include paths are specified
    [OAK-6218] - Including id in DocumentStoreException which wrap MongoException
    [OAK-6650] - new release checksum requirements
    [OAK-6878] - Populate S3DataStore fields with the passed properties in oak-upgrade


Task

    [OAK-6655] - Update travis build configuration
    [OAK-6657] - Remove travis webhook configuration
    [OAK-6701] - Update Oak 1.0 to Jackrabbit 2.8.6
    [OAK-6952] - add SHA512 checksums to releases
    [OAK-6971] - Remove composite node store-related features from the oak-upgrade
    [OAK-7076] - Update Oak 1.0 to Jackrabbit 2.8.7


In addition to the above-mentioned changes, this release contains
all changes included in previous Apache Jackrabbit Oak 1.0.x releases.

Please note, the backported RDB support for the DocumentNodeStore is considered
experimental at this point and is not yet ready for production use. Feel free 
to try it out and report any issues you may see to the Oak developers.

For more detailed information about all the changes in this and other
Oak releases, please see the Oak issue tracker at

  https://issues.apache.org/jira/browse/OAK

Release Contents
----------------

This release consists of a single source archive packaged as a zip file.
The archive can be unpacked with the jar tool from your JDK installation.
See the README.md file for instructions on how to build this release.

The source archive is accompanied by SHA1 and MD5 checksums and a PGP
signature that you can use to verify the authenticity of your download.
The public key used for the PGP signature can be found at
http://www.apache.org/dist/jackrabbit/KEYS.

About Apache Jackrabbit Oak
---------------------------

Jackrabbit Oak is a scalable, high-performance hierarchical content
repository designed for use as the foundation of modern world-class
web sites and other demanding content applications.

The Oak effort is a part of the Apache Jackrabbit project. 
Apache Jackrabbit is a project of the Apache Software Foundation.

For more information, visit http://jackrabbit.apache.org/oak

About The Apache Software Foundation
------------------------------------

Established in 1999, The Apache Software Foundation provides organizational,
legal, and financial support for more than 140 freely-available,
collaboratively-developed Open Source projects. The pragmatic Apache License
enables individual and commercial users to easily deploy Apache software;
the Foundation's intellectual property framework limits the legal exposure
of its 3,800+ contributors.

For more information, visit http://www.apache.org/