blob: 8e44f16f3232a4c871a5d0ae9635828a70a8ac58 [file] [log] [blame]
Release Notes -- Apache Jackrabbit -- Version 1.3.4
Introduction
------------
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. Typical applications that use content repositories include content
management, document management, and records management systems.
Apache Jackrabbit 1.3.4 is a patch release from the 1.3 maintenance branch.
This release is targeted to users who are not yet ready to upgrade to
the more recent Jackrabbit 1.4 release, but who still need some of the
more important recent fixes and improvements. See below for the full
list of changes since the 1.3.3 release.
See the Apache Jackrabbit website at http://jackrabbit.apache.org/ for more
information.
Changes in this release
-----------------------
New features
[JCR-954] - Allow to disable referential integrity checking for workspace
[JCR-1112] - CacheManager interval between recalculation of cache sizes ...
[JCR-1428] - Add API for selective bundle consistency check ...
Improvements
[JCR-948] - Support for JNDI configuration of BundleDbPersistenceManager
[JCR-1116] - Database persistence managers: log database and driver ...
[JCR-1209] - NodeImpl.checkout() calls save() two times
[JCR-1400] - Backport JCR-940: add db connection autoConnect for ...
[JCR-1421] - Backport JCR-1111: Accesss to version history results ...
Bug fixes
[JCR-1185] - building trunk fails with javacc plugin version 2.2
[JCR-1227] - Restore of empty multivalue property always changes ...
[JCR-1271] - NullPointerException when iterating over properties
[JCR-1305] - JNDI data sources with BundleDbPersistenceManager: ...
[JCR-1399] - Backport JCR-1197: Node.restore() may throw ...
[JCR-1461] - Deadlock on concurrent commit/checkin operations
[JCR-1480] - Deadlock when executing Version operations
Release Contents
----------------
The release consists of a single source archive and a number of
pre-compiled binary component archives.
* Jackrabbit source code (jackrabbit-1.3.4-src.jar)
The main source archive contains a "jackrabbit-1.3.4-src" directory
with the full released source code and build environment. Use the
following commands (or the equivalent in your system) to build all
the released components with Maven 2:
$ jar xf jackrabbit-1.3.4-src.jar
$ cd jackrabbit-1.3.4-src
$ mvn install
The components contained in the released source archive are listed below
(with the pre-compiled binary archives in parenthesis):
* Jackrabbit API (jackrabbit-api-1.3.4.jar)
Interface extensions that Apache Jackrabbit supports in
addition to the standard JCR API.
* Jackrabbit JCR Commons (jackrabbit-jcr-commons-1.3.4.jar)
General-purpose classes for use with the JCR API.
* Jackrabbit JCR Tests (jackrabbit-jcr-tests-1.3.4.jar)
Set of JCR API test cases designed for testing the compliance
of an implementation. Note that this is not the official JCR TCK!
* Jackrabbit Core (jackrabbit-core-1.3.4.jar)
Core of the Apache Jackrabbit content repository implementation.
* Jackrabbit Text Extractors (jackrabbit-text-extractors-1.3.4.jar)
Full text extraction for for Jackrabbit. Includes support for
example for Adobe PDF and MS Excel, PowerPoint and word files.
* Jackrabbit JCR-RMI (jackrabbit-jcr-rmi-1.3.4.jar)
RMI network layer for the JCR API.
* Jackrabbit WebDAV Library (jackrabbit-webdav-1.3.4.jar)
Interfaces and common utility classes used for building a
WebDAV server or client.
* Jackrabbit JCR Server (jackrabbit-jcr-server-1.3.4.jar)
WebDAV servlet implementations based on JCR.
* Jackrabbit Repository Classloader (jackrabbit-classloader-1.3.4.jar)
Java classloader for loading classes from JCR content repositories.
* Jackrabbit Web Application (jackrabbit-webapp-1.3.4.war)
Deployable Jackrabbit installation with WebDAV support for JCR.
* Jackrabbit JCA Resource Adapter (jackrabbit-jca-1.3.4.rar)
J2EE Connector Architecture (JCA) resource adapter for Jackrabbit.
All files contain a README.txt file with more information. Note that
external runtime dependencies are only included for the war and rar
archives. Other dependencies can be downloaded either manually or
automatically using the Maven build system.
Each release file is accompanied by SHA1 and MD5 checksums and a PGP
signature. The public key used for the signatures can be found
in the KEYS file located in the parent directory.
Upgrading to Jackrabbit 1.3
---------------------------
Apache Jackrabbit 1.3 is fully compatible with the previous 1.x releases.
A previous Apache Jackrabbit 1.x installation can be upgraded by replacing
the relevant jar files with the new versions. No changes to repository
contents are needed.
This release replaces the previous jackrabbit-index-filters component with
an improved jackrabbit-text-extractors component. An existing Jackrabbit
installation can be upgraded to use the new text extraction components by
deploying the new jackrabbit-text-extractors jar file and updating the
relevant search index configuration. Jackrabbit still supports old index
filter configurations, but to use them you need to leave the old
jackrabbit-index-filters jar file in place.
See below for a more detailed description of the structural changes in
the Apache Jackrabbit 1.2 release.
Upgrading to Jackrabbit 1.2
---------------------------
The most notable effect of the component restructuring in the 1.2 release
was that the previous jackrabbit-core component has been split in three
pieces: jackrabbit-api, jackrabbit-jcr-commons, and jackrabbit-core. Thus
you need to replace the previous jackrabbit-core-1.x.jar file with the
three new jar archives.
The structure of the WebDAV components have also changed. WebDAV support
now consists of the webapp component jackrabbit-webapp and the libraries
jackrabbit-webdav and jackrabbit-jcr-server.
The Apache Lucene dependency used for full text indexing has been upgraded
to version 2.0 in this release. Lucene 2.0 is able to continue using
existing index files, but you can also manually recreate the index with
Lucene 2.0 extensions by removing the "index" directories of a closed
repository. Jackrabbit will automatically re-index content when the
repository is next started.
Also the Apache Derby dependency has been upgraded to version 10.2.
Like Lucene, the new Derby version can keep using existing database files.
New repositories and workspaces will however be created using extensions
and improvements introduced in the 10.2 version.