You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by ju...@apache.org on 2012/12/31 13:40:13 UTC

svn commit: r1427110 [6/18] - in /jackrabbit/site/trunk/content/JCR: ./ a-simple-ocm-project-with-maven-eclipse.data/ concurrency-control.data/ deployment-models.data/ how-jackrabbit-works.data/ how-to-map-associations-between-objects.data/ index-reade...

Added: jackrabbit/site/trunk/content/JCR/jackrabbit-architecture.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/content/JCR/jackrabbit-architecture.html?rev=1427110&view=auto
==============================================================================
--- jackrabbit/site/trunk/content/JCR/jackrabbit-architecture.html (added)
+++ jackrabbit/site/trunk/content/JCR/jackrabbit-architecture.html Mon Dec 31 12:40:09 2012
@@ -0,0 +1,175 @@
+
+<!-- 
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE- 2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License. 
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Jackrabbit Architecture</TITLE>
+    <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+  <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+  <BODY>
+    <DIV id="page">
+      <DIV id="header">
+        <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+        <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+      </DIV>
+      <DIV id="body">
+        <DIV id="navigation">
+  <UL>
+	<LI>Apache Jackrabbit
+	<UL>
+		<LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+		<LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+		<LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+		<LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+		<LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+	</UL>
+	</LI>
+	<LI>Documentation
+	<UL>
+		<LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+		<LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+		<LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+		<LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+		<LI><A href="jcr-api.html" title="JCR & API">JCR &amp; API</A></LI>
+		<LI><A href="" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+		<LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+		<LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+		<LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+		<LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+	</UL>
+	</LI>
+	<LI>Development
+	<UL>
+		<LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+		<LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+		<LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+		<LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+		<LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+		<LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+		<LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+		<LI><A href="website.html" title="Website">Website</A></LI>
+		<LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+		<LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+	</UL>
+	</LI>
+	<LI>Apache Software Foundation
+	<UL>
+		<LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+		<LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+		<LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+	</UL>
+	</LI>
+</UL>
+        </DIV>
+        <DIV id="content">
+          <H1>Jackrabbit Architecture</H1>
+  <UL>
+	<LI><A href="how-jackrabbit-works.html" title="How Jackrabbit works">How Jackrabbit works</A></LI>
+	<LI><A href="repository-lifecycle.html" title="Repository lifecycle">Repository lifecycle</A></LI>
+	<LI><A href="search-implementation.html" title="Search implementation">Search implementation</A></LI>
+	<LI><A href="index-readers.html" title="Index readers">Index readers</A></LI>
+	<LI><A href="concurrency-control.html" title="Concurrency control">Concurrency control</A></LI>
+</UL>
+
+
+<P>The general architecture of Jackrabbit can be described in three Layers: A Content Application Layer, an API Layer and a Content Repository Implementation Layer.</P>
+
+<P><SPAN class="image-wrap" style=""><IMG src="jackrabbit-architecture.data/overview.png" style="border: 0px solid black"></SPAN></P>
+
+<H2><A name="JackrabbitArchitecture-ContentApplications"></A>Content Applications</H2>
+
+<P>Content Applications interact through the JSR-170 API with the Content Repository Implementation. There are numerous applications that are available for JSR-170 repositories, some of them are very generic (like a WebDAV server) other applications can be very specific and make use of the content repository as a store for the information that is used by the applications. Java Applications can use a JSR-170 content repository as a replacement for anything from property-files, XML-configuration, certain portions of relational database functionality to straight file system or blob-management. Using a content repository allows an application to deal with an arbitrarily large hierarchical space in a scalable manner automatically profiting from the repository services such as versioning, query, transactions or namespaces which make a content repository an ideal data store for many applications.</P>
+
+<P>A &quot;Generic Content Application&quot; (an application that has no particular functional focus but just allows for generic introspection and manipulation of the repository) uses the capabilities of the node types, access control and other facilities to display a user interface or a network protocol to the end user, seemingly independent from the content that is stored in the repository. Examples of such generic applications are &quot;The Content Explorer&quot;, &quot;WebDAV Server&quot; or a &quot;Subversion Server&quot;. (Or generic Portal, CMS or DMS applications).</P>
+
+<P>A &quot;Specialized Content Application&quot; operates under the assumption that there are certain node types that it operates on, and that it is familiar at least partially with the data model exposed by defined node types. Mostly these node types are defined by the application itself and ship with the application. These applications use a content repository as their persistence layer as a natural evolution from the use of an RDBMS or a file system. Examples of &quot;Specialized Content Applications&quot; have a very wide range from a &quot;DVD Collection Management&quot;, to a &quot;Message Board&quot;, to &quot;Workflow and BPM&quot; but also possibly complete next generation &quot;Enterprise Resource Planning Systems&quot;.</P>
+
+<H2><A name="JackrabbitArchitecture-ContentRepositoryAPI"></A>Content Repository API</H2>
+
+<P>The Content Repository API Layer is split into two major sections.</P>
+
+<UL>
+	<LI>The Content Repository API defined by JSR-170</LI>
+	<LI>A number features of a content repository, that have been removed from the JSR-170 specification since they are difficult to implement on existing non-java-based content repositories and administrational Repository tasks that have also been deliberately excluded from JSR-170</LI>
+</UL>
+
+
+<P>There are only very few (mostly administrational) applications which make use of the non-JSR-170 APIs provided by Jackrabbit.</P>
+
+<P>The boxes in the architecture chart do not symbolize package names or class names directly but mostly semantically grouped blocks of functionality.</P>
+
+<H2><A name="JackrabbitArchitecture-ContentRepositoryImplementation"></A>Content Repository Implementation</H2>
+
+<P>The content Repository Implementation portion of the architecture chart reflects the major building blocks of the jackrabbit content repository implementation.</P>
+
+<P>The size of the blocks symbolizes roughly the amount of code and therefore the complexity of the individual functional block. Again the functional blocks do not directly map to package or class names.</P>
+
+<P>There are three scopes in a content repository: A repository scope, a workspace scope and a session scope.</P>
+
+<P>Every function that is operated against a repository can be attributed to at least one of these scopes, some functions can operate on more than one scope.</P>
+
+<UL>
+	<LI>Repository</LI>
+	<LI>Nodetype</LI>
+	<LI>Version</LI>
+	<LI>NamespaceRegistry</LI>
+	<LI>Workspace</LI>
+	<LI>Query</LI>
+	<LI>Observation</LI>
+	<LI>State</LI>
+	<LI>Xml</LI>
+	<LI>Session</LI>
+	<LI>Path</LI>
+	<LI>HierarchyManager</LI>
+	<LI>QName</LI>
+	<LI>ItemImpl, PropertyImpl, NodeImpl</LI>
+	<LI>ItemId, PropertyId, NodeId</LI>
+	<LI>ItemManager</LI>
+</UL>
+
+
+<P>This is not a complete list but includes some of the most important component of the content repository implementation.</P>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 2004-2010 The Apache Software Foundation.
+          - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+          [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75329">edit this page</A>]
+          <BR>
+          Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+          Jackrabbit project logo are trademarks of The Apache Software Foundation.
+        </P>
+      </DIV>
+    </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+  </BODY>
+</HTML>

Added: jackrabbit/site/trunk/content/JCR/jackrabbit-chair-2006-resolution.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/content/JCR/jackrabbit-chair-2006-resolution.html?rev=1427110&view=auto
==============================================================================
--- jackrabbit/site/trunk/content/JCR/jackrabbit-chair-2006-resolution.html (added)
+++ jackrabbit/site/trunk/content/JCR/jackrabbit-chair-2006-resolution.html Mon Dec 31 12:40:09 2012
@@ -0,0 +1,140 @@
+
+<!-- 
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE- 2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License. 
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Jackrabbit Chair 2006 Resolution</TITLE>
+    <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+  <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+  <BODY>
+    <DIV id="page">
+      <DIV id="header">
+        <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+        <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+      </DIV>
+      <DIV id="body">
+        <DIV id="navigation">
+  <UL>
+	<LI>Apache Jackrabbit
+	<UL>
+		<LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+		<LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+		<LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+		<LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+		<LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+	</UL>
+	</LI>
+	<LI>Documentation
+	<UL>
+		<LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+		<LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+		<LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+		<LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+		<LI><A href="jcr-api.html" title="JCR & API">JCR &amp; API</A></LI>
+		<LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+		<LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+		<LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+		<LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+		<LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+	</UL>
+	</LI>
+	<LI>Development
+	<UL>
+		<LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+		<LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+		<LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+		<LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+		<LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+		<LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+		<LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+		<LI><A href="website.html" title="Website">Website</A></LI>
+		<LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+		<LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+	</UL>
+	</LI>
+	<LI>Apache Software Foundation
+	<UL>
+		<LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+		<LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+		<LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+	</UL>
+	</LI>
+</UL>
+        </DIV>
+        <DIV id="content">
+          <H1>Jackrabbit Chair 2006 Resolution</H1>
+  <P><EM>From the <A href="http://www.apache.org/foundation/records/minutes/2006/board_minutes_2006_08_16.txt" class="external-link">minutes</A> of the Apache board meeting on August 16th, 2006:</EM></P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+ 6. Special Orders
+
+    A. Resolution to change the Chair of the Jackrabbit PMC
+
+       WHEREAS, the Board of Directors heretofore appointed Roy
+       T. Fielding to the office of Vice President, Apache Jackrabbit,
+       and
+
+       WHEREAS, the Board of Directors is in receipt of the
+       resignation of Roy T. Fielding from the office of Vice
+       President, Apache Jackrabbit;
+
+       NOW, THEREFORE, BE IT RESOLVED, that Roy T. Fielding is
+       relieved and discharged from the duties and responsibilities of
+       the office of Vice President, Apache Jackrabbit, and
+
+       BE IT FURTHER RESOLVED, that Jukka Zitting be and hereby is
+       appointed to the office of Vice President, Apache Jackrabbit,
+       to serve in accordance with and subject to the direction of the
+       Board of Directors and the Bylaws of the Foundation until
+       death, resignation, retirement, removal or disqualification, or
+       until a successor is appointed.
+
+      Special Order 6A, Change the Chair of the Jackrabbit PMC, was
+      approved by Unanimous Vote.
+</PRE>
+</DIV></DIV>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 2004-2010 The Apache Software Foundation.
+          - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+          [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=79940">edit this page</A>]
+          <BR>
+          Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+          Jackrabbit project logo are trademarks of The Apache Software Foundation.
+        </P>
+      </DIV>
+    </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+  </BODY>
+</HTML>

Added: jackrabbit/site/trunk/content/JCR/jackrabbit-components.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/content/JCR/jackrabbit-components.html?rev=1427110&view=auto
==============================================================================
--- jackrabbit/site/trunk/content/JCR/jackrabbit-components.html (added)
+++ jackrabbit/site/trunk/content/JCR/jackrabbit-components.html Mon Dec 31 12:40:09 2012
@@ -0,0 +1,138 @@
+
+<!-- 
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE- 2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License. 
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Jackrabbit Components</TITLE>
+    <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+  <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+  <BODY>
+    <DIV id="page">
+      <DIV id="header">
+        <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+        <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+      </DIV>
+      <DIV id="body">
+        <DIV id="navigation">
+  <UL>
+	<LI>Apache Jackrabbit
+	<UL>
+		<LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+		<LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+		<LI><A href="articles.html" title="Articles">Articles</A></LI>
+		<LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+		<LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+		<LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+	</UL>
+	</LI>
+	<LI>Documentation
+	<UL>
+		<LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+		<LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+		<LI><A href="" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+		<LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+		<LI><A href="jcr-api.html" title="JCR & API">JCR &amp; API</A></LI>
+		<LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+		<LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+		<LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+		<LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+		<LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+	</UL>
+	</LI>
+	<LI>Development
+	<UL>
+		<LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+		<LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+		<LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+		<LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+		<LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+		<LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+		<LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+		<LI><A href="website.html" title="Website">Website</A></LI>
+		<LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+		<LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+	</UL>
+	</LI>
+	<LI>Apache Software Foundation
+	<UL>
+		<LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+		<LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+		<LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+	</UL>
+	</LI>
+</UL>
+        </DIV>
+        <DIV id="content">
+          <H1>Jackrabbit Components</H1>
+  <P>The Apache Jackrabbit project consists of a number of related components. The main components are:</P>
+
+<UL>
+	<LI><A href="jackrabbit-api.html" title="Jackrabbit API">Jackrabbit API</A></LI>
+	<LI><A href="jackrabbit-jcr-commons.html" title="Jackrabbit JCR Commons">Jackrabbit JCR Commons</A></LI>
+	<LI><A href="jackrabbit-jcr-tests.html" title="Jackrabbit JCR Tests">Jackrabbit JCR Tests</A></LI>
+	<LI><A href="jackrabbit-core.html" title="Jackrabbit Core">Jackrabbit Core</A></LI>
+	<LI><A href="jackrabbit-text-extractors.html" title="Jackrabbit Text Extractors">Jackrabbit Text Extractors</A> (replaced by <A href="http://lucene.apache.org/tika/" class="external-link">Tika</A> in Jackrabbit 2.x)</LI>
+	<LI><A href="jackrabbit-jcr-rmi.html" title="Jackrabbit JCR-RMI">Jackrabbit JCR&#45;RMI</A></LI>
+	<LI><A href="jackrabbit-webdav-library.html" title="Jackrabbit WebDAV Library">Jackrabbit WebDAV Library</A></LI>
+	<LI><A href="jackrabbit-jcr-client.html" title="Jackrabbit JCR Client">Jackrabbit JCR Client</A></LI>
+	<LI><A href="jackrabbit-jcr-to-dav.html" title="Jackrabbit JCR to DAV">Jackrabbit JCR to DAV</A></LI>
+	<LI><A href="jackrabbit-jcr-server.html" title="Jackrabbit JCR Server">Jackrabbit JCR Server</A></LI>
+	<LI><A href="jackrabbit-jcr-servlet.html" title="Jackrabbit JCR Servlet">Jackrabbit JCR Servlet</A></LI>
+	<LI><A href="jackrabbit-web-application.html" title="Jackrabbit Web Application">Jackrabbit Web Application</A></LI>
+	<LI><A href="jackrabbit-jca-resource-adapter.html" title="Jackrabbit JCA Resource Adapter">Jackrabbit JCA Resource Adapter</A></LI>
+	<LI><A href="jackrabbit-spi.html" title="Jackrabbit SPI">Jackrabbit SPI</A></LI>
+	<LI><A href="jackrabbit-spi-commons.html" title="Jackrabbit SPI Commons">Jackrabbit SPI Commons</A></LI>
+	<LI><A href="jackrabbit-jcr-to-spi.html" title="Jackrabbit JCR to SPI">Jackrabbit JCR to SPI</A></LI>
+	<LI><A href="jackrabbit-spi-to-jcr.html" title="Jackrabbit SPI to JCR">Jackrabbit SPI to JCR</A></LI>
+	<LI><A href="jackrabbit-spi-to-dav.html" title="Jackrabbit SPI to DAV">Jackrabbit SPI to DAV</A></LI>
+	<LI><A href="standalone-server.html" title="Standalone Server">Jackrabbit Standalone Server</A></LI>
+	<LI><A href="jackrabbit-ocm.html" title="Jackrabbit OCM">Jackrabbit OCM</A> (<A href="http://jackrabbit.apache.org/commons/" class="external-link">Jackrabbit commons</A> component since Jackrabbit 1.6)</LI>
+	<LI><A href="jackrabbit-ocm-node-management.html" title="Jackrabbit OCM Node Management">Jackrabbit OCM Node Management</A> (<A href="http://jackrabbit.apache.org/commons/" class="external-link">Jackrabbit commons</A> component since Jackrabbit 1.6)</LI>
+</UL>
+
+
+<P>In addition there are a number of contributed components in the <TT>sandbox</TT> folder of the Jackrabbit project. These components are not yet considered stable enough to be included in the official Apache Jackrabbit releases.</P>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 2004-2010 The Apache Software Foundation.
+          - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+          [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=71434">edit this page</A>]
+          <BR>
+          Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+          Jackrabbit project logo are trademarks of The Apache Software Foundation.
+        </P>
+      </DIV>
+    </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+  </BODY>
+</HTML>

Added: jackrabbit/site/trunk/content/JCR/jackrabbit-configuration.data/repository.xml
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/content/JCR/jackrabbit-configuration.data/repository.xml?rev=1427110&view=auto
==============================================================================
--- jackrabbit/site/trunk/content/JCR/jackrabbit-configuration.data/repository.xml (added)
+++ jackrabbit/site/trunk/content/JCR/jackrabbit-configuration.data/repository.xml Mon Dec 31 12:40:09 2012
@@ -0,0 +1,141 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+<!DOCTYPE Repository PUBLIC "-//The Apache Software Foundation//DTD Jackrabbit 1.5//EN"
+                            "http://jackrabbit.apache.org/dtd/repository-1.5.dtd">
+<!-- Example Repository Configuration File
+     Used by
+     - org.apache.jackrabbit.core.config.RepositoryConfigTest.java
+     -
+-->
+<Repository>
+    <!--
+        virtual file system where the repository stores global state
+        (e.g. registered namespaces, custom node types, etc.)
+    -->
+    <FileSystem class="org.apache.jackrabbit.core.fs.local.LocalFileSystem">
+        <param name="path" value="${rep.home}/repository"/>
+    </FileSystem>
+
+    <!--
+        security configuration
+    -->
+    <Security appName="Jackrabbit">
+        <!--
+            security manager:
+            class: FQN of class implementing the JackrabbitSecurityManager interface
+        -->
+        <SecurityManager class="org.apache.jackrabbit.core.security.simple.SimpleSecurityManager" workspaceName="security">
+            <!--
+            workspace access:
+            class: FQN of class implementing the WorkspaceAccessManager interface
+            -->
+            <!-- <WorkspaceAccessManager class="..."/> -->
+            <!-- <param name="config" value="${rep.home}/security.xml"/> -->
+        </SecurityManager>
+
+        <!--
+            access manager:
+            class: FQN of class implementing the AccessManager interface
+        -->
+        <AccessManager class="org.apache.jackrabbit.core.security.simple.SimpleAccessManager">
+            <!-- <param name="config" value="${rep.home}/access.xml"/> -->
+        </AccessManager>
+
+        <LoginModule class="org.apache.jackrabbit.core.security.simple.SimpleLoginModule">
+           <!-- 
+              anonymous user name ('anonymous' is the default value)
+            -->
+           <param name="anonymousId" value="anonymous"/>
+           <!--
+              administrator user id (default value if param is missing is 'admin')
+            -->
+           <param name="adminId" value="admin"/>
+        </LoginModule>
+    </Security>
+
+    <!--
+        location of workspaces root directory and name of default workspace
+    -->
+    <Workspaces rootPath="${rep.home}/workspaces" defaultWorkspace="default"/>
+    <!--
+        workspace configuration template:
+        used to create the initial workspace if there's no workspace yet
+    -->
+    <Workspace name="${wsp.name}">
+        <!--
+            virtual file system of the workspace:
+            class: FQN of class implementing the FileSystem interface
+        -->
+        <FileSystem class="org.apache.jackrabbit.core.fs.local.LocalFileSystem">
+            <param name="path" value="${wsp.home}"/>
+        </FileSystem>
+        <!--
+            persistence manager of the workspace:
+            class: FQN of class implementing the PersistenceManager interface
+        -->
+        <PersistenceManager class="org.apache.jackrabbit.core.persistence.bundle.DerbyPersistenceManager">
+          <param name="url" value="jdbc:derby:${wsp.home}/db;create=true"/>
+          <param name="schemaObjectPrefix" value="${wsp.name}_"/>
+        </PersistenceManager>
+        <!--
+            Search index and the file system it uses.
+            class: FQN of class implementing the QueryHandler interface
+        -->
+        <SearchIndex class="org.apache.jackrabbit.core.query.lucene.SearchIndex">
+            <param name="path" value="${wsp.home}/index"/>
+            <param name="textFilterClasses" value="org.apache.jackrabbit.extractor.PlainTextExtractor,org.apache.jackrabbit.extractor.MsWordTextExtractor,org.apache.jackrabbit.extractor.MsExcelTextExtractor,org.apache.jackrabbit.extractor.MsPowerPointTextExtractor,org.apache.jackrabbit.extractor.PdfTextExtractor,org.apache.jackrabbit.extractor.OpenOfficeTextExtractor,org.apache.jackrabbit.extractor.RTFTextExtractor,org.apache.jackrabbit.extractor.HTMLTextExtractor,org.apache.jackrabbit.extractor.XMLTextExtractor"/>
+            <param name="extractorPoolSize" value="2"/>
+            <param name="supportHighlighting" value="true"/>
+        </SearchIndex>
+    </Workspace>
+
+    <!--
+        Configures the versioning
+    -->
+    <Versioning rootPath="${rep.home}/version">
+        <!--
+            Configures the filesystem to use for versioning for the respective
+            persistence manager
+        -->
+        <FileSystem class="org.apache.jackrabbit.core.fs.local.LocalFileSystem">
+            <param name="path" value="${rep.home}/version" />
+        </FileSystem>
+
+        <!--
+            Configures the persistence manager to be used for persisting version state.
+            Please note that the current versioning implementation is based on
+            a 'normal' persistence manager, but this could change in future
+            implementations.
+        -->
+        <PersistenceManager class="org.apache.jackrabbit.core.persistence.bundle.DerbyPersistenceManager">
+          <param name="url" value="jdbc:derby:${rep.home}/version/db;create=true"/>
+          <param name="schemaObjectPrefix" value="version_"/>
+        </PersistenceManager>
+    </Versioning>
+
+    <!--
+        Search index for content that is shared repository wide
+        (/jcr:system tree, contains mainly versions)
+    -->
+    <SearchIndex class="org.apache.jackrabbit.core.query.lucene.SearchIndex">
+        <param name="path" value="${rep.home}/repository/index"/>
+        <param name="textFilterClasses" value="org.apache.jackrabbit.extractor.PlainTextExtractor,org.apache.jackrabbit.extractor.MsWordTextExtractor,org.apache.jackrabbit.extractor.MsExcelTextExtractor,org.apache.jackrabbit.extractor.MsPowerPointTextExtractor,org.apache.jackrabbit.extractor.PdfTextExtractor,org.apache.jackrabbit.extractor.OpenOfficeTextExtractor,org.apache.jackrabbit.extractor.RTFTextExtractor,org.apache.jackrabbit.extractor.HTMLTextExtractor,org.apache.jackrabbit.extractor.XMLTextExtractor"/>
+        <param name="extractorPoolSize" value="2"/>
+        <param name="supportHighlighting" value="true"/>
+    </SearchIndex>
+</Repository>

Added: jackrabbit/site/trunk/content/JCR/jackrabbit-configuration.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/content/JCR/jackrabbit-configuration.html?rev=1427110&view=auto
==============================================================================
--- jackrabbit/site/trunk/content/JCR/jackrabbit-configuration.html (added)
+++ jackrabbit/site/trunk/content/JCR/jackrabbit-configuration.html Mon Dec 31 12:40:09 2012
@@ -0,0 +1,368 @@
+
+<!-- 
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE- 2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License. 
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Jackrabbit Configuration</TITLE>
+    <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+  <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+  <BODY>
+    <DIV id="page">
+      <DIV id="header">
+        <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+        <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+      </DIV>
+      <DIV id="body">
+        <DIV id="navigation">
+  <UL>
+	<LI>Apache Jackrabbit
+	<UL>
+		<LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+		<LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+		<LI><A href="articles.html" title="Articles">Articles</A></LI>
+		<LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+		<LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+		<LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+	</UL>
+	</LI>
+	<LI>Documentation
+	<UL>
+		<LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+		<LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+		<LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+		<LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+		<LI><A href="jcr-api.html" title="JCR & API">JCR &amp; API</A></LI>
+		<LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+		<LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+		<LI><A href="" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+		<LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+		<LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+	</UL>
+	</LI>
+	<LI>Development
+	<UL>
+		<LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+		<LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+		<LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+		<LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+		<LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+		<LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+		<LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+		<LI><A href="website.html" title="Website">Website</A></LI>
+		<LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+		<LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+	</UL>
+	</LI>
+	<LI>Apache Software Foundation
+	<UL>
+		<LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+		<LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+		<LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+	</UL>
+	</LI>
+</UL>
+        </DIV>
+        <DIV id="content">
+          <H1>Jackrabbit Configuration</H1>
+  <DIV>
+<UL>
+    <LI><A href="#JackrabbitConfiguration-Repositoryconfiguration">Repository configuration</A></LI>
+<UL>
+    <LI><A href="#JackrabbitConfiguration-Beanconfigurationelements">Bean configuration elements</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Configurationvariables">Configuration variables</A></LI>
+</UL>
+    <LI><A href="#JackrabbitConfiguration-Securityconfiguration">Security configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Workspaceconfiguration">Workspace configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Versioningconfiguration">Versioning configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Searchconfiguration">Search configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Persistenceconfiguration">Persistence configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Filesystemconfiguration">File system configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Clusterconfiguration">Cluster configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Datastoreconfiguration">Data store configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Itemstatelockingconfiguration">Item state locking configuration</A></LI>
+    <LI><A href="#JackrabbitConfiguration-Passwordsinconfiguration%2528asofJackrabbit2.3%2529">Passwords in configuration (as of Jackrabbit 2.3)</A></LI>
+</UL></DIV>
+
+<P>Apache Jackrabbit needs two pieces of information to set up a runtime content repository instance:</P>
+
+<UL>
+	<LI><B>Repository home directory</B> The filesystem path of the directory containing the content repository accessed by the runtime instance of Jackrabbit. This directory usually contains all the repository content, search indexes, internal configuration, and other persistent information managed within the content repository. Note that this is not absolutely required and some persistence managers and other Jackrabbit components may well be configured to access files and even other resources (like remote databases) outside the repository home directory. A designated repository home directory is however always needed even if some components choose to not use it. Jackrabbit will automatically fill in the repository home directory with all the required files and subdirectories when the repository is first instantiated.</LI>
+</UL>
+
+
+<UL>
+	<LI><B>Repository configuration file</B> The filesystem path of the repository configuration XML file. This file specifies the class names and properties of the various Jackrabbit components used to manage and access the content repository. Jackrabbit parses this configuration file and instantiates the specified components when the runtime content repository instance is created.</LI>
+</UL>
+
+
+<P>These two configuration parameters are passed either directly to Jackrabbit when creating a repository instance or indirectly through settings for a JNDI object factory or some other component management system.</P>
+
+<P>For each workspace that was created, there will also be a workspace.xml file created inside the workspace home directory that will be used for the workspace - these files have to be changed, too, because the workspace-specific configuration inside repository.xml is only used as a template for new workspaces, ie. if you use the <TT>createWorkspace()</TT> method of the Jackrabbit API, the workspace.xml is just a copy of the <A href="#JackrabbitConfiguration-Workspaceconfiguration">Workspace</A> element inside repository.xml. You can also manually create the workspace folder with a workspace.xml file to create a new workspace yourself (Please note that depending on the <A href="#JackrabbitConfiguration-Persistenceconfiguration">persistence manager</A> you will also have to setup a database and configure the access to it).</P>
+
+<H2><A name="JackrabbitConfiguration-Repositoryconfiguration"></A>Repository configuration</H2>
+
+<P>The repository configuration file, typically called <TT>repository.xml</TT>, specifies global options like security, versioning and clustering settings. A default workspace configuration template is also included in the repository configuration file. The exact format of this XML configuration file is defined in the following document type definition (DTD) files published by the Apache Jackrabbit project.</P>
+
+<UL>
+	<LI><A href="http://jackrabbit.apache.org/dtd/repository-1.5.dtd" class="external-link">-//The Apache Software Foundation//DTD Jackrabbit 1.5//EN</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/dtd/repository-1.4.dtd" class="external-link">-//The Apache Software Foundation//DTD Jackrabbit 1.4//EN</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/dtd/repository-1.2.dtd" class="external-link">-//The Apache Software Foundation//DTD Jackrabbit 1.2//EN</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/dtd/repository-1.0.dtd" class="external-link">-//The Apache Software Foundation//DTD Jackrabbit 1.0//EN</A></LI>
+</UL>
+
+
+<P>All Jackrabbit 1.x versions are fully backwards compatible, so you can use a recent Jackrabbit version without having to modify your existing repository configuration. Of course you will need to make configuration changes if you want to enable new features like the data store introduced in Jackrabbit 1.4.</P>
+
+<P>The top-level structure of the repository configuration file is shown below. The <TT>&lt;!DOCTYPE&gt;</TT> declaration is optional, but if you include it Jackrabbit 1.5 will use XML validation to make sure that the configuration file is correctly formatted.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-xml">
+&lt;!DOCTYPE Repository
+          PUBLIC <SPAN class="code-quote">&quot;-//The Apache Software Foundation//DTD Jackrabbit 1.5//EN&quot;</SPAN>
+          <SPAN class="code-quote">&quot;http://jackrabbit.apache.org/dtd/repository-1.5.dtd&quot;</SPAN>&gt;
+<SPAN class="code-tag">&lt;Repository&gt;</SPAN>
+  <SPAN class="code-tag">&lt;FileSystem .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;Security .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;Workspaces .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;Workspace .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;Versioning .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;SearchIndex .../&gt;</SPAN>    <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional --&gt;</SPAN></SPAN>
+  <SPAN class="code-tag">&lt;Cluster .../&gt;</SPAN>        <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional, available since 1.2 --&gt;</SPAN></SPAN>
+  <SPAN class="code-tag">&lt;DataStore .../&gt;</SPAN>      <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional, available since 1.4 --&gt;</SPAN></SPAN>
+<SPAN class="code-tag">&lt;/Repository&gt;</SPAN>
+</PRE>
+</DIV></DIV>
+
+<P>Starting with Jackrabbit 1.5, the order of the configuration elements below <TT>&lt;Repository/&gt;</TT> is now fixed.</P>
+
+<P>The repository configuration elements are:</P>
+
+<UL>
+	<LI><TT><A href="#JackrabbitConfiguration-Filesystemconfiguration">FileSystem</A></TT>: The virtual file system used by the repository to store things like registered namespaces and node types.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Securityconfiguration">Security</A></TT>: Authentication and authorization configuration.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Workspaceconfiguration">Workspaces</A></TT>: Configuration on where and how workspaces are managed.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Workspaceconfiguration">Workspace</A></TT>: Default workspace configuration template.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Versioningconfiguration">Versioning</A></TT>:  Configuration of the repository-wide version store.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Searchconfiguration">SearchIndex</A></TT>: Configuration of the search index that covers the repository-wide <TT>/jcr:system</TT> content tree.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Clusterconfiguration">Cluster</A></TT>: Clustering configuration.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Datastoreconfiguration">DataStore</A></TT>: Data store configuration.</LI>
+</UL>
+
+
+<P>See the Jackrabbit 1.5 <A href="jackrabbit-configuration.data/repository.xml">default configuration</A>, for an example repository configuration file.</P>
+
+<DIV class="panelMacro"><TABLE class="tipMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>It is a good idea to place the <TT>repository.xml</TT> file <EM>inside</EM> the repository home directory. This keeps your repository and its configuration nicely contained within a single directory tree.</TD></TR></TABLE></DIV> 
+
+<H3><A name="JackrabbitConfiguration-Beanconfigurationelements"></A>Bean configuration elements</H3>
+
+<P>Most of the entries in the configuration file are based on the following generic JavaBean configuration pattern. Such configuration specifies that the repository should use an instance of the specified class with the specified properties for the named functionality.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-xml">
+<SPAN class="code-tag">&lt;ConfigurationElement class=<SPAN class="code-quote">&quot;fully.qualified.ClassName&quot;</SPAN>&gt;</SPAN>
+  <SPAN class="code-tag">&lt;param name=<SPAN class="code-quote">&quot;property1&quot;</SPAN> value=<SPAN class="code-quote">&quot;...&quot;</SPAN>&gt;</SPAN>
+  <SPAN class="code-tag">&lt;param name=<SPAN class="code-quote">&quot;property2&quot;</SPAN> value=<SPAN class="code-quote">&quot;...&quot;</SPAN>&gt;</SPAN>
+<SPAN class="code-tag">&lt;ConfigurationElement&gt;</SPAN>
+</PRE>
+</DIV></DIV>
+
+<H3><A name="JackrabbitConfiguration-Configurationvariables"></A>Configuration variables</H3>
+
+<P>Jackrabbit supports configuration variables of the form <EM>${name}</EM>. These variables can be used to avoid hardcoding specific options in the configuration files. The following variables are available in all Jackrabbit versions:</P>
+
+<UL>
+	<LI><TT>${rep.home}:</TT> Repository home directory.</LI>
+	<LI><TT>${wsp.name}:</TT> Workspace name. Only available in workspace configuration.</LI>
+	<LI><TT>${wsp.home}:</TT> Workspace home directory. Only available in workspace configuration.</LI>
+</UL>
+
+
+<P>Since Jackrabbit 1.4 (see <A href="https://issues.apache.org/jira/browse/JCR-1304" class="external-link">JCR-1304</A>) it has been possible to use system properties or any application-specific settings as configuration variables.</P>
+
+<H2><A name="JackrabbitConfiguration-Securityconfiguration"></A>Security configuration</H2>
+
+<P>The security configuration element is used to specify authentication and authorization settings for the repository. The structure of the security configuration element is:</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-xml">
+<SPAN class="code-tag">&lt;Security appName=<SPAN class="code-quote">&quot;Jackrabbit&quot;</SPAN>&gt;</SPAN>
+  <SPAN class="code-tag">&lt;SecurityManager .../&gt;</SPAN> <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional, available since 1.5 --&gt;</SPAN></SPAN>
+  <SPAN class="code-tag">&lt;AccessManager .../&gt;</SPAN>   <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- mandatory until 1.4, optional since 1.5 --&gt;</SPAN></SPAN>
+  <SPAN class="code-tag">&lt;LoginModule .../&gt;</SPAN>     <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional --&gt;</SPAN></SPAN>
+<SPAN class="code-tag">&lt;/Security&gt;</SPAN>
+</PRE>
+</DIV></DIV>
+
+<P>By default Jackrabbit uses the <A href="http://java.sun.com/j2se/1.4.2/docs/guide/security/jaas/JAASRefGuide.html" class="external-link">Java Authentication and Authorization Service</A> (JAAS) to authenticate users who try to access the repository. The <TT>appName</TT> parameter in the <TT>&lt;Security/&gt;</TT> element is used as the JAAS application name of the repository.</P>
+
+<P>If JAAS authentication is not available or (as is often the case) too complex to set up, Jackrabbit allows you to specify a repository-specific JAAS <A href="http://java.sun.com/j2se/1.4.2/docs/api/javax/security/auth/spi/LoginModule.html" class="external-link">LoginModule</A> that is then used for authenticating repository users. The default <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/core/security/SimpleLoginModule.html" class="external-link">SimpleLoginModule</A> class included in Jackrabbit implements a trivially simple authentication mechanism that accepts any username and any password as valid authentication credentials.</P>
+
+<P>Once a user has been authenticated, Jackrabbit will use the configured <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/core/security/AccessManager.html" class="external-link">AccessManager</A> to control what parts of the repository content the user is allowed to access and modify. The default <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/core/security/SimpleAccessManager.html" class="external-link">SimpleAccessManager</A> class included in Jackrabbit implements a trivially simple authorization mechanism that grants full read access to all users and write access to everyone except anonymous users.</P>
+
+<P>The slightly more advanced <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/core/security/SimpleJBossAccessManager.html" class="external-link">SimpleJBossAccessManager</A> class was added in Jackrabbit 1.3 (see <A href="https://issues.apache.org/jira/browse/JCR-650" class="external-link">JCR-650</A>). This class is designed for use with the <A href="http://www.jboss.org/jbossas/" class="external-link">JBoss Application Server</A>, where it maps JBoss roles to Jackrabbit permissions.</P>
+
+<H2><A name="JackrabbitConfiguration-Workspaceconfiguration"></A>Workspace configuration</H2>
+
+<P>A Jackrabbit repository contains one or more workspaces that are each configured in a separate <TT>workspace.xml</TT> configuration file. The <TT>Workspaces</TT> element of the repository configuration specifies where and how the workspaces are managed. The repository configuration also contains a default workspace configuration template that is used to create the <TT>workspace.xml</TT> file of a new workspace unless more specific configuration is given when the workspace is created. See the <TT>createWorkspace</TT> methods in the <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/api/JackrabbitWorkspace.html" class="external-link">JackrabbitWorkspace</A> interface for more details on workspace creating workspaces.</P>
+
+<P>The workspace settings in the repository configuration file are:</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-xml">
+&lt;Workspaces rootPath=<SPAN class="code-quote">&quot;${rep.home}/workspaces&quot;</SPAN>
+            defaultWorkspace=<SPAN class="code-quote">&quot;default&quot;</SPAN>
+            configRootPath=<SPAN class="code-quote">&quot;...&quot;</SPAN>  <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional --&gt;</SPAN></SPAN>
+            maxIdleTime=<SPAN class="code-quote">&quot;...&quot;</SPAN>/&gt;   <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional --&gt;</SPAN></SPAN>
+
+<SPAN class="code-tag">&lt;Workspace .../&gt;</SPAN>   <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- default workspace configuration template --&gt;</SPAN></SPAN>
+</PRE>
+</DIV></DIV>
+
+<P>The following global workspace configuration options are specified in the <TT>Workspaces</TT> element:</P>
+
+<UL>
+	<LI><TT>rootPath</TT>: The native file system directory for workspaces. A subdirectory is automatically created for each workspace, and the path of that subdirectory can be used in the workspace configuration as the {{${wsp.path} }}variable.</LI>
+	<LI><TT>defaultWorkspace</TT>: Name of the default workspace. This workspace is automatically created when the repository is first started.</LI>
+	<LI><TT>configRootPath</TT>: By default the configuration of each workspace is stored in a <TT>workspace.xml</TT> file within the workspace directory within the <TT>rootPath</TT> directory. If this option is specified, then the workspace configuration files are stored within the specified path in the virtual file system (see above) configured for the repository.</LI>
+	<LI><TT>maxIdleTime</TT>: By default Jackrabbit only releases resources associated with an opened workspace when the entire repository is closed. This option, if specified, sets the maximum number of seconds that a workspace can remain unused before the workspace is automatically closed.</LI>
+</UL>
+
+
+<P>The workspace configuration template and all <TT>workspace.xml</TT> configuration files have the following structure:</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-xml">
+<SPAN class="code-tag">&lt;Workspace name=<SPAN class="code-quote">&quot;${wsp.name}&quot;</SPAN>&gt;</SPAN>
+  <SPAN class="code-tag">&lt;FileSystem .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;PersistenceManager .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;SearchIndex .../&gt;</SPAN>          <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional --&gt;</SPAN></SPAN>
+  <SPAN class="code-tag">&lt;ISMLocking .../&gt;</SPAN>           <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional, available since 1.4 --&gt;</SPAN></SPAN>
+<SPAN class="code-tag">&lt;/Workspace&gt;</SPAN>
+</PRE>
+</DIV></DIV>
+
+<P>The workspace configuration elements are:</P>
+
+<UL>
+	<LI><TT><A href="#JackrabbitConfiguration-Filesystemconfiguration">FileSystem</A></TT>: The virtual file system passed to the persistence manager and search index.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Persistenceconfiguration">PersistenceManager</A></TT>: Persistence configuration for workspace content.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Searchconfiguration">SearchIndex</A></TT>: Configuration of the workspace search index.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Itemstatelockingconfiguration">ISMLocking</A></TT>: Locking configuration for concurrent access to workspace content.</LI>
+</UL>
+
+
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>To modify the configuration of an existing workspace, you need to change the <TT>workspace.xml</TT> file of that workspace. Changing the <TT>&lt;Workspace/&gt;</TT> element in the repository configuration file will not affect existing workspaces.</TD></TR></TABLE></DIV>
+
+<H2><A name="JackrabbitConfiguration-Versioningconfiguration"></A>Versioning configuration</H2>
+
+<P>The version histories of all versionable nodes are stored in a repository-wide version store configured in the <TT>Versioning</TT> element of the repository configuration. The versioning configuration is much like workspace configuration as they are both used by Jackrabbit for storing content. The main difference between versioning and workspace configuration is that no search index is specified for the version store as version histories are indexed and searched using the repository-wide search index. Another difference is that there are no {{${wsp.name} }}or {{${wsp.path} }}variables for the versioning configuration. Instead the native file system path of the version store is explicitly specified in the configuration.</P>
+
+<P>The structure of the versioning configuration is:</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-xml">
+<SPAN class="code-tag">&lt;Versioning rootPath=<SPAN class="code-quote">&quot;${rep.home}/version&quot;</SPAN>&gt;</SPAN>
+  <SPAN class="code-tag">&lt;FileSystem .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;PersistenceManager .../&gt;</SPAN>
+  <SPAN class="code-tag">&lt;ISMLocking .../&gt;</SPAN>           <SPAN class="code-tag"><SPAN class="code-comment">&lt;!-- optional, available since 1.4 --&gt;</SPAN></SPAN>
+<SPAN class="code-tag">&lt;/Versioning&gt;</SPAN>
+</PRE>
+</DIV></DIV>
+
+<P>The versioning configuration elements are:</P>
+
+<UL>
+	<LI><TT><A href="#JackrabbitConfiguration-Filesystemconfiguration">FileSystem</A></TT>: The virtual file system passed to the persistence manager.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Persistenceconfiguration">PersistenceManager</A></TT>: Persistence configuration for the version store.</LI>
+	<LI><TT><A href="#JackrabbitConfiguration-Itemstatelockingconfiguration">ISMLocking</A></TT>: Locking configuration for concurrent access to workspace content.</LI>
+</UL>
+
+
+<H2><A name="JackrabbitConfiguration-Searchconfiguration"></A>Search configuration</H2>
+
+<P>See the <A href="http://wiki.apache.org/jackrabbit/Search" class="external-link">Search</A> page on the Jackrabbit wiki.</P>
+
+<H2><A name="JackrabbitConfiguration-Persistenceconfiguration"></A>Persistence configuration</H2>
+
+<P>The Persistence Manager is one of the most important parts of the configuration, because it actually takes care of storing the nodes and properties. There are various very different implementations, but most of them are using databases to store the data. If you use a database PM and like to connect to an external database, you might also have to setup the database. This might include access rights for the Jackrabbit database user to allow creation of tables, because the name of the table typically depends on the workspace name (see the individual PM's javadoc for more information).</P>
+
+<P>For large binary properties there is the option to use the <TT><A href="#JackrabbitConfiguration-Datastoreconfiguration">DataStore</A></TT> instead of the Persistence Manager.</P>
+
+<P>For more detailed information and an overview of available PMs, see the <A href="http://wiki.apache.org/jackrabbit/PersistenceManagerFAQ" class="external-link">PersistenceManagerFAQ</A> page on the Jackrabbit wiki.</P>
+
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>If you use a database persistence manager, the configured database connection <B>must not</B> be under the control of an external transaction manager. Jackrabbit implements distributed XA transaction support on a higher level, and expects to be in full control of the underlying database connection.</TD></TR></TABLE></DIV>
+
+<H2><A name="JackrabbitConfiguration-Filesystemconfiguration"></A>File system configuration</H2>
+
+<P>Early versions on Jackrabbit were designed to abstract their persistence mechanism using a virtual file system layer defined in the <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/core/fs/FileSystem.html" class="external-link">FileSystem</A> interface. This low-level approach didn't work that well in practice, and so most of the persistence abstraction is now handled in a higher level. However, certain parts of Jackrabbit still use this file system abstraction.</P>
+
+<P>A virtual file system is configured in a <TT>&lt;FileSystem/&gt;</TT> bean configuration element. See the main file system implementations <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/core/fs/local/LocalFileSystem.html" class="external-link">LocalFileSystem</A>, <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/core/fs/db/DatabaseFileSystem.html" class="external-link">DatabaseFileSystem</A> (including subclasses), and <A href="http://jackrabbit.apache.org/api/1.5/org/apache/jackrabbit/core/fs/mem/MemoryFileSystem.html" class="external-link">MemoryFileSystem</A> for the available options. The recommended alternative is to use the LocalFileSystem implementation that simply maps abstract file system accesses to the specified directory within the native file system.</P>
+
+<H2><A name="JackrabbitConfiguration-Clusterconfiguration"></A>Cluster configuration</H2>
+
+<P>See the <A href="http://wiki.apache.org/jackrabbit/Clustering" class="external-link">Clustering</A> page on the Jackrabbit wiki.</P>
+
+<H2><A name="JackrabbitConfiguration-Datastoreconfiguration"></A>Data store configuration</H2>
+
+<P>See the <A href="http://wiki.apache.org/jackrabbit/DataStore" class="external-link">DataStore</A> page on the Jackrabbit wiki.</P>
+
+<H2><A name="JackrabbitConfiguration-Itemstatelockingconfiguration"></A>Item state locking configuration</H2>
+
+<P>TODO</P>
+
+<H2><A name="JackrabbitConfiguration-Passwordsinconfiguration%28asofJackrabbit2.3%29"></A>Passwords in configuration (as of Jackrabbit 2.3)</H2>
+
+<P>When using a database-backed persistence manager or another component, you usually need to include the database password in Jackrabbit configuration. If you don't want to store such passwords in plain text inside the configuration file, you can encode the password in base64 and prefix it with &quot;{base64}&quot;. Jackrabbit will automatically decode such a password before passing it to the underlying database.</P>
+
+<P>As an example, the following two password configuration parameters are equivalent (&quot;dGVzdA==&quot; is the base64 encoding of &quot;test&quot;):</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-xml">
+<SPAN class="code-tag">&lt;param name=<SPAN class="code-quote">&quot;password&quot;</SPAN> value=<SPAN class="code-quote">&quot;test&quot;</SPAN>/&gt;</SPAN>
+<SPAN class="code-tag">&lt;param name=<SPAN class="code-quote">&quot;password&quot;</SPAN> value=<SPAN class="code-quote">&quot;{base64}dGVzdA==&quot;</SPAN>/&gt;</SPAN>
+</PRE>
+</DIV></DIV>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 2004-2010 The Apache Software Foundation.
+          - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+          [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75311">edit this page</A>]
+          <BR>
+          Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+          Jackrabbit project logo are trademarks of The Apache Software Foundation.
+        </P>
+      </DIV>
+    </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+  </BODY>
+</HTML>

Added: jackrabbit/site/trunk/content/JCR/jackrabbit-core-141.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/content/JCR/jackrabbit-core-141.html?rev=1427110&view=auto
==============================================================================
--- jackrabbit/site/trunk/content/JCR/jackrabbit-core-141.html (added)
+++ jackrabbit/site/trunk/content/JCR/jackrabbit-core-141.html Mon Dec 31 12:40:09 2012
@@ -0,0 +1,214 @@
+
+<!-- 
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE- 2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License. 
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>jackrabbit-core 1.4.1</TITLE>
+    <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+  <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+  <BODY>
+    <DIV id="page">
+      <DIV id="header">
+        <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+        <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+      </DIV>
+      <DIV id="body">
+        <DIV id="navigation">
+  <UL>
+	<LI>Apache Jackrabbit
+	<UL>
+		<LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+		<LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+		<LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+		<LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+		<LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+	</UL>
+	</LI>
+	<LI>Documentation
+	<UL>
+		<LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+		<LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+		<LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+		<LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+		<LI><A href="jcr-api.html" title="JCR & API">JCR &amp; API</A></LI>
+		<LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+		<LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+		<LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+		<LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+		<LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+	</UL>
+	</LI>
+	<LI>Development
+	<UL>
+		<LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+		<LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+		<LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+		<LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+		<LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+		<LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+		<LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+		<LI><A href="website.html" title="Website">Website</A></LI>
+		<LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+		<LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+	</UL>
+	</LI>
+	<LI>Apache Software Foundation
+	<UL>
+		<LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+		<LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+		<LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+	</UL>
+	</LI>
+</UL>
+        </DIV>
+        <DIV id="content">
+          <H1>jackrabbit-core 1.4.1</H1>
+  <P>Release Notes &ndash; Apache Jackrabbit Core &ndash; Version 1.4.1</P>
+
+<H2><A name="jackrabbit-core1.4.1-Introduction"></A>Introduction</H2>
+
+<P>This is the 1.4.1 patch release of the jackrabbit-core component of Apache Jackrabbit, a fully conforming implementation of the Content Repository for Java Technology API (JCR).</P>
+
+<P>This release fixes a binary property regression (JCR-1346) as well as other issues reported against the Apache Jackrabbit 1.4 release. See below for a full list of changes in this release.</P>
+
+<P>See the Apache Jackrabbit website at <A href="http://jackrabbit.apache.org/" class="external-link">http://jackrabbit.apache.org/</A> for more information.</P>
+
+<H2><A name="jackrabbit-core1.4.1-ReleaseContents"></A>Release Contents</H2>
+
+<P>Unlike previous Jackrabbit releases that contained a full set of components, this patch release only contains the jackrabbit-core component. The component is distributed both as a source archive and a pre-compiled binary.</P>
+
+<P><B>Source archive (jackrabbit-core-1.4.1-src.jar)</B></P>
+
+<P>The source archive contains the full source code of this release in a &quot;jackrabbit-core-1.4.1&quot; directory. Use the following commands (or the equivalent in your environment) to build the component with Maven 2 and Java 1.4 or higher:</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+$ jar xf jackrabbit-core-1.4.1-src.jar
+$ cd jackrabbit-1.4.1
+$ mvn install
+</PRE>
+</DIV></DIV>
+
+<P><B>Pre-compiled binary (jackrabbit-core-1.4.1.jar)</B></P>
+
+<P>Core of the Apache Jackrabbit content repository implementation.</P>
+
+<P>See the included README.txt file for more information.</P>
+
+<P>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.</P>
+
+<H2><A name="jackrabbit-core1.4.1-Changesandknownissuesinthisrelease"></A>Changes and known issues in this release</H2>
+
+<P>All the changes and known issues in this release are listed below. The issue identifier and title is listed for each change and known issue. You can look up individual issues for more details in the Jackrabbit issue tracker at <A href="http://issues.apache.org/jira/browse/JCR" class="external-link">http://issues.apache.org/jira/browse/JCR</A></P>
+
+<P>Bug fixes</P>
+
+<UL>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1046" class="external-link">JCR-1046</A>] Non-versionable children of a versionable node should not be ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1227" class="external-link">JCR-1227</A>] Restore of empty multivalue property always changes property ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1305" class="external-link">JCR-1305</A>] JNDI data sources with BundleDbPersistenceManager: ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1318" class="external-link">JCR-1318</A>] Repository Home locked not released despite ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1322" class="external-link">JCR-1322</A>] Cluster information is not persisted to database when ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1323" class="external-link">JCR-1323</A>] When using QueryImpl.setLimit() and QueryImpl.setOffset(), ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1332" class="external-link">JCR-1332</A>] CLONE -Aggregate include ignored if no primaryType set</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1341" class="external-link">JCR-1341</A>] Cluster Journal directory should be created automatically</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1346" class="external-link">JCR-1346</A>] InternalValue.createCopy for binary properties (jcr:data) ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1358" class="external-link">JCR-1358</A>] Cluster revision file not closed on repository shutdown.</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1372" class="external-link">JCR-1372</A>] [PATCH] Fix possible Null Ptr exception in ConnectionFactory</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1374" class="external-link">JCR-1374</A>] [PATCH] DbDataStore: Make sure streams are closed</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1376" class="external-link">JCR-1376</A>] SearchIndex parameter cacheSize is ignored</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1379" class="external-link">JCR-1379</A>] AbstractExcerpt uses wrong logger</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1380" class="external-link">JCR-1380</A>] CachingHierarchyManager synchronization problem</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1389" class="external-link">JCR-1389</A>] setProperty(&quot;name&quot;, new Value[0], PropertyType.LONG) loses ...</LI>
+</UL>
+
+
+<P>Known issues</P>
+
+<UL>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-43" class="external-link">JCR-43</A>]   Restore on nodes creates same-name-sibling of ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-320" class="external-link">JCR-320</A>]  BinaryValue equals fails for two objects with ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-392" class="external-link">JCR-392</A>]  Querying element by number does not work</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-435" class="external-link">JCR-435</A>]  Node.update() does not work correct for SNS</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-449" class="external-link">JCR-449</A>]  inconsistency in internal version items during commits</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-517" class="external-link">JCR-517</A>]  Reserved status of namespace jcr not enforced</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-522" class="external-link">JCR-522</A>]  XPath parser too tolerant</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-537" class="external-link">JCR-537</A>]  Failure to remove a versionable node</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-538" class="external-link">JCR-538</A>]  failing Node.checkin() or Node.checkout() might leave ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-566" class="external-link">JCR-566</A>]  Versioning bug with restore and transactions</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-575" class="external-link">JCR-575</A>]  unicode escapes in files generated by JJTree</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-591" class="external-link">JCR-591</A>]  XPath position function does not work</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-639" class="external-link">JCR-639</A>]  Allow modification of OPV=IGNORE items even if parent ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-643" class="external-link">JCR-643</A>]  Own AccessManager + VersionManager : AccessDenied problem</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-690" class="external-link">JCR-690</A>]  Nodes' and properties' names with invalid XML ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-709" class="external-link">JCR-709</A>]  ArrayStoreException is thrown when jcr:deref() is used ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-777" class="external-link">JCR-777</A>]  Order by clause using child axis does not throw ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-843" class="external-link">JCR-843</A>]  XPath does not work with sub-axes</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-908" class="external-link">JCR-908</A>]  Unable to properly restore a previous version of a node that ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-932" class="external-link">JCR-932</A>]  Lossy SQL parsing</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-935" class="external-link">JCR-935</A>]  ConcurrentModificationException during logout (cont'd)</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-936" class="external-link">JCR-936</A>]  Using Oracle bundle PM throws SQL exception (cannot insert NULL)</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-983" class="external-link">JCR-983</A>]  fn:upper accepted in too many places</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1002" class="external-link">JCR-1002</A>] QueryManager does not throw exception if property name ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1075" class="external-link">JCR-1075</A>] Error with predicate in query with multiple jcr:deref()</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1117" class="external-link">JCR-1117</A>] Bundle cache is not rolled back when the storage of a ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1135" class="external-link">JCR-1135</A>] boolean value constraints exposed in custom format</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1173" class="external-link">JCR-1173</A>] Session scoped lock has no effect on other cluster nodes</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1187" class="external-link">JCR-1187</A>] Asking a property twice for it's stream returns the same ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1211" class="external-link">JCR-1211</A>] QueryManager does not throw exception if jcr:deref is used in ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1223" class="external-link">JCR-1223</A>] Occasional NPE on node checkin</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1248" class="external-link">JCR-1248</A>] ParseException if search string ends with '!'</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1275" class="external-link">JCR-1275</A>] NullPointerException in AbstractVersionManager....</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1334" class="external-link">JCR-1334</A>] Deadlock with XA enabled</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1354" class="external-link">JCR-1354</A>] Repository shutdown reposts ERROR: failed to close connection</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1359" class="external-link">JCR-1359</A>] Adding nodes from concurrently running sessions cause exceptions</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1360" class="external-link">JCR-1360</A>] Parsing built-in CND and XML nodetypes does not result in ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1362" class="external-link">JCR-1362</A>] DatabaseJournal improperly finds tables in external schemas ...</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1367" class="external-link">JCR-1367</A>] Exception when closing connection under db2</LI>
+	<LI>[<A href="https://issues.apache.org/jira/browse/JCR-1387" class="external-link">JCR-1387</A>] Lock token not removed from session when node is removed</LI>
+</UL>
+
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 2004-2010 The Apache Software Foundation.
+          - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+          [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=79901">edit this page</A>]
+          <BR>
+          Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+          Jackrabbit project logo are trademarks of The Apache Software Foundation.
+        </P>
+      </DIV>
+    </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+  </BODY>
+</HTML>