Release Notes -- Apache Jackrabbit Oak -- Version 1.0.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.0.17 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.

New configuration options since Oak 1.0.17
------------------------------------------

LuceneIndex CopyOnRead feature now supports pre fetching of index files (OAK-3069).
This reduces time taken in opening a new index. It can be enabled via OSGi config
of LuceneIndexProviderService

Debugging merge conflict errors is now possible by enabling DEBUG logs on 
org.apache.jackrabbit.oak.plugins.commit.MergingNodeStateDiff and 
org.apache.jackrabbit.oak.plugins.commit.ConflictValidator via OAK-3057

Changes in Oak 1.0.17
---------------------

Bugs

    [OAK-2401] - SegmentNodeStoreService prone to deadlocks
    [OAK-2845] - Memory leak in ObserverTracker#removedService
    [OAK-2934] - Certain searches cause lucene index to hit OutOfMemoryError
    [OAK-2961] - Async index fails with OakState0001: Unresolved conflicts in /:async
    [OAK-2999] - Index updation fails on updating multivalued property
    [OAK-3020] - Async Update fails after IllegalArgumentException
    [OAK-3023] - Long running MongoDB query may block other threads
    [OAK-3026] - test failures for oak-auth-ldap on Windows
    [OAK-3035] - ReferenceEditor reindex detection broken
    [OAK-3046] - Test extending AbstractRepositoryTest not getting executed on 1.0 branch
    [OAK-3053] - Locking issues seen with CopyOnWrite mode enabled
    [OAK-3062] - VersionGC failing on Mongo with CursorNotFoundException
    [OAK-3067] - Lucene IndexCopier should increase readerRemoteReadCount for new files
    [OAK-3081] - SplitOperations may undo committed changes
    [OAK-3084] - Commit.applyToDocumentStore(Revision) may rollback committed changes
    [OAK-3089] - LIRS cache: zero size cache causes IllegalArgumentException
    [OAK-3013] - SQL2 query with union, limit and offset can return invalid results

Improvements

    [OAK-2766] - Log time to acquire backgroundOperationLock in background operation tasks
    [OAK-2885] - Enable saveDirListing by default
    [OAK-3034] - backport OAK-2373 to 1.0 branch
    [OAK-3043] - Provide item path with InvalidItemStateException
    [OAK-3057] - Simplify debugging conflict related errors
    [OAK-3069] - Provide option to eagerly copy the new index files in CopyOnRead
    [OAK-3076] - Compaction should trace log the current processed path
    [OAK-3088] - IndexUpdate reports at debug level quite verbose

New Features

    [OAK-2721] - LogDumper rule to dump logs as part of system out in case of test failure
    
Tasks

    [OAK-3058] - Backport OAK-2872 to 1.0 and 1.2 branches


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/