Release Notes for ModeShape 3.2.0.Final

This document outlines the changes that were made in ModeShape 3.2.0.Final. We hope you enjoy it!

What's new

3.2.0.Final provides a fast, elastic, distributed hierarchical database that clients work with via the standard JCR 2.0 (JSR-283) API. ModeShape 3 is a major upgrade over 2.x and offers significant improvements in performance and scalability, while retaining all of ModeShape 2's JCR-related features. ModeShape 3 has complete integration with JBoss AS 7.1, allowing deployed components to simply lookup and use repositories managed by ModeShape's service.

This release addesses a whopping 119 issues, most of which were bug fixes. Overall, clustering has been dramatically improved, both for embedded and EAP-based deployments. Other high-level changes include using JBoss EAP 6.1 (rather than JBoss AS7.1.1) and upgrades to Infinispan 5.2.5.Final, JGroups 3.2.7.Final, Lucene 3.6, and newer versions of several other third party libraries.

Note for EAP 6.1.0.Alpha1 users: there is a known issue ( where EAP intermittenly has problems upon startup concurrently starting Infinispan cache containers. If this occurs, simply kill the EAP process and restart. This has been fixed in EAP 6.1.0.Beta1.

Also, note that because we switched from AS7 to EAP, the artifact name for BOM for use in applications has been renamed from 'modeshape-bom-jbossas' to 'modeshape-bom-jbosseap'. This is to remain consistent and to help reinforce that ModeShape 3.2 works on EAP 6.1 now and not on JBoss AS7.1.1.


ModeShape 3.2.0.Final has these features:

All of the JCR 2.0 features previously supported in 2.x are currently supported:

Accessing the Repository


Reading Repository Content

Writing Repository Content

Query / Search

Importing/Exporting Repository Content

Node Types

Repository Metadata under System Node

Other JCR Optional Features

Content Storage Options

Binary Storage Options

ModeShape also has features that go beyond the JCR API:

ModeShape Federation Connectors

ModeShape Sequencers

ModeShape Deployment/Access Models

Other ModeShape features

Bug Fixes, Features, and other Issues

The following are the bugs, features and other issues that have been fixed in the 3.2.0.Final release:


Component Upgrade


Feature Request


Component Upgrade