Release Notes -- Apache Jackrabbit Oak -- Version 1.2.17

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.2.17 is a patch release that contains fixes and
improvements over Oak 1.2. Jackrabbit Oak 1.2.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.2.17
---------------------

Sub-task
    [OAK-3306] - Create a copy of MemoryDocumentStore


Technical task

    [OAK-4409] - RDB*Store: bump up recommended DB2 version to 10.5
    [OAK-4482] - RDB*Store: update tomcat-jdbc test dependency
    [OAK-4495] - RDBDocumentStore: consistent handling of invalidate methods
    [OAK-4497] - RDBDocumentStore: potential race condition between update and invalidate can cause stale cache entries
    [OAK-4509] - RDBDocumentStore: low-level read method should also support condition on MODIFIED value
    [OAK-4510] - RDBDocumentStore: can't persist _modified value of null


Bug

    [OAK-3079] - LastRevRecoveryAgent can update _lastRev of children but not the root
    [OAK-3305] - Self recovering instance may not see all changes
    [OAK-3903] - Commit fails even though change made it to the DocumentStore
    [OAK-3988] - Offline compaction should avoid loading external binaries
    [OAK-4429] - [oak-blob-cloud] S3Backend#getAllIdentifiers should not store all elements in memory
    [OAK-4430] - DataStoreBlobStore#getAllChunkIds fetches DataRecord when not needed
    [OAK-4493] - Offline compaction persisted mode
    [OAK-4494] - Stale documents after revision GC in cluster
    [OAK-4496] - Enable DataStoreBlobStore#getAllRecords to support non-shared DataStore
    [OAK-4499] - LucenePropertyIndexTest#longRepExcerpt is too aggressive
    [OAK-4501] - Avoid reading segment when reading strings and the string is in the cache
    [OAK-4502] - LucenePropertyIndex doesn't use filter's path for ACL checks of suggest queries


Improvement

    [OAK-3702] - More resilient BackgroundThread implementation
    [OAK-3797] - SegmentTracker#collectBlobReferences should retain fewer SegmentId instances
    [OAK-3904] - Compaction Map predicate should use cached state for evaluation
    [OAK-4368] - Excerpt extraction from the Lucene index should be more selective
    [OAK-4505] - Offline compaction clearer output values
    [OAK-4514] - ResurrectNodeAfterRevisionGCTest's cleanup may interfere with DS disposal
    [OAK-4545] - Configurable maxBackOffMillis


Task

    [OAK-2575] - Improve documentation for DocumentStore.invalidateCache


Test

    [OAK-4489] - Improve test coverage on DocumentStore for concurrent query and invalidate
    [OAK-4546] - Long running DocumentNodeStoreTest


In addition to the above-mentioned changes, this release contains
all changes included up to the Apache Jackrabbit Oak 1.2.16 release.

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/