Release Notes -- Apache Jackrabbit -- Version 2.2.13

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

This is Apache Jackrabbit(TM) 2.2, a fully compliant implementation of the
Content Repository for Java(TM) Technology API, version 2.0 (JCR 2.0) as
specified in the Java Specification Request 283 (JSR 283).

Apache Jackrabbit 2.2.13 is patch release that contains fixes and
improvements over previous 2.2.x releases. This release is backwards
compatible with all earlier 2.x releases.

Changes in this release
-----------------------

Improvements

  [JCR-3339] - Log stack trace with warn message in ObservationDispatcher
  [JCR-3369] - Garbage collector improvements
  [JCR-3392] - Combine the XA aware (Reentrant) LockImpls to prevent duplicate code
  [JCR-3393] - InternalVersionManagerBase.calculateCheckinVersionName may fail with NPE on broken versioning persistence
  [JCR-3352] - Minor improvements for collecting ACEs

Bug fixes

  [JCR-3303] - ClusterNode's stopDelay should default to something other zero
  [JCR-3334] - incorrect logging template in CachingEntryCollector
  [JCR-3353] - A DeadLock can occur if an Exception is thrown while unlocking the Journal
  [JCR-3354] - The ReadWriteLock in AbstractJournal can create a Deadlock in XA Environment
  [JCR-3378] - The ConnectionHelper can return a closed Connection in BatchMode
  [JCR-3379] - XA concurrent transactions - NullPointerException
  [JCR-3383] - Unclosed Resources in ConnectionHelper if ResultSet is null
  [JCR-3387] - On heavy load we see occasional SQLException: closed statement: next
  [JCR-3390] - Reordering policy node fails with AccessDeniedException
  [JCR-3399] - Shared ISM does not release the internal Writelock if something unexpectedly is happening in externalUpdate
  [JCR-3425] - XAAwareRWLock implementation fails with IllegalStateException on JBoss AS7
  [JCR-3432] - Backport JCR-3417: Failed Journal lock not propagated
  [JCR-3433] - Backport JCR-3349: The BatchMode of the ConnectionHelper doesn't work in XA Environment
  [JCR-3434] - EventJournal#skipTo() broken

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

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

Node type unregistration problem in 2.2.[0-10]
----------------------------------------------

Earlier 2.2.x releases (< 2.2.11) mistakenly allowed node types to be
unregistered without no checks on whether those types are still referenced
in content. Before Jackrabbit 2.1 the "checkForReferencesInContent" method
used to always throw a "not yet implemented" exception since we haven't yet
implemented that functionality and didn't want people to accidentally break
the consistency of their content by removing types that are still used.
However, before the 2.1 release this exception was accidentally disabled
and thus in Jackrabbit versions 2.1.x and 2.2.x it has so far been possible
to remove node types with no such consistency constraints.

This issue was fixed in Jackrabbit 2.2.11 by re-enabling the exception in
the checkForReferencesInContent method, which will break all client code
that tries to unregister node types. If you need this functionality and
are aware of the potential problems, you can restore the old behaviour
by setting the disableCheckForReferencesInContentException system property
to "true".

Data consistency issue in 2.2.[0-6]
-----------------------------------

Earlier 2.2.x releases (< 2.2.7) had a problem where very large positive
or negative long property values (more than 62 bits) could not be correctly
read from the reepository. The values are still correctly stored in the
reporistory, and can be properly read after upgrading to this release,
but any previous computations or other information derived from such
properties should be checked for correctness.

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.txt 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
https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS.

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

Apache Jackrabbit is a fully conforming implementation of the Content
Repository for Java Technology API (JCR). A content repository is a
hierarchical content store with support for structured and unstructured
content, full text search, versioning, transactions, observation, and
more.

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

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

Established in 1999, The Apache Software Foundation provides organizational,
legal, and financial support for more than 100 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 2,500+ contributors.

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