Release Notes -- Apache Jackrabbit Oak -- Version 1.0.22

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.22 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 in Oak 1.0.22
---------------------------------------

This release of Oak includes an improvement to the DocumentNodeStore,
which requires a new collection in the DocumentStore. The DocumentStore
implementations in Oak will try to create the new collection if necessary.
However, there may be deployments where the configured backend storage user
for the DocumentStore implementation does not have the require privilege.
In this case it is required to create the table for the RDB backend or 
collection for MongoDB manually before Oak is upgraded to 1.0.22.
See https://issues.apache.org/jira/browse/OAK-2829 for more details.

Node name index support (OAK-1752) - With this queries involving
node name constraint can make use of index and perform better. Refer to
http://jackrabbit.apache.org/oak/docs/query/lucene.html#index-node-name
for usage details.
 

Changes in Oak 1.0.22
---------------------

Sub-task

    [OAK-3133] - Make compaction map more efficient for offline
    compaction
    [OAK-3359] - Compactor progress log
    [OAK-3443] - Track the start time of mark in GC

Technical task

    [OAK-3394] - RDBDocumentStore startup: log more DDL information
    (incl. index information)
    [OAK-3413] - RDBDocumentStorePerformanceTest leaks
    PreparedStatements
    [OAK-3414] - RDBDocumentStore: improve DB2 diagnostics
    [OAK-3422] - RDBDocumentStore: improve index diagnostics
    [OAK-3438] - RDBDocumentStoreDB: leaking resultset
    [OAK-3445] - RDBDocumentStore: when generating SQL for queries,
    leave out unneeded constraints
    [OAK-3446] - RDBDocumentStore: update PostgresQL and MySQL JDBC
    drivers

Bug

    [OAK-2929] - Parent of unseen children must not be removable
    [OAK-3201] - Use static references in SecurityProviderImpl for
    composite services
    [OAK-3311] - Potential NPE in syncAllExternalUsers() aborts the
    process
    [OAK-3318] - IndexRule not respecting inheritence based on mixins
    [OAK-3367] - Boosting fields not working as expected
    [OAK-3388] - Inconsistent read in cluster with clock differences
    [OAK-3396] - NPE during syncAllExternalUsers in
    LdapIdentityProvider.createUser
    [OAK-3412] - Node name having non space whitspace chars should not
    be allowed
    [OAK-3417] - oak-run OakFixture might set incorrect clusterIDs
    [OAK-3418] - ClusterNodeInfo uses irrelevant network interface IDs
    on Windows
    [OAK-3419] - ClusterNodeInfo.createInstance fails to clean up
    random entries
    [OAK-3420] - DocumentNodeStoreService fails to restart
    DocumentNodeStore
    [OAK-3423] - RandomAuthorizableNodeName should not be part of the
    default configuration of SecurityProviderImpl
    [OAK-3431] - SecurityProviderRegistration should not be part of an
    exported package
    [OAK-3433] - Background update may create journal entry with
    incorrect id
    [OAK-3434] - Revert backwards-incompatible changes to
    SecurityProviderImpl
    [OAK-3453] - Adapt the default configuration of
    SecurityProviderRegistration for older versions of Oak

Improvement

    [OAK-2112] - DocumentNodeStore: Error calculating the machine id
    [OAK-2948] - Expose DefaultSyncHandler
    [OAK-3425] - Improve DocumentNodeStore startup/shutdown
    diagnostics
    [OAK-3435] - LastRevRecoveryAgent/MissingLastRevSeeker
    improvements
    [OAK-3441] - SecurityProviderImpl should not be an OSGi component
    [OAK-3454] - Improve the logging capabilities of offline
    compaction


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/