jackrabbit-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mdue...@apache.org
Subject svn commit: r1595954 [1/2] - in /jackrabbit/site/live/oak/docs: ./ security/ security/accesscontrol/ security/authentication/ security/permission/ security/principal/ security/privilege/ security/user/
Date Mon, 19 May 2014 16:45:00 GMT
Author: mduerig
Date: Mon May 19 16:44:58 2014
New Revision: 1595954

URL: http://svn.apache.org/r1595954
Log:
OAK-936: Site checkin for project Oak Documentation-0.20-SNAPSHOT

Added:
    jackrabbit/site/live/oak/docs/transactional-model.html
Removed:
    jackrabbit/site/live/oak/docs/.DS_Store
    jackrabbit/site/live/oak/docs/differences_accesscontrol.html
    jackrabbit/site/live/oak/docs/differences_authentication.html
    jackrabbit/site/live/oak/docs/differences_permission.html
    jackrabbit/site/live/oak/docs/differences_principal.html
    jackrabbit/site/live/oak/docs/differences_privileges.html
    jackrabbit/site/live/oak/docs/differences_user.html
    jackrabbit/site/live/oak/docs/from_here.html
    jackrabbit/site/live/oak/docs/security/.DS_Store
    jackrabbit/site/live/oak/docs/when_things_go_wrong.html
Modified:
    jackrabbit/site/live/oak/docs/FAQ.html
    jackrabbit/site/live/oak/docs/big-picture.png
    jackrabbit/site/live/oak/docs/blobstore.html
    jackrabbit/site/live/oak/docs/clustering.html
    jackrabbit/site/live/oak/docs/construct.html
    jackrabbit/site/live/oak/docs/dev_getting_started.html
    jackrabbit/site/live/oak/docs/differences.html
    jackrabbit/site/live/oak/docs/documentmk.html
    jackrabbit/site/live/oak/docs/dos_and_donts.html
    jackrabbit/site/live/oak/docs/downloads.html
    jackrabbit/site/live/oak/docs/index.html
    jackrabbit/site/live/oak/docs/jsop-diff.html
    jackrabbit/site/live/oak/docs/known_issues.html
    jackrabbit/site/live/oak/docs/license.html
    jackrabbit/site/live/oak/docs/microkernel.html
    jackrabbit/site/live/oak/docs/nodestate.html
    jackrabbit/site/live/oak/docs/osgi_config.html
    jackrabbit/site/live/oak/docs/overview.html
    jackrabbit/site/live/oak/docs/participating.html
    jackrabbit/site/live/oak/docs/query.html
    jackrabbit/site/live/oak/docs/security/accesscontrol.html
    jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html
    jackrabbit/site/live/oak/docs/security/accesscontrol/editing.html
    jackrabbit/site/live/oak/docs/security/accesscontrol/restriction.html
    jackrabbit/site/live/oak/docs/security/authentication.html
    jackrabbit/site/live/oak/docs/security/authentication/differences.html
    jackrabbit/site/live/oak/docs/security/authentication/externalloginmodule.html
    jackrabbit/site/live/oak/docs/security/authentication/identitymanagement.html
    jackrabbit/site/live/oak/docs/security/authentication/ldap.html
    jackrabbit/site/live/oak/docs/security/authentication/preauthentication.html
    jackrabbit/site/live/oak/docs/security/authentication/tokenmanagement.html
    jackrabbit/site/live/oak/docs/security/authentication/usersync.html
    jackrabbit/site/live/oak/docs/security/overview.html
    jackrabbit/site/live/oak/docs/security/permission.html
    jackrabbit/site/live/oak/docs/security/permission/differences.html
    jackrabbit/site/live/oak/docs/security/permission/evaluation.html
    jackrabbit/site/live/oak/docs/security/principal.html
    jackrabbit/site/live/oak/docs/security/principal/differences.html
    jackrabbit/site/live/oak/docs/security/privilege.html
    jackrabbit/site/live/oak/docs/security/privilege/differences.html
    jackrabbit/site/live/oak/docs/security/user.html
    jackrabbit/site/live/oak/docs/security/user/authorizableaction.html
    jackrabbit/site/live/oak/docs/security/user/differences.html
    jackrabbit/site/live/oak/docs/security/user/membership.html
    jackrabbit/site/live/oak/docs/security/user/query.html
    jackrabbit/site/live/oak/docs/segmentmk.html
    jackrabbit/site/live/oak/docs/use_getting_started.html

Modified: jackrabbit/site/live/oak/docs/FAQ.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/FAQ.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/FAQ.html (original)
+++ jackrabbit/site/live/oak/docs/FAQ.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak -  Frequently asked questions</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/big-picture.png
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/big-picture.png?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
Binary files - no diff available.

