Release Notes -- Apache Jackrabbit Oak -- Version 1.3.8

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.3.8 is an unstable release cut directly from
Jackrabbit Oak trunk, with a focus on new features and other
improvements. For production use we recommend the latest stable 1.2.x
release.

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.3.8
--------------------

Sub-task

    [OAK-2507] - Truncate journal.log after off line compaction
    [OAK-2879] - Compaction should check for required disk space
    before running
    [OAK-3172] - Unreleased closed sessions can keep a root reference
    from getting collected
    [OAK-3260] - oak-jcr: update test exclusions once JCR-3900 is
    resolved

Technical task

    [OAK-3384] - Revisit PartialCompactionMapTest
    [OAK-3479] - Add generation info to compaction map
    [OAK-3501] - PersistedCompactionMap could release reference to
    records early

Bug

    [OAK-1648] - Creating multiple checkpoint on same head revision
    overwrites previous entries
    [OAK-2635] - TimeSeriesMax's frequent 'drops to 0'
    [OAK-2881] - ConsistencyChecker#checkConsistency can't cope with
    inconsistent journal
    [OAK-2929] - Parent of unseen children must not be removable
    [OAK-3235] - Deadlock when closing a concurrently used FileStore
    [OAK-3371] - Wrong evaluation of NOT clause
    [OAK-3388] - Inconsistent read in cluster with clock differences
    [OAK-3396] - NPE during syncAllExternalUsers in
    LdapIdentityProvider.createUser
    [OAK-3405] - Avoid instanceof check in LastRevRecoveryAgent
    [OAK-3417] - oak-run OakFixture might set incorrect clusterIDs
    [OAK-3456] - MongoBlobGCTest.gcLongRunningBlobCollection() fails
    [OAK-3463] - Communicate Password Change Failure Reason During
    Expiry + Pw History
    [OAK-3473] - CliUtils#handleSigInt uses classes from sun.misc.*
    [OAK-3474] - NodeDocument.getNodeAtRevision can go into property
    history traversal when latest rev on current doc isn't committed
    [OAK-3476] - Memory leak caused by using marker names based on non
    static session id
    [OAK-3481] - CompationMapTest does not close file store
    [OAK-3487] - NodeDocumentTest.getNewestRevisionTooExpensive()
    fails occasionally
    [OAK-3490] - QueryTest.orderBy() fails occasionally
    [OAK-3491] - DocumentDiscoveryLiteServiceTest makes incorrect call
    to MissingLastRevRecovery
    [OAK-3492] - reduce DocumentDiscoveryLiteService hasBacklog WARNs
    [OAK-3493] - Deadlock when closing a concurrently used FileStore
    2.0

Documentation

    [OAK-3452] - Document possible migration options

Improvement

    [OAK-3166] - Apply adjustments for newly exported
    JackrabbitSession#getItemOrNull
    [OAK-3251] - speeding up the build time
    [OAK-3290] - Revision gc blocks repository shutdown
    [OAK-3329] - TarMK cleanup blocks writers
    [OAK-3448] - Update jackrabbit version to 2.11.1
    [OAK-3454] - Improve the logging capabilities of offline
    compaction
    [OAK-3455] - Improve conflict exception message
    [OAK-3460] - Progress logging for RepositorySidegrade
    [OAK-3465] - Move ContinuousRevisionGCTest to benchmark package
    [OAK-3469] - Fix naming in oak-upgrade
    [OAK-3471] - Avoid reflection in DocumentDiscoveryLiteServiceTest
    [OAK-3475] - Confusing SNFE whith oak-run debug
    [OAK-3484] - Oak Explorer: add property type to reference output
    [OAK-3485] - FileStoreIT cleanup after tests
    [OAK-3497] - Remove DocumentNodeStore.diff()
    [OAK-3502] - Improve logging during cleanup

New Feature

    [OAK-3457] - Multivalued restriction to limit effect of ACE to
    items with a given name
    [OAK-3472] - Run mode to identify blob garbage

Task

    [OAK-2623] - Add test for GC of previous docs of a deleted
    document

Wish

    [OAK-3467] - Tests slow after OAK-2171

In addition to the above-mentioned changes, this release contains
all changes included up to the Apache Jackrabbit Oak 1.2.x 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/