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.