Modified: jackrabbit/site/live/oak/docs/blobstore.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/blobstore.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/blobstore.html (original)
+++ jackrabbit/site/live/oak/docs/blobstore.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - The Blob Store</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -399,9 +399,59 @@
 <li>
 <p>binaries that are similar are always stored separately no matter what</p></li>
 </ul>
-<p>Those problems are solved in Oak BlobStores, because binaries are split into blocks of 2 MB. This is similar to how DropBox works internally: <a class="externalLink" href="http://serverfault.com/questions/52861/how-does-dropbox-version-upload-large-files">http://serverfault.com/questions/52861/how-does-dropbox-version-upload-large-files</a> - blocks are processed in memory so that temp files are never needed, and blocks are cached. File handles don&#x2019;t need to be kept open. Sharding is trivial because each block is processed separately.</p>
+<p>Those problems are solved in Oak BlobStores, because binaries are split into blocks of 2 MB. This is similar to how <a class="externalLink" href="http://serverfault.com/questions/52861/how-does-dropbox-version-upload-large-files">DropBox works internally</a>. Blocks are processed in memory so that temp files are never needed, and blocks are cached. File handles don&#x2019;t need to be kept open. Sharding is trivial because each block is processed separately.</p>
 <p>Binaries that are similar: in the BlobStore, currently, they are stored separately except if some of the 2 MB blocks match. However, the algorithm in the BlobStore would allow to re-use all matching parts, because in the BlobStore, concatenating blob ids means concatenating the data.</p>
-<p>Another change was that most DataStore implementations use SHA-1, while the BlobStore uses SHA-256. Using SHA-256 will be a requirement at some point, see also <a class="externalLink" href="http://en.wikipedia.org/wiki/SHA-2">http://en.wikipedia.org/wiki/SHA-2</a> &#x201c;Federal agencies &#x2026; must use the SHA-2 family of hash functions for these applications after 2010&#x201d;. This might affect some potential users.</p></div>
+<p>Another change was that most DataStore implementations use SHA-1, while the BlobStore uses SHA-256. Using SHA-256 will be a requirement at some point, see also <a class="externalLink" href="http://en.wikipedia.org/wiki/SHA-2">http://en.wikipedia.org/wiki/SHA-2</a> &#x201c;Federal agencies &#x2026; must use the SHA-2 family of hash functions for these applications after 2010&#x201d;. This might affect some potential users.</p>
+<div class="section">
+<h3>Support for Jackrabbit 2 DataStore<a name="Support_for_Jackrabbit_2_DataStore"></a></h3>
+<p>Jackrabbit 2 used <a class="externalLink" href="http://wiki.apache.org/jackrabbit/DataStore">DataStore</a> to store blobs. Oak supports usage of such DataStore via <tt>DataStoreBlobStore</tt> wrapper. This allows usage of <tt>FileDataStore</tt> and <tt>S3DataStore</tt> with Oak NodeStore implementations. </p></div>
+<div class="section">
+<h3>NodeStore and BlobStore<a name="NodeStore_and_BlobStore"></a></h3>
+<p>Currently Oak provides two NodeStore implementations i.e. <tt>SegmentNodeStore</tt> and <tt>DocumentNodeStore</tt>. Further Oak ships with multiple BlobStore implementations</p>
+
+<ol style="list-style-type: decimal">
+  
+<li><tt>FileBlobStore</tt> - Stores the file contents in chunks on file system</li>
+  
+<li><tt>MongoBlobStore</tt> - Stores the file content in chunks in Mongo. Typically used with  <tt>DocumentNodeStore</tt> when running on Mongo by default</li>
+  
+<li><tt>FileDataStore</tt> (with wrapper) - Stores the file on file system without breaking it into  chunks. Mostly used when blobs have to shared between multiple repositories. Also used by  default when migrating Jackrabbit 2 repositories to Oak</li>
+  
+<li><tt>S3DataStore</tt> (with wrapper) - Stores the file in Amazon S3</li>
+</ol>
+<p>In addition there are some more implementations which are considered <b>experimental</b></p>
+
+<ol style="list-style-type: decimal">
+  
+<li><tt>RDBBlobStore</tt> - Stores the file chunks in database</li>
+  
+<li><tt>CloudBlobStore</tt> - Stores the file file chunks in cloud storage using the <a class="externalLink" href="http://jclouds.apache.org/start/blobstore/">JClouds BlobStore API</a>.</li>
+  
+<li><tt>MongoGridFSBlobStore</tt> - Stores the file chunks in Mongo using GridFS support</li>
+</ol>
+<p>Depending on NodeStore type and usage requirement these can be configured to use a particular BlobStore implementation. For OSGi env refer to <a href="osgi_config.html#config-blobstore">Configuring DataStore/BlobStore</a></p>
+<div class="section">
+<h4>SegmentNodeStore<a name="SegmentNodeStore"></a></h4>
+<p>By default SegmentNodeStore does not require a BlobStore. Instead the binary content is directly stored as part of segment blob itself. Depending on requirements one of the following can be used </p>
+
+<ul>
+  
+<li>FileDataStore - This should be used if the blobs/binaries have to be shared between multiple  repositories. This would also be used when a JR2 repository is migrated to Oak</li>
+  
+<li>S3DataStore - This should be used when binaries are stored in Amazon S3</li>
+</ul></div>
+<div class="section">
+<h4>DocumentNodeStore<a name="DocumentNodeStore"></a></h4>
+<p>By default DocumentNodeStore when running on Mongo uses <tt>MongoBlobStore</tt>. Depending on requirements one of the following can be used </p>
+
+<ul>
+  
+<li>MongoBlobStore - Used by default</li>
+  
+<li>FileDataStore - This should be used if the binaries have to be stored on the file system. This  would also be used when a JR2 repository is migrated to Oak</li>
+  
+<li>S3DataStore - This should be used when binaries are stored in Amazon S3. Typically used when running  in Amazon AWS</li>
+</ul></div></div></div>
                   </div>
             </div>
           </div>

Modified: jackrabbit/site/live/oak/docs/clustering.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/clustering.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/clustering.html (original)
+++ jackrabbit/site/live/oak/docs/clustering.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - </title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/construct.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/construct.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/construct.html (original)
+++ jackrabbit/site/live/oak/docs/construct.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Repository construction</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/dev_getting_started.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/dev_getting_started.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/dev_getting_started.html (original)
+++ jackrabbit/site/live/oak/docs/dev_getting_started.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Getting Started</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -377,7 +377,8 @@
    See the License for the specific language governing permissions and
    limitations under the License. --><div class="section">
 <h2>Getting Started<a name="Getting_Started"></a></h2>
-<p>Many parts of Oak are still under construction, so it may be a bit difficult to find your way around the codebase. The <a class="externalLink" href="https://github.com/apache/jackrabbit-oak/blob/trunk/README.md">README files</a>, the <a class="externalLink" href="http://wiki.apache.org/jackrabbit/Jackrabbit%203">Jackrabbit 3 wiki page</a>, and the <a class="externalLink" href="http://oak.markmail.org/">Oak mailing list</a> archives are good places to start learning about Oak.</p>
+<p>Many parts of Oak are still under construction, so it may be a bit difficult to find your way around the codebase. The <a class="externalLink" href="https://github.com/apache/jackrabbit-oak/blob/trunk/README.md">README files</a>, this documentation, and the <a class="externalLink" href="http://oak.markmail.org/">Oak mailing list</a> archives are good places to start learning about Oak.</p>
+<p>There is also the <a class="externalLink" href="http://wiki.apache.org/jackrabbit/Jackrabbit%203">Jackrabbit 3 wiki page</a>, which is mostly outdated though and should only be consulted for historical research.</p>
 <p>To get started developing Oak, build the latest sources with Maven 3 and Java 6 (or higher) like this:</p>
 
 <div class="source">

Modified: jackrabbit/site/live/oak/docs/differences.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/differences.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/differences.html (original)
+++ jackrabbit/site/live/oak/docs/differences.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Backward compatibility</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -383,7 +383,7 @@
 <p>This section gives a brief overview of the most notable changes in Oak with respect to Jackrabbit 2. These changes are generally caused by overall design decisions carefully considering the benefits versus the potential backward compatibility issues.</p>
 <div class="section">
 <h2>Session state and refresh behaviour<a name="Session_state_and_refresh_behaviour"></a></h2>
-<p>In Jackrabbit 2 sessions always reflects the latest state of the repository. With Oak a session reflects a stable view of the repository from the time the session was acquired (<a class="externalLink" href="http://en.wikipedia.org/wiki/MVCC">MVCC model</a>). This is a fundamental design aspect for achieving the distributed nature of an Oak repository.</p>
+<p>In Jackrabbit 2 sessions always reflects the latest state of the repository. With Oak a session reflects a stable view of the repository from the time the session was acquired (<a class="externalLink" href="http://en.wikipedia.org/wiki/MVCC">MVCC model</a>). This is a fundamental design aspect for achieving the distributed nature of an Oak repository. A rarely encountered side effect of this is that sessions expose <a href="transactional-model.html">write skew</a>.</p>
 <p>This change can cause subtle differences in behavior when two sessions perform modifications relying on one session seeing the other session&#x2019;s changes. Oak requires explicit calls to <tt>Session.refresh()</tt>in this case.</p>
 
 <blockquote>

Modified: jackrabbit/site/live/oak/docs/documentmk.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/documentmk.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/documentmk.html (original)
+++ jackrabbit/site/live/oak/docs/documentmk.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Oak DocumentMK</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -664,6 +664,7 @@ nodes
 }
 </pre></div>
 <p>The <tt>_id</tt> is the cluster node id of the node, which is the last part of the revision id. The <tt>leaseEnd</tt> is updated once per minute by running cluster nodes. It is the number of milliseconds since 1970. The <tt>instance</tt> is the current working directory. The <tt>machine</tt> is the lowest number of the network addresses, or a random uuid if this is not available. The <tt>info</tt> contains the same info as a string, plus additionally the process id and the uuid.</p>
+<p><a name="rw-preference"></a></p>
 <div class="section">
 <h3>Specifying the Read Preference and Write Concern<a name="Specifying_the_Read_Preference_and_Write_Concern"></a></h3>
 <p>With <tt>MongoDocumentStore</tt> you can specify the the <a class="externalLink" href="http://docs.mongodb.org/manual/core/read-preference/">read preference</a> and <a class="externalLink" href="http://docs.mongodb.org/manual/core/write-concern/">write concern</a>. This can be enabled in Oak via two modes. </p>

Modified: jackrabbit/site/live/oak/docs/dos_and_donts.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/dos_and_donts.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/dos_and_donts.html (original)
+++ jackrabbit/site/live/oak/docs/dos_and_donts.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Session refresh behavior</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/downloads.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/downloads.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/downloads.html (original)
+++ jackrabbit/site/live/oak/docs/downloads.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Downloads</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/index.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/index.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/index.html (original)
+++ jackrabbit/site/live/oak/docs/index.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Jackrabbit Oak - the next generation content repository</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -380,16 +380,13 @@
 <div class="section">
 <h2>Why Oak<a name="Why_Oak"></a></h2>
 <p>Jackrabbit 2.x is a solid and feature-rich content repository that works well especially for the needs of traditional web sites and integrated content management applications. However, the trends in user expectations (especially for personalized, interactive and collaborative content), application architectures (distributed, loosely coupled, multi-platform solutions with lots of data) and hardware design (horizontal rather than vertical scaling) have rendered some of the original Jackrabbit design decisions (which date back almost a decade) obsolete and there is no easy way to incrementally update the design.</p>
-<p>Jackrabbit Oak aims to implement a scalable and performant hierarchical content repository for use as the foundation of modern world-class web sites and other demanding content applications. The repository should implement standards like JCR, WebDAV and CMIS, and be easily accessible from various platforms, especially from JavaScript clients running in modern browser environments. The implementation should provide more out-of-the-box functionality than typical NoSQL databases while achieving comparable levels of scalability and performance.</p>
-<p>See the Jackrabbit Wiki for an initial list of <a class="externalLink" href="https://wiki.apache.org/jackrabbit/Goals%20and%20non%20goals%20for%20Jackrabbit%203">goals and non goals</a> for Oak.</p></div>
+<p>Jackrabbit Oak aims to implement a scalable and performant hierarchical content repository for use as the foundation of modern world-class web sites and other demanding content applications. The repository should implement standards like JCR, WebDAV and CMIS, and be easily accessible from various platforms, especially from JavaScript clients running in modern browser environments. The implementation should provide more out-of-the-box functionality than typical NoSQL databases while achieving comparable levels of scalability and performance.</p></div>
 <div class="section">
 <h2>Work in Progress<a name="Work_in_Progress"></a></h2>
 <p>This documentation is still work in progress. Currently much of the information on Oak is somewhat spread over different places. If you don&#x2019;t find something here you could also try</p>
 
 <ul>
   
-<li>the <a class="externalLink" href="http://wiki.apache.org/jackrabbit/Jackrabbit%203">Jackrabbit Oak Wiki Page</a>,</li>
-  
 <li>the <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK">Oak JIRA</a>, specifically <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-14">OAK-14</a>, which lists the known backward compatibility issues,</li>
   
 <li>the <a class="externalLink" href="http://jackrabbit.markmail.org/search/+list:org.apache.jackrabbit.oak-dev">Oak development list</a>,</li>

Modified: jackrabbit/site/live/oak/docs/jsop-diff.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/jsop-diff.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/jsop-diff.html (original)
+++ jackrabbit/site/live/oak/docs/jsop-diff.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - </title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/known_issues.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/known_issues.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/known_issues.html (original)
+++ jackrabbit/site/live/oak/docs/known_issues.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Known issues</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/license.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/license.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/license.html (original)
+++ jackrabbit/site/live/oak/docs/license.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - License</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/microkernel.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/microkernel.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/microkernel.html (original)
+++ jackrabbit/site/live/oak/docs/microkernel.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - MicroKernel and NodeStore</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/nodestate.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/nodestate.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/nodestate.html (original)
+++ jackrabbit/site/live/oak/docs/nodestate.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Understanding the node state model</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/osgi_config.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/osgi_config.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/osgi_config.html (original)
+++ jackrabbit/site/live/oak/docs/osgi_config.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Repository OSGi Configuration</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -427,7 +427,29 @@
 <div class="source">
 <pre>mongouri=mongodb://localhost:27017
 db=oak
-</pre></div></div></div>
+</pre></div>
+<div class="section">
+<h5>Mongo Configuration<a name="Mongo_Configuration"></a></h5>
+<p>All the configuration related to Mongo can be specified via <a class="externalLink" href="http://docs.mongodb.org/manual/reference/connection-string/">Mongo URI</a></p>
+
+<ul>
+  
+<li>
+<p><b>Authentication</b> - Username and password should be specified as part of uri e.g. the following  connects and logs in to the admin database as user sysop with the password moon:</p>
+  
+<div class="source">
+<pre>mongodb://sysop:moon@localhost
+</pre></div></li>
+  
+<li>
+<p><b>Read Preferences and Write Concern</b> - These also can be spcified as part of Mongo URI. Refer to  <a href="documentmk.html#rw-preference">Read Preference and Write Concern</a> section for more details. For  e.g. following would set <i>readPreference</i> to <i>secondary</i> and prefer replica with tag <i>dc:ny,rack:1</i>.  It would also specify the write timeout to 10 sec</p>
+  
+<div class="source">
+<pre>mongodb://db1.example.net,db2.example.com?readPreference=secondary&amp;readPreferenceTags=dc:ny,rack:1&amp;readPreferenceTags=dc:ny&amp;readPreferenceTags=&amp;w=1&amp;wtimeoutMS=10000    
+</pre></div></li>
+</ul>
+<p>One can also specify the connection pool size, socket timeout etc. For complete details about various possible option refer to <a class="externalLink" href="http://docs.mongodb.org/manual/reference/connection-string/">Mongo URI</a> </p>
+<p><a name="config-blobstore"></a> </p></div></div></div>
 <div class="section">
 <h3>Configuring DataStore/BlobStore<a name="Configuring_DataStoreBlobStore"></a></h3>
 <p>BlobStores are used to store the binary content. Support for Jackrabbit 2 <tt>DataStore</tt> is also provided via a <tt>DataStoreBlobStore</tt> wrapper. To use a specific BlobStore implementation following two steps need to be performed</p>

Modified: jackrabbit/site/live/oak/docs/overview.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/overview.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/overview.html (original)
+++ jackrabbit/site/live/oak/docs/overview.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - The big picture</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/participating.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/participating.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/participating.html (original)
+++ jackrabbit/site/live/oak/docs/participating.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Participating</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/query.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query.html (original)
+++ jackrabbit/site/live/oak/docs/query.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - The Query Engine</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/accesscontrol.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/accesscontrol.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Access Control</title>
     <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - AccessControl Management : Differences wrt Jackrabbit 2.x</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/accesscontrol/editing.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/accesscontrol/editing.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol/editing.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol/editing.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Using the Access Control Management API</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/accesscontrol/restriction.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/accesscontrol/restriction.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol/restriction.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol/restriction.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-15
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140515" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Restriction Management</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-15</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/authentication.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Authentication</title>
     <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/authentication/differences.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/differences.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/differences.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/differences.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Authentication : Differences wrt Jackrabbit 2.x</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/authentication/externalloginmodule.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/externalloginmodule.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/externalloginmodule.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/externalloginmodule.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-15
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140515" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Authentication with the External Login Module</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-15</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/authentication/identitymanagement.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/identitymanagement.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/identitymanagement.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/identitymanagement.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - External Identity Management</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/authentication/ldap.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/ldap.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/ldap.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/ldap.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - LDAP Integration</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/authentication/preauthentication.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/preauthentication.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/preauthentication.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/preauthentication.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-15
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140515" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Pre-Authenticated Login</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-15</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/authentication/tokenmanagement.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/tokenmanagement.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/tokenmanagement.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/tokenmanagement.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-15
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140515" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Token Authentication and Token Management</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-15</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/authentication/usersync.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/usersync.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/usersync.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/usersync.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - User and Group Synchronization</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/overview.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/overview.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/overview.html (original)
+++ jackrabbit/site/live/oak/docs/security/overview.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - The Oak Security Layer</title>
     <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/permission.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/permission.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/permission.html (original)
+++ jackrabbit/site/live/oak/docs/security/permission.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Permissions</title>
     <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -434,6 +434,9 @@ if (session.hasPermission(&quot;/content
 <div class="section">
 <h3>Oak Permissions<a name="Oak_Permissions"></a></h3>
 <div class="section">
+<h4>General Notes<a name="General_Notes"></a></h4>
+<p>As of Oak 1.0 Permission evaluation is intended to be completely separated from the access control management as defined by JCR and Jackrabbit API. While the evaluation and enforcing permissions is considered to be an internal feature of the Oak core module, the package <tt>org.apache.jackrabbit.oak.spi.security.authorization.permission</tt> provides some extensions points that allow to plug custom extensions or implementations the evaluation (see <a href="#api_extensions">API Extensions</a> below).</p></div>
+<div class="section">
 <h4>Built-in Permissions<a name="Built-in_Permissions"></a></h4>
 <p>Oak 1.0 defines the following <a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authorization/permission/Permissions.html">Permissions</a>:</p>
 <div class="section">
@@ -612,7 +615,9 @@ if (session.hasPermission(&quot;/content
 <h3>Characteristics of the Permission Evaluation<a name="Characteristics_of_the_Permission_Evaluation"></a></h3>
 <div class="section">
 <h4>General Notes<a name="General_Notes"></a></h4>
-<p>In general the permission evaluation related code in Oak is intended to be more clearly separated from the access control management such as defined by the JCR and Jackrabbit API. While permission evaluation is considered to be an internal feature of the Oak core module, the package <tt>org.apache.jackrabbit.oak.spi.security.authorization.permission</tt> provides some extensions points that allow to plug custom extensions or implementations of the permission evaluation.</p></div>
+<p>As explained above permission evaluation is completely separated from the access control management and the associated ccontent. The evaluation itself is done by the configured <tt>PermissionProvider</tt>.</p>
+<p>The default implementation of the <tt>PermissionProvider</tt> interface evaluates permissions based on the information stored in a dedicated part of the repository content call the <a href="#permissionStore">permission store</a>.</p>
+<p>Similar each JCR <tt>Session</tt> (and Oak <tt>ContentSession</tt>) gets it&#x2019;s own <tt>PermissionProvider</tt> associated with the current repository revision the session is operating on. The evaluated permissions and caches are not shared between different sessions even if they represent the same subject.</p></div>
 <div class="section">
 <h4>Differences wrt Jackrabbit 2.x<a name="Differences_wrt_Jackrabbit_2.x"></a></h4>
 <p>see the corresponding <a href="permission/differences.html">documentation</a>.</p></div>
@@ -648,11 +653,49 @@ if (session.hasPermission(&quot;/content
 <p>See section <a href="permission/evaluation.html">Permission Evaluation in Detail</a>.</p></div></div>
 <div class="section">
 <h4>Permission Representation in the Repository<a name="Permission_Representation_in_the_Repository"></a></h4>
+<p><a name="permissionStore"></a></p>
 <div class="section">
 <h5>Permission Store<a name="Permission_Store"></a></h5>
-<p><i>todo</i></p></div>
+<p>The permission evaluation present with Oak 1.0 keeps a dedicated location where permissions are being stored for later evaluation. The store is kept in sync with the access control content by a separated <tt>PostValidationHook</tt> implementation (<a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/security/authorization/permission/PermissionHook.html">PermissionHook</a>).</p>
+<p>The location of the permission store is <tt>/jcr:system/rep:permissionStore</tt>; in accordance with other stores underneath <tt>jcr:system</tt> it is global to the whole repository keeping a separate entry for each workspace present with the repository.</p>
+<p>The permission entries are grouped by principal and stored below the store root based on the hash value of the path of the access controlled node; hash collisions are handled by adding subnodes accordingly.</p>
+
+<div class="source">
+<pre>/jcr:system/rep:permissionStore/workspace-name [rep:PermissionStore]
+    /principal-name [rep:PermissionStore]
+        /1259237738 [rep:PermissionStore]
+            /0     [rep:Permissions]
+            /1     [rep:Permissions]
+            /c0     [rep:PermissionStore]   # hash collision
+                /0      [rep:Permissions]
+                /1      [rep:Permissions]
+                /2      [rep:Permissions]
+            /c1     [rep:PermissionStore]   # hash collision
+                /0      [rep:Permissions]
+                /1      [rep:Permissions]
+                /2      [rep:Permissions]
+        /47    [rep:PermissionStore]
+            /0     [rep:Permissions]
+            /1     [rep:Permissions]
+</pre></div>
+<p>Each per path store looks as follows</p>
+
+<div class="source">
+<pre>&quot;1259237738&quot; {
+    &quot;jcr:primaryType&quot;: &quot;rep:PermissionStore&quot;,
+    &quot;rep:accessControlledPath&quot;: &quot;/content&quot;,
+    &quot;0&quot;: {
+        &quot;jcr:primaryType&quot;: &quot;rep:Permissions&quot;,
+        &quot;rep:isAllow&quot;: false,
+        &quot;rep:privileges&quot;: [32],
+        &quot;rep:ntNames&quot;: [&quot;nt:unstructured&quot;, &quot;oak:Unstructured&quot;]
+        ... /* additional restrictions as present in the entry */
+    }
+}
+</pre></div></div>
 <div class="section">
 <h5>Node Type Definitions<a name="Node_Type_Definitions"></a></h5>
+<p>For the permission store the following built-in node types have been defined:</p>
 
 <div class="source">
 <pre>[rep:PermissionStore]
@@ -666,11 +709,15 @@ if (session.hasPermission(&quot;/content
   - * (UNDEFINED) protected IGNORE
   - * (UNDEFINED) protected multiple IGNORE
   + * (rep:Permissions) = rep:Permissions protected IGNORE
+</pre></div>
+<p>In addition Oak 1.0 defines a specific mixin type that allows to store the path(s) of the versionable node with each version history. Adding this mixing and updating the versionable path information is taken care of by a dedicated commit hook implementation (<tt>VersionablePathHook</tt>).</p>
 
-[rep:VersionablePaths]
+<div class="source">
+<pre>[rep:VersionablePaths]
   mixin
   - * (PATH) protected ABORT
-</pre></div></div></div></div>
+</pre></div>
+<p><a name="api_extensions"></a></p></div></div></div>
 <div class="section">
 <h3>API Extensions<a name="API_Extensions"></a></h3>
 <p>Due to the separation of access control management from permission evaluation, Oak 1.0 comes with a dedicated API for permission discovery that is used both for the repository internal permission evaluation as well as for permission discovery at JCR level.</p>
@@ -678,28 +725,19 @@ if (session.hasPermission(&quot;/content
 
 <ul>
   
-<li><tt>PermissionProvider</tt>: Main entry point for permission discovery and evaluation.
+<li><a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authorization/permission/PermissionProvider.html">PermissionProvider</a>: Main entry point for permission discovery and evaluation.
   
 <ul>
     
-<li><tt>TreePermission</tt>: Evaluates the permissions of a given Oak <tt>Tree</tt>, exposed by <tt>PermissionProvider</tt>.</li>
+<li><a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authorization/permission/TreePermission.html">TreePermission</a>: Evaluates the permissions of a given Oak <tt>Tree</tt>, exposed by <tt>PermissionProvider</tt>.</li>
     
-<li><tt>RepositoryPermission</tt>: Evaluates the repository level permissions, exposed by <tt>PermissionProvider</tt>.</li>
+<li><a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authorization/permission/RepositoryPermission.html">RepositoryPermission</a>: Evaluates the repository level permissions, exposed by <tt>PermissionProvider</tt>.</li>
   </ul></li>
   
-<li><tt>Permissions</tt>: The permissions defined, respected and evaluated by the repository.</li>
+<li><a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authorization/permission/Permissions.html">Permissions</a>: The permissions defined, respected and evaluated by the repository.</li>
   
-<li><tt>PermissionConstants</tt>: Constants used throughout the permission evaluation.</li>
-</ul>
-<div class="section">
-<h4>PermissionProvider<a name="PermissionProvider"></a></h4>
-<p><i>todo</i></p></div>
-<div class="section">
-<h4>TreePermission<a name="TreePermission"></a></h4>
-<p><i>todo</i></p></div>
-<div class="section">
-<h4>RepositoryPermission<a name="RepositoryPermission"></a></h4>
-<p><i>todo</i></p></div></div>
+<li><a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authorization/permission/PermissionConstants.html">PermissionConstants</a>: Constants used throughout the permission evaluation.</li>
+</ul></div>
 <div class="section">
 <h3>Configuration<a name="Configuration"></a></h3>
 <p>The configuration of the permission evaluation implementation is handled by the <a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authorization/AuthorizationConfiguration.html">AuthorizationConfiguration</a>, which is used for all authorization related matters. This class provides the following two permission related methods:</p>
@@ -774,7 +812,7 @@ if (session.hasPermission(&quot;/content
   </tbody>
 </table>
 <div class="section">
-<h5>PARAM_PERMISSIONS_JR2<a name="PARAM_PERMISSIONS_JR2"></a></h5>
+<h5>Supported Values for PARAM_PERMISSIONS_JR2<a name="Supported_Values_for_PARAM_PERMISSIONS_JR2"></a></h5>
 
 <ul>
   

Modified: jackrabbit/site/live/oak/docs/security/permission/differences.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/permission/differences.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/permission/differences.html (original)
+++ jackrabbit/site/live/oak/docs/security/permission/differences.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Permissions : Differences wrt Jackrabbit 2.x</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/permission/evaluation.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/permission/evaluation.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/permission/evaluation.html (original)
+++ jackrabbit/site/live/oak/docs/security/permission/evaluation.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-16
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140516" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Permission Evaluation in Detail</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-16</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 
@@ -380,28 +380,8 @@
    limitations under the License. --><div class="section">
 <h2>Permission Evaluation in Detail<a name="Permission_Evaluation_in_Detail"></a></h2>
 <div class="section">
-<h3>General Remarks<a name="General_Remarks"></a></h3>
-<p>As of Oak 1.0 Permission evaluation is completely separated from the access control content and is executed based on the information stored in the permission store. The latter is kept in sync with the access control information using dedicated <tt>CommitHook</tt> implementation ([PermissionHook]). The evaluation itself is done by the configured <tt>PermissionProvider</tt> that read and evaluates the information stored in the permission store.</p>
-<p>Each JCR <tt>Session</tt> (or Oak <tt>ContentSession</tt>) gets it&#x2019;s own <tt>PermissionProvider</tt> associated with the current repository revision the session is operating on. Consequently, the evaluated permissions and caches are not shared between different sessions even if they represent the same subject.</p>
 <div class="section">
 <h4>Evaluation of Permission Entries<a name="Evaluation_of_Permission_Entries"></a></h4>
-<p><i>todo</i></p></div></div>
-<div class="section">
-<h3>Overview on Permission Evaluation<a name="Overview_on_Permission_Evaluation"></a></h3>
-<div class="section">
-<h4><a name="permissionStore"></a> The Permission Store<a name="The_Permission_Store"></a></h4>
-<p><i>todo</i></p></div>
-<div class="section">
-<h4><a name="PermissionProvider"></a> PermissionProvider</h4>
-<p><i>todo</i></p></div>
-<div class="section">
-<h4><a name="SecureNodeBuilder"></a> SecureNodeBuilder</h4>
-<p><i>todo</i></p></div>
-<div class="section">
-<h4><a name="getTreePermission"></a> TreePermission<a name="TreePermission"></a></h4>
-<p><i>todo</i></p></div>
-<div class="section">
-<h4><a name="getEntryIterator"></a> PermissionEntry Iterator<a name="PermissionEntry_Iterator"></a></h4>
 <p><i>todo</i></p></div>
 <div class="section">
 <h4>Reading a Node : Step by Step<a name="Reading_a_Node_:_Step_by_Step"></a></h4>
@@ -423,7 +403,7 @@
 <p>For that an iterator of the <i>permission entries</i> is <a href="#getEntryIterator">retrieved</a> which  provides all the relevant permission entries needed to be evaluated for this tree (and  and set of principals associated with the permission provider).</p></li>
   
 <li>
-<p>The <i>permission entries</i> are analyzed if they include the respective permission and if so,  the read status is set accordingly. Note that the sequence of the permission entries from  the iterator is already in the correct order for this kind of evaluation. this is ensured  by the way how they are stored in the <a href="#permissionStore">permission store</a> and how they  are feed into the iterator.</p>
+<p>The <i>permission entries</i> are analyzed if they include the respective permission and if so,  the read status is set accordingly. Note that the sequence of the permission entries from  the iterator is already in the correct order for this kind of evaluation. this is ensured  by the way how they are stored in the <a href="../permission.html#permissionStore">permission store</a> and how they  are feed into the iterator.</p>
 <p>The iteration also detects if the evaluated permission entries cover <i>this</i> node and all  its properties. If this is the case, subsequent calls that evaluate the property read  permissions would then not need to do the same iteration again. In order to detect this,  the iteration checks if a non-matching permission entry or privilege was skipped  and eventually sets the respective flag in the <tt>ReadStatus</tt>. This flag indicates if the  present permission entries are sufficient to tell if the session is allowed to read  <i>this</i> node and all its properties. If there are more entries present than the ones needed  for evaluating the <tt>READ_NODE</tt> permission, then it&#x2019;s ambiguous to determine if all  properties can be read.</p></li>
   
 <li>
@@ -448,6 +428,15 @@
 <p><i>todo</i></p></div>
 <div class="section">
 <h4>Registering a Node Type : Step by Step<a name="Registering_a_Node_Type_:_Step_by_Step"></a></h4>
+<p><i>todo</i></p></div>
+<div class="section">
+<h4><a name="SecureNodeBuilder"></a> SecureNodeBuilder</h4>
+<p><i>todo</i></p></div>
+<div class="section">
+<h4><a name="getTreePermission"></a> TreePermission<a name="TreePermission"></a></h4>
+<p><i>todo</i></p></div>
+<div class="section">
+<h4><a name="getEntryIterator"></a> PermissionEntry Iterator<a name="PermissionEntry_Iterator"></a></h4>
 <p><i>todo</i></p>
 <!-- hidden references --></div></div></div>
                   </div>

Modified: jackrabbit/site/live/oak/docs/security/principal.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/principal.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/principal.html (original)
+++ jackrabbit/site/live/oak/docs/security/principal.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-15
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140515" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Principal Management</title>
     <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-15</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 

Modified: jackrabbit/site/live/oak/docs/security/principal/differences.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/principal/differences.html?rev=1595954&r1=1595953&r2=1595954&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/principal/differences.html (original)
+++ jackrabbit/site/live/oak/docs/security/principal/differences.html Mon May 19 16:44:58 2014
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2014-05-14
+ | Generated by Apache Maven Doxia at 2014-05-19
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20140514" />
+    <meta name="Date-Revision-yyyymmdd" content="20140519" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Jackrabbit Oak - Principal Management : Differences wrt Jackrabbit 2.x</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.3.0.min.css" />
@@ -163,7 +163,7 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2014-05-14</li>
+                  <li id="publishDate">Last Published: 2014-05-19</li>
                   <li class="divider">|</li> <li id="projectVersion">Version: 0.20-SNAPSHOT</li>
                       
                 



Mime
View raw message