jackrabbit-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From thom...@apache.org
Subject svn commit: r1793486 [4/6] - in /jackrabbit/site/live/oak/docs: ./ architecture/ coldstandby/ css/ features/ images/ js/ nodestore/ nodestore/document/ nodestore/segment/ oak-mongo-js/ oak_api/ plugins/ query/ security/ security/accesscontrol/ security...
Date Tue, 02 May 2017 13:04:23 GMT
Modified: jackrabbit/site/live/oak/docs/query/query-engine.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query/query-engine.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query/query-engine.html (original)
+++ jackrabbit/site/live/oak/docs/query/query-engine.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -169,6 +170,7 @@
       <ul class="nav nav-list">
     <li class="active"><a href="#"><span class="none"></span>Query Engine</a>
   </li>
+    <li><a href="../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -252,7 +254,7 @@
 <p>If you enable debug logging for the module <tt>org.apache.jackrabbit.oak.query</tt>, you may see this:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">cost for nodeType is 1638354.0
+<div class="source"><pre class="prettyprint">cost for nodeType is 1638354.0
 cost for property is 2.0
 cost for traverse is 3451100.0
 </pre></div></div>
@@ -268,14 +270,14 @@ cost for traverse is 3451100.0
 <p>By default, queries without index will log an info level message as follows (see OAK-4888, since Oak 1.6):</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">Traversal query (query without index): {statement}; consider creating an index
+<div class="source"><pre class="prettyprint">Traversal query (query without index): {statement}; consider creating an index
 </pre></div></div>
 <p>This message is only logged if no index is available, and if the query potentially traverses many nodes. No message is logged if an index is available, but traversing is cheap.</p>
 <p>By setting the JMX configuration <tt>QueryEngineSettings.failTraversal</tt> to true, queries without index throw an exception instead of just logging a message.</p>
 <p>In the query itself, the syntax <tt>option(traversal {ok|fail|warn})</tt> is supported (at the very end of the statement, after <tt>order by</tt>). This is to override the default setting, for queries that traverse a well known number of nodes (for example 10 or 20 nodes). This is supported for both XPath and SQL-2, as follows: </p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">/jcr:root/oak:index/*[@type='lucene'] option(traversal ok)
+<div class="source"><pre class="prettyprint">/jcr:root/oak:index/*[@type='lucene'] option(traversal ok)
 
 select * from [nt:base] 
 where ischildnode('/oak:index') 
@@ -290,12 +292,12 @@ option(traversal ok)
 <p>Oak 1.2.x and newer supports a compatibility flag so that it works in the same way as Jackrabbit 2.x, by returning an estimate. See also OAK-2926. This is best configured as described in OAK-2977: When using Apache Sling, since Oak 1.3.x, add the following line to the file <tt>conf/sling.properties</tt>, and then restart the application:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">oak.query.fastResultSize=true
+<div class="source"><pre class="prettyprint">oak.query.fastResultSize=true
 </pre></div></div>
 <p>Please note this only works with the Lucene <tt>compatVersion=2</tt> right now. Example code to show how this work (where <tt>test</tt> is a common word in the index):</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">String query = &quot;//element(*, cq:Page)[jcr:contains(., 'test')]&quot;;
+<div class="source"><pre class="prettyprint">String query = &quot;//element(*, cq:Page)[jcr:contains(., 'test')]&quot;;
 Query query = queryManager.createQuery(qs, &quot;xpath&quot;);
 QueryResult result = query.execute();
 long size = result.getRows().getSize();
@@ -305,13 +307,13 @@ long size = result.getRows().getSize();
 <p>The query parser is now generally more strict about invalid syntax. The following query used to work in Jackrabbit 2.x, but not in Oak, because multiple way to quote the path are used at the same time:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">SELECT * FROM [nt:base] AS s 
+<div class="source"><pre class="prettyprint">SELECT * FROM [nt:base] AS s 
 WHERE ISDESCENDANTNODE(s, [&quot;/libs/sling/config&quot;])
 </pre></div></div>
 <p>Instead, the query now needs to be:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">SELECT * FROM [nt:base] AS s 
+<div class="source"><pre class="prettyprint">SELECT * FROM [nt:base] AS s 
 WHERE ISDESCENDANTNODE(s, [/libs/sling/config])
 </pre></div></div></div>
 <div class="section">
@@ -319,7 +321,7 @@ WHERE ISDESCENDANTNODE(s, [/libs/sling/c
 <p>In Jackrabbit 2.x, the following condition was interpreted as a LIKE condition:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">SELECT * FROM nt:base WHERE jcr:path = '/abc/%'
+<div class="source"><pre class="prettyprint">SELECT * FROM nt:base WHERE jcr:path = '/abc/%'
 </pre></div></div>
 <p>Therefore, the query behaves exactly the same as if LIKE was used. In Oak, this is no longer the case, and such queries search for an exact path match.</p></div></div>
 <div class="section">
@@ -327,7 +329,7 @@ WHERE ISDESCENDANTNODE(s, [/libs/sling/c
 <p>Slow queries are logged as follows:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">*WARN* Traversed 10000 nodes with filter Filter(query=select ...)
+<div class="source"><pre class="prettyprint">*WARN* Traversed 10000 nodes with filter Filter(query=select ...)
 consider creating an index or changing the query
 </pre></div></div>
 <p>If this is the case, an index might need to be created, or the condition of the query might need to be changed to take advantage of an existing index.</p>
@@ -339,7 +341,7 @@ consider creating an index or changing t
 <p>The full-text syntax supported by Jackrabbit Oak is a superset of the JCR specification. The following syntax is supported within <tt>contains</tt> queries:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">FullTextSearch ::= Or
+<div class="source"><pre class="prettyprint">FullTextSearch ::= Or
 Or ::= And { ' OR ' And }* 
 And ::= Term { ' ' Term }*
 Term ::= ['-'] { SimpleTerm | PhraseTerm } [ '^' Boost ]
@@ -351,7 +353,7 @@ Boost ::= &lt;number&gt;
 <p>Examples:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">jcr:contains(., 'jelly sandwich^4')
+<div class="source"><pre class="prettyprint">jcr:contains(., 'jelly sandwich^4')
 jcr:contains(@jcr:title, 'find this')
 </pre></div></div>
 <p>In the first example, the word &#x201c;sandwich&#x201d; has weight four times more than the word &#x201c;jelly.&#x201d; For details of boosting, see the Apache Lucene documentation about Score Boosting.</p>
@@ -361,7 +363,7 @@ jcr:contains(@jcr:title, 'find this')
 <p>To take advantage of features that are available in full-text index implementations such as Apache Lucene and Apache Lucene Solr, so called <tt>native</tt> constraints are supported. Such constraints are passed directly to the full-text index. This is supported for both XPath and SQL-2. For XPath queries, the name of the function is <tt>rep:native</tt>, and for SQL-2, it is <tt>native</tt>. The first parameter is the index type (currently supported are <tt>solr</tt> and <tt>lucene</tt>). The second parameter is the native search query expression. For SQL-2, the selector name (if needed) is the first parameter, just before the language. Examples:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">//*[rep:native('solr', 'name:(Hello OR World)')]
+<div class="source"><pre class="prettyprint">//*[rep:native('solr', 'name:(Hello OR World)')]
 
 select [jcr:path] from [nt:base] 
 where native('solr', 'name:(Hello OR World)')
@@ -372,7 +374,7 @@ where native(a, 'solr', 'name:(Hello OR
 <p>This also allows to use the Solr <a class="externalLink" href="http://wiki.apache.org/solr/MoreLikeThis">MoreLikeThis</a> feature. An example query is:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">select [jcr:path] from [nt:base] 
+<div class="source"><pre class="prettyprint">select [jcr:path] from [nt:base] 
 where native('solr', 'mlt?q=id:UTF8TEST&amp;mlt.fl=manu,cat&amp;mlt.mindf=1&amp;mlt.mintf=1')
 </pre></div></div>
 <p>If no full-text implementation is available, those queries will fail.</p></div>
@@ -381,7 +383,7 @@ where native('solr', 'mlt?q=id:UTF8TEST&
 <p>Oak supports similarity queries when using the Lucene or Solr indexes. For example, the following query will return nodes that have similar content than the node /test/a:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">//element(*, nt:base)[rep:similar(., '/test/a')]
+<div class="source"><pre class="prettyprint">//element(*, nt:base)[rep:similar(., '/test/a')]
 </pre></div></div>
 <p>Compared to Jackrabbit 2.x, support for rep:similar has the following limitations: Full-text aggregation is not currently supported.</p></div>
 <div class="section">
@@ -390,14 +392,14 @@ where native('solr', 'mlt?q=id:UTF8TEST&
 <p>Oak supports spellcheck queries when using the Lucene or Solr indexes. Unlike most queries, spellcheck queries won&#x2019;t return a JCR <tt>Node</tt> as the outcome of such queries will be text terms that come from content as written into JCR <tt>properties</tt>. For example, the following query will return spellchecks for the (wrongly spelled) term <tt>helo</tt>:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">/jcr:root[rep:spellcheck('helo')]/(rep:spellcheck())
+<div class="source"><pre class="prettyprint">/jcr:root[rep:spellcheck('helo')]/(rep:spellcheck())
 </pre></div></div>
 <p>The result of such a query will be a JCR <tt>Row</tt> which will contain the corrected terms, as spellchecked by the used underlying index, in a special property named <tt>rep:spellcheck()</tt>.</p>
 <p>Clients wanting to obtain spellchecks could use the following JCR code:</p>
 <p><tt>@until Oak 1.3.10, 1.2.13</tt> spellchecks are returned flat.</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">QueryManager qm = ...;
+<div class="source"><pre class="prettyprint">QueryManager qm = ...;
 String xpath = &quot;/jcr:root[rep:spellcheck('helo')]/(rep:spellcheck())&quot;;
 QueryResult result = qm.createQuery(xpath, Query.XPATH).execute();
 RowIterator it = result.getRows();
@@ -409,12 +411,12 @@ if (it.hasNext()) {
 <p>The <tt>spellchecks</tt> String would be have the following pattern <tt>\[[\w|\W]+(\,\s[\w|\W]+)*\]</tt>, e.g.:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">[hello, hold]
+<div class="source"><pre class="prettyprint">[hello, hold]
 </pre></div></div>
 <p><tt>@since Oak 1.3.11, 1.2.14</tt> each spellcheck would be returned per row.</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">QueryManager qm = ...;
+<div class="source"><pre class="prettyprint">QueryManager qm = ...;
 String xpath = &quot;/jcr:root[rep:spellcheck('helo')]/(rep:spellcheck())&quot;;
 QueryResult result = qm.createQuery(xpath, Query.XPATH).execute();
 RowIterator it = result.getRows();
@@ -431,14 +433,14 @@ while (it.hasNext()) {
 <p>Oak supports search suggestions when using the Lucene or Solr indexes. Unlike most queries, suggest queries won&#x2019;t return a JCR <tt>Node</tt> as the outcome of such queries will be text terms that come from content as written into JCR <tt>properties</tt>. For example, the following query will return search suggestions for the (e.g. user entered) term <tt>in</tt>:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">/jcr:root[rep:suggest('in ')]/(rep:suggest())
+<div class="source"><pre class="prettyprint">/jcr:root[rep:suggest('in ')]/(rep:suggest())
 </pre></div></div>
 <p>The result of such a query will be a JCR <tt>Row</tt> which will contain the suggested terms, together with their score, as suggested and scored by the used underlying index, in a special property named <tt>rep:suggest()</tt>.</p>
 <p>Clients wanting to obtain suggestions could use the following JCR code:</p>
 <p><tt>@until Oak 1.3.10, 1.2.13</tt> suggestions are returned flat.</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">QueryManager qm = ...;
+<div class="source"><pre class="prettyprint">QueryManager qm = ...;
 String xpath = &quot;/jcr:root[rep:suggest('in ')]/(rep:suggest())&quot;;
 QueryResult result = qm.createQuery(xpath, Query.XPATH).execute();
 RowIterator it = result.getRows();
@@ -450,13 +452,13 @@ if (it.hasNext()) {
 <p>The <tt>suggestions</tt> String would be have the following pattern <tt>\[\{(term\=)[\w|\W]+(\,weight\=)\d+\}(\,\{(term\=)[\w|\W]+(\,weight\=)\d+\})*\]</tt>, e.g.:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">[{term=in 2015 a red fox is still a fox,weight=1.5}, {term=in 2015 my fox is red, 
+<div class="source"><pre class="prettyprint">[{term=in 2015 a red fox is still a fox,weight=1.5}, {term=in 2015 my fox is red, 
 like mike's fox and john's fox,weight=0.7}]
 </pre></div></div>
 <p><tt>@since Oak 1.3.11, 1.2.14</tt> each suggestion would be returned per row.</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">QueryManager qm = ...;
+<div class="source"><pre class="prettyprint">QueryManager qm = ...;
 String xpath = &quot;/jcr:root[rep:suggest('in ')]/(rep:suggest())&quot;;
 QueryResult result = qm.createQuery(xpath, Query.XPATH).execute();
 RowIterator it = result.getRows();
@@ -471,7 +473,7 @@ while (it.hasNext()) {
 <p><tt>@since Oak 1.3.14</tt> Oak has support for <a class="externalLink" href="https://en.wikipedia.org/wiki/Faceted_search">facets</a>. Once enabled (see details for <a href="lucene.html#Facets">Lucene</a> and/or <a href="solr.html#Suggestions">Solr</a> indexes) facets can be retrieved on properties (backed by a proper field in Lucene / Solr) using the following snippet:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">String sql2 = &quot;select [jcr:path], [rep:facet(tags)] from [nt:base] &quot; +
+<div class="source"><pre class="prettyprint">String sql2 = &quot;select [jcr:path], [rep:facet(tags)] from [nt:base] &quot; +
                 &quot;where contains([jcr:title], 'oak');
 Query q = qm.createQuery(sql2, Query.JCR_SQL2);
 QueryResult result = q.execute();
@@ -491,7 +493,7 @@ for (FacetResult.Facet facet : facets) {
 <p>Every conversion is logged in <tt>debug</tt> level under the <tt>org.apache.jackrabbit.oak.query.QueryEngineImpl</tt> logger:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">org.apache.jackrabbit.oak.query.QueryEngineImpl Parsing xpath statement: 
+<div class="source"><pre class="prettyprint">org.apache.jackrabbit.oak.query.QueryEngineImpl Parsing xpath statement: 
     //element(*)[@sling:resourceType = 'slingevent:Lock')]
 org.apache.jackrabbit.oak.query.QueryEngineImpl XPath &gt; SQL2: 
     select [jcr:path], [jcr:score], * from [nt:base] as a 
@@ -520,7 +522,7 @@ org.apache.jackrabbit.oak.query.QueryEng
 <h3><a name="SQL2_Optimisation"></a>SQL2 Optimisation</h3>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">@since 1.3.9 with -Doak.query.sql2optimisation
+<div class="source"><pre class="prettyprint">@since 1.3.9 with -Doak.query.sql2optimisation
 </pre></div></div>
 <p>Enabled by default in 1.3.11 it will perform a round of optimisation on the <tt>Query</tt> object obtained after parsing a SQL2 statement. It will for example attempt a conversion of OR conditions into UNION <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-1617">OAK-1617</a>.</p>
 <p>To disable it provide <tt>-Doak.query.sql2optimisation=false</tt> at the start-up.</p></div>
@@ -529,12 +531,12 @@ org.apache.jackrabbit.oak.query.QueryEng
 <p>The Oak implementation supports some features that are not part of the JCR specification:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">@since 1.5.12
+<div class="source"><pre class="prettyprint">@since 1.5.12
 </pre></div></div>
 <p>Union for XPath and SQL-2 queries. Examples:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">/jcr:root/(content|lib)/*
+<div class="source"><pre class="prettyprint">/jcr:root/(content|lib)/*
 /jcr:root/content//*[@a] | /jcr:root/lib//*[@b]) order by @c
 select * from [nt:base] as a where issamenode(a, '/content') 
 union select * from [nt:base] as a where issamenode(a, '/lib')

Modified: jackrabbit/site/live/oak/docs/query/query-troubleshooting.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query/query-troubleshooting.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query/query-troubleshooting.html (original)
+++ jackrabbit/site/live/oak/docs/query/query-troubleshooting.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,8 @@
     <li><a href="../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li class="active"><a href="#"><span class="none"></span>Troubleshooting</a>
+  </li>
     <li><a href="../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -234,27 +237,27 @@
 <p>The first step in query troubleshooting is often to detect a query is slow, or traverses many nodes. Queries that traverse many nodes are logged as follows:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">*WARN* org.apache.jackrabbit.oak.spi.query.Cursors$TraversingCursor 
+<div class="source"><pre class="prettyprint">*WARN* org.apache.jackrabbit.oak.spi.query.Cursors$TraversingCursor 
     Traversed 22000 nodes with filter Filter(query=
     select * from [nt:base] where isdescendantnode('/etc') and lower([jcr:title]) like '%coat%');
     consider creating an index or changing the query
 </pre></div></div>
-<p>To get good performance, queries should not traverse more than about 1000 nodes (specially for queries that are run often).</p></div>
+<p>To get good performance, queries should not traverse more than about 1000 nodes (specially for queries that are run often).</p>
 <div class="section">
-<h3><a name="Potentially_Slow_Queries"></a>Potentially Slow Queries</h3>
-<p>In addition to avoiding queries that traverse many nodes, it makes sense to avoid queries that don&#x2019;t use an index. Such queries might be fast (and only traverse few nodes) with a small repository, but with a large repository they are typically slow as well. Therefore, it makes sense to detect such queries as soon as possible (in a developer environment), even before the code that runs those queries is tested with a large repository. Oak will detect such queries and log them as follows (with log level INFO for Oak 1.6.x, and WARN for Oak 1.8.x):</p>
+<h4><a name="Potentially_Slow_Queries"></a>Potentially Slow Queries</h4>
+<p>In addition to avoiding queries that traverse many nodes, it makes sense to avoid queries that don&#x2019;t use an index. Such queries might be fast (and only traverse few nodes) with a small repository, but with a large repository they are typically slow as well. Therefore, it makes sense to detect such queries as soon as possible (in a developer environment), even before the code that runs those queries is tested with a larger repository. Oak will detect such queries and log them as follows (with log level INFO for Oak 1.6.x, and WARN for Oak 1.8.x):</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">*INFO* org.apache.jackrabbit.oak.query.QueryImpl Traversal query (query without index): 
-select * from [nt:base] where isdescendantnode('/etc') and lower([jcr:title]) like '%coat%'; 
-consider creating an index
-</pre></div></div>
+<div class="source"><pre class="prettyprint">*INFO* org.apache.jackrabbit.oak.query.QueryImpl Traversal query (query without index): 
+    select * from [nt:base] where isdescendantnode('/etc') and lower([jcr:title]) like '%coat%'; 
+    consider creating an index
+</pre></div></div></div>
 <div class="section">
 <h4><a name="Query_Plan"></a>Query Plan</h4>
 <p>To understand why the query is slow, the first step is commonly to get the query execution plan. To do this, the query can be executed using <tt>explain select ...</tt>. For the above case, the plan is:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">[nt:base] as [nt:base] /* traverse &quot;/etc//*&quot; 
+<div class="source"><pre class="prettyprint">[nt:base] as [nt:base] /* traverse &quot;/etc//*&quot; 
 where (isdescendantnode([nt:base], [/etc])) and (lower([nt:base].[jcr:title]) like '%coat%') */
 </pre></div></div>
 <p>That means, all nodes below <tt>/etc</tt> are traversed.</p></div>
@@ -263,7 +266,7 @@ where (isdescendantnode([nt:base], [/etc
 <p>In order to make the query faster, try to add more constraints, or make constraints tighter. This will usually require some knowledge about the expected results. For example, if the path restriction is more specific, then less nodes need to be read. This is also true if an index is used. Also, if possible use a more specific node type. To understand if a nodetype or mixin is indexed, consult the nodetype index at <tt>/oak:index/nodetype</tt>, property <tt>declaringNodeTypes</tt>. But even if this is not the case, the nodetype should be as specific as possible. Assuming the query is changed to this:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">select * from [acme:Product] 
+<div class="source"><pre class="prettyprint">select * from [acme:Product] 
 where isdescendantnode('/etc/commerce') 
 and lower([jcr:title]) like '%coat%')
 and [commerceType] = 'product'
@@ -274,7 +277,7 @@ and [commerceType] = 'product'
 <p>After changing the query, there is still a message in the log file that complains the query doesn&#x2019;t use an index, as described above:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">*INFO* org.apache.jackrabbit.oak.query.QueryImpl 
+<div class="source"><pre class="prettyprint">*INFO* org.apache.jackrabbit.oak.query.QueryImpl 
     Traversal query (query without index): 
     select * from [acme:Product] where isdescendantnode('/etc/commerce') 
     and lower([jcr:title]) like '%coat%'
@@ -286,10 +289,10 @@ and [commerceType] = 'product'
 <p>If it is known from the data model that a query will never traverse many nodes, then no index is needed. This is a corner case, and only applies to queries that traverse a fixed number of (for example) configuration nodes, or if the number of descendant nodes is guaranteed to be very low by using a certain nodetype that only allows for a fixed number of child nodes. If this is the case, then the query can be changed to say traversal is fine. To mark such queries, append <tt>option(traversal ok)</tt> to the query. This feature should only be used for those rare corner cases.</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">select * from [nt:base] 
+<div class="source"><pre class="prettyprint">select * from [nt:base] 
 where isdescendantnode('/etc/commerce') 
-    and lower([jcr:title]) like '%coat%'
-    and [commerceType] = 'product'
+and lower([jcr:title]) like '%coat%'
+and [commerceType] = 'product'
 option(traversal ok)
 </pre></div></div></div>
 <div class="section">
@@ -297,7 +300,7 @@ option(traversal ok)
 <p>To find out how many nodes are in a certain path, you can use the JMX bean <tt>NodeCounter</tt>, which can estimate the node count. Example: run <tt>getEstimatedChildNodeCounts</tt> with <tt>p1=/</tt> and <tt>p2=2</tt> might give you:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">/: 2522208,
+<div class="source"><pre class="prettyprint">/: 2522208,
 ...
 /etc: 1521504,
 /etc/commerce: 29216,
@@ -310,26 +313,38 @@ option(traversal ok)
 <p>To avoid running queries that don&#x2019;t use an index altogether, you can change the configuration in the JMX bean <tt>QueryEngineSettings</tt>: if you set <tt>FailTraversal</tt> to <tt>true</tt>, then queries without index will throw an exception when trying to execute them, no matter how many nodes are in the repository. This doesn&#x2019;t mean queries will never traverse over nodes, it just means that queries that <i>must</i> traverse over nodes will fail.</p></div>
 <div class="section">
 <h4><a name="Using_a_Different_or_New_Index"></a>Using a Different or New Index</h4>
-<p>There are now multiple options:</p>
+<p>There are multiple options:</p>
 
 <ul>
   
+<li>Consider creating an index for <tt>jcr:title</tt>. But for <tt>like '%..%'</tt> conditions,  this is not of much help, because all nodes with that property will need to be read.  Also, using <tt>lower</tt> will make the index less effective.  So, this only makes sense if there are very few nodes with this property  expected to be in the system.</li>
+  
 <li>If there are very few nodes with that nodetype,  consider adding <tt>acme:Product</tt> to the nodetype index. This requires reindexing.  The query could then use the nodetype index, and within this nodetype,  just traverse below <tt>/etc/commerce</tt>.  The <tt>NodeCounter</tt> can also help understand how many <tt>acme:Product</tt>  nodes are in the repository, if this nodetype is indexed.  To find out, run <tt>getEstimatedChildNodeCounts</tt> with  <tt>p1=/oak:index/nodetype</tt> and <tt>p2=2</tt>.</li>
   
-<li>Consider creating an index for <tt>jcr:title</tt>. But for <tt>like '%..%'</tt> conditions,  this is not of much help, because all nodes with that property will need to be read.  Also, using <tt>lower</tt> will make the index less effective.  So, this only makes sense if there are very few nodes with this property  expected to be in the system.</li>
+<li>If the query needs to return added nodes immediately (synchronously; that is without delay),  consider creating a <a href="./property-index.html">property index</a>.  Note that Lucene indexes are asynchronous, and new nodes may not  appear in the result for a few seconds.</li>
+  
+<li>To ensure there is only one node matching the result in the repository,  consider creating a unique <a href="./property-index.html">property index</a>.</li>
   
 <li>Consider using a fulltext index, that is: change the query from using  <tt>lower([jcr:title]) like '%...%'</tt> to using <tt>contains([jcr:title], '...')</tt>.  Possibly combine this with adding the property  <tt>commerceType</tt> to the fulltext index.</li>
 </ul>
 <p>The last plan is possibly the best solution for this case.</p></div>
 <div class="section">
 <h4><a name="Index_Definition_Generator"></a>Index Definition Generator</h4>
-<p>In case you need to modify or create a Lucene property index, you can use the <a class="externalLink" href="http://oakutils.appspot.com/generate/index">Oak Index Definition Generator</a> tool.</p></div>
+<p>In case you need to modify or create a Lucene property index, you can use the <a class="externalLink" href="http://oakutils.appspot.com/generate/index">Oak Index Definition Generator</a> tool.</p>
+<p>As the tool doesn&#x2019;t know your index configuration, it will always suggest to create a new index; it might be better to extend an existing index. However, note that:</p>
+
+<ul>
+  
+<li>Changing an existing index requires reindexing that index.</li>
+  
+<li>If an out-of-the-box index is modified, you will need to merge those modifications  when migrating to newer software.  It is best to add documentation to the index definition to simplify merging,  for example in the form of &#x201c;info&#x201d; properties.</li>
+</ul></div>
 <div class="section">
 <h4><a name="Verification"></a>Verification</h4>
 <p>After changing the query, and possibly the index, run the <tt>explain select</tt> again, and verify the right plan is used, in this case that might be, for the query:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">select * from [acme:Product] 
+<div class="source"><pre class="prettyprint">select * from [acme:Product] 
 where isdescendantnode('/etc/commerce') 
 and contains([jcr:title], 'Coat')
 and [commerceType] = 'product'

Modified: jackrabbit/site/live/oak/docs/query/query.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query/query.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query/query.html (original)
+++ jackrabbit/site/live/oak/docs/query/query.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -169,6 +170,7 @@
 
       <ul class="nav nav-list">
     <li><a href="../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>

Modified: jackrabbit/site/live/oak/docs/query/solr.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query/solr.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query/solr.html (original)
+++ jackrabbit/site/live/oak/docs/query/solr.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -233,7 +235,7 @@
 <p>The Solr index is mainly meant for full-text search (the &#x2018;contains&#x2019; type of queries):</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">//*[jcr:contains(., 'text')]
+<div class="source"><pre class="prettyprint">//*[jcr:contains(., 'text')]
 </pre></div></div>
 <p>but is also able to search by path and property restrictions. Primary type restriction support is also provided by it&#x2019;s not recommended as it&#x2019;s usually much better to use the <a href="query.html#The_Node_Type_Index">node type index</a> for such kind of queries.</p>
 <p>Even if it&#x2019;s not just a full-text index, it&#x2019;s recommended to use it asynchronously (see <tt>Oak#withAsyncIndexing</tt>) because, in most production scenarios, it&#x2019;ll be a &#x2018;remote&#x2019; index and therefore network latency / errors would have less impact on the repository performance.</p>
@@ -256,7 +258,7 @@
 <p>Example:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">{
+<div class="source"><pre class="prettyprint">{
   NodeBuilder index = root.child(&quot;oak:index&quot;);
   index.child(&quot;solr&quot;)
     .setProperty(&quot;jcr:primaryType&quot;, &quot;oak:QueryIndexDefinition&quot;, Type.NAME)
@@ -413,12 +415,12 @@
 <p>In order to enable proper usage of facets in Solr index the following dynamic field needs to be added to the <i>schema.xml</i></p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">    &lt;dynamicField name=&quot;*_facet&quot; type=&quot;string&quot; indexed=&quot;false&quot; stored=&quot;false&quot; docValues=&quot;true&quot; multiValued=&quot;true&quot;/&gt;
+<div class="source"><pre class="prettyprint">    &lt;dynamicField name=&quot;*_facet&quot; type=&quot;string&quot; indexed=&quot;false&quot; stored=&quot;false&quot; docValues=&quot;true&quot; multiValued=&quot;true&quot;/&gt;
 </pre></div></div>
 <p>with dedicated <i>copyFields</i> for specific properties.</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">    &lt;copyField source=&quot;jcr:primaryType&quot; dest=&quot;jcr:primaryType_facet&quot;/&gt; &lt;!-- facet on jcr:primaryType field/property --&gt;
+<div class="source"><pre class="prettyprint">    &lt;copyField source=&quot;jcr:primaryType&quot; dest=&quot;jcr:primaryType_facet&quot;/&gt; &lt;!-- facet on jcr:primaryType field/property --&gt;
 </pre></div></div></div>
 <div class="section">
 <h4><a name="Persisted_configuration"></a>Persisted configuration</h4>
@@ -426,7 +428,7 @@
 <p>It&#x2019;s possible to create (multiple) Solr indexes via persisted configuration. A persisted Oak Solr index is created whenever an index definition with <i>type = solr</i> has a child node named <i>server</i> and such a child node has the <i>solrServerType</i> property set (to either <i>embedded</i> or <i>remote</i>). If no such child node exists, an Oak Solr index will be only created upon explicit registration of a [SolrServerProvider]  e.g. via OSGi. All the <a class="externalLink" href="http://jackrabbit.apache.org/oak/docs/apidocs/org/apache/jackrabbit/oak/plugins/index/solr/configuration/OakSolrConfiguration.html">OakSolrConfiguration</a>  and <a class="externalLink" href="http://jackrabbit.apache.org/oak/docs/apidocs/org/apache/jackrabbit/oak/plugins/index/solr/configuration/SolrServerConfiguration.html">SolrServerConfiguration</a>  properties are exposed and configurable, see also <a class="externalLink" href="https://github.com/apache/jackrabbit-oak/blob/trunk/oak-sol
 r-core/src/main/java/org/apache/jackrabbit/oak/plugins/index/solr/configuration/nodestate/OakSolrNodeStateConfiguration.java#L245">OakSolrNodeStateConfiguration#Properties</a>  and <a class="externalLink" href="https://github.com/apache/jackrabbit-oak/blob/trunk/oak-solr-core/src/main/java/org/apache/jackrabbit/oak/plugins/index/solr/configuration/nodestate/NodeStateSolrServerConfigurationProvider.java#L94">NodeStateSolrServerConfigurationProvider#Properties</a></p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">/oak:index/solrRemote
+<div class="source"><pre class="prettyprint">/oak:index/solrRemote
   - jcr:primaryType = &quot;oak:QueryIndexDefinition&quot;
   - type = &quot;solr&quot;
   - async = &quot;async&quot;

Modified: jackrabbit/site/live/oak/docs/release-schedule.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/release-schedule.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/release-schedule.html (original)
+++ jackrabbit/site/live/oak/docs/release-schedule.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -361,7 +363,7 @@
 <h5><a name="Examples"></a>Examples</h5>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">String path = node.getPath();
+<div class="source"><pre class="prettyprint">String path = node.getPath();
 JackrabbitAccessControlList acl = AccessControlUtils.getAccessControlList(session, path);
 acl.addEntry(principal, privileges, true);
 acMgr.setPolicy(path, acl);

Modified: jackrabbit/site/live/oak/docs/security/accesscontrol/default.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/accesscontrol/default.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol/default.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol/default.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -340,7 +342,7 @@
 <p>All access control policies defined with an Oak repository are stores child of the node they are bound to. The node type definition used to represent access control content:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">[rep:AccessControllable]
+<div class="source"><pre class="prettyprint">[rep:AccessControllable]
   mixin
   + rep:policy (rep:Policy) protected IGNORE
 
@@ -381,7 +383,7 @@
 <h6><a name="Regular_ACL_at_content"></a>Regular ACL at /content</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">&quot;&quot;: {
+<div class="source"><pre class="prettyprint">&quot;&quot;: {
     &quot;jcr:primaryType&quot;: &quot;rep:root&quot;,
     &quot;content&quot;: {
         &quot;jcr:primaryType&quot;: &quot;oak:Unstructured&quot;,
@@ -410,7 +412,7 @@
 <h6><a name="Repo-Level_Policy"></a>Repo-Level Policy</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">&quot;&quot;: {
+<div class="source"><pre class="prettyprint">&quot;&quot;: {
     &quot;jcr:primaryType&quot;: &quot;rep:root&quot;,
     &quot;jcr:mixinTypes&quot;: &quot;rep:RepoAccessControllable&quot;,
     &quot;rep:repoPolicy&quot;: {
@@ -432,7 +434,7 @@
 <p>In order to get the same best effort behavior as present with Jackrabbit 2.x the configuration parameters of the <tt>AuthorizationConfiguration</tt> must contain the following entry:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">importBehavior = &quot;besteffort&quot;
+<div class="source"><pre class="prettyprint">importBehavior = &quot;besteffort&quot;
 </pre></div></div>
 <p>See also (<a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-1350">OAK-1350</a>))</p>
 <p><a name="validation"></a></p></div>

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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol/differences.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/accesscontrol/editing.html (original)
+++ jackrabbit/site/live/oak/docs/security/accesscontrol/editing.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -294,14 +296,14 @@
 <h6><a name="Read_policies_bound_to_a_node"></a>Read policies bound to a node</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">AccessControlManager acMgr = session.getAccessControlManager();
+<div class="source"><pre class="prettyprint">AccessControlManager acMgr = session.getAccessControlManager();
 AccessControlPolicy[] policies = acMgr.getPolicies(&quot;/content&quot;);
 </pre></div></div></div>
 <div class="section">
 <h6><a name="Read_policies_that_have_not_yet_been_bound_to_the_node"></a>Read policies that have not yet been bound to the node</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">AccessControlManager acMgr = session.getAccessControlManager();
+<div class="source"><pre class="prettyprint">AccessControlManager acMgr = session.getAccessControlManager();
 AccessControlPolicyIterator it = acMgr.getApplicablePolicies(&quot;/content&quot;);
 </pre></div></div></div></div></div>
 <div class="section">
@@ -381,7 +383,7 @@ AccessControlPolicyIterator it = acMgr.g
 <h6><a name="Bind_a_policy_to_a_node"></a>Bind a policy to a node</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">AccessControlPolicyIterator it = acMgr.getApplicablePolicies(&quot;/content&quot;);
+<div class="source"><pre class="prettyprint">AccessControlPolicyIterator it = acMgr.getApplicablePolicies(&quot;/content&quot;);
 while (it.hasNext()) {
     AccessControlPolicy policy = it.nextPolicy();
     if (policy instanceof NamedAccessControlPolicy &amp;&amp; &quot;myPolicy&quot;.equals((NamedAccessControlPolicy) policy).getName()) {
@@ -519,7 +521,7 @@ while (it.hasNext()) {
 <h6><a name="Modify_an_AccessControlList"></a>Modify an AccessControlList</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">JackrabbitAccessControlList acl = null;
+<div class="source"><pre class="prettyprint">JackrabbitAccessControlList acl = null;
 // try if there is an acl that has been set before
 for (AccessControlPolicy policy : acMgr.getPolicies(&quot;/content&quot;)) {
     if (policy instanceof JackrabbitAccessControlList) {
@@ -541,7 +543,7 @@ if (acl != null) {
 <h6><a name="Create_or_Modify_an_AccessControlList"></a>Create or Modify an AccessControlList</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">JackrabbitAccessControlList acl = null;
+<div class="source"><pre class="prettyprint">JackrabbitAccessControlList acl = null;
 // try if there is an acl that has been set before
 for (AccessControlPolicy policy : acMgr.getPolicies(&quot;/content&quot;)) {
     if (policy instanceof JackrabbitAccessControlList) {
@@ -573,7 +575,7 @@ if (acl != null) {
 <p>or alternatively use <tt>AccessControlUtils</tt>:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">JackrabbitAccessControlList acl = AccessControlUtils.getAccessControlList(session, &quot;/content&quot;);
+<div class="source"><pre class="prettyprint">JackrabbitAccessControlList acl = AccessControlUtils.getAccessControlList(session, &quot;/content&quot;);
 if (acl != null) {
     PrincipalManager principalManager = jackrabbitSession.getPrincipalManager();
     Principal principal = principalManager.getPrincipal(&quot;jackrabbit&quot;);
@@ -602,7 +604,7 @@ if (acl != null) {
 <h6><a name="Remove_a_policy"></a>Remove a policy</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">for (AccessControlPolicy policy : acMgr.getPolicies(&quot;/content&quot;);
+<div class="source"><pre class="prettyprint">for (AccessControlPolicy policy : acMgr.getPolicies(&quot;/content&quot;);
     if (policy instanceof NamedAccessControlPolicy &amp;&amp; &quot;myPolicy&quot;.equals((NamedAccessControlPolicy) policy).getName()) {
         acMgr.removePolicy(&quot;/content&quot;, policy);
         session.save();
@@ -618,7 +620,7 @@ if (acl != null) {
 <h6><a name="Allow_a_Principal_to_Register_Namespaces"></a>Allow a Principal to Register Namespaces</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">JackrabbitAccessControlList acl = AccessControlUtils.getAccessControlList(session, null);
+<div class="source"><pre class="prettyprint">JackrabbitAccessControlList acl = AccessControlUtils.getAccessControlList(session, null);
 if (acl != null) {
     PrincipalManager principalManager = jackrabbitSession.getPrincipalManager();
     Principal principal = principalManager.getPrincipal(&quot;dinosaur&quot;);

Modified: jackrabbit/site/live/oak/docs/security/authentication.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -349,7 +351,7 @@
 <h6><a name="Example:_Extending_AbstractLoginModule"></a>Example: Extending AbstractLoginModule</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">public class TestLoginModule extends AbstractLoginModule {
+<div class="source"><pre class="prettyprint">public class TestLoginModule extends AbstractLoginModule {
 
     private Credentials credentials;
     private String userId;

Modified: jackrabbit/site/live/oak/docs/security/authentication/default.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/default.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/default.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/default.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -259,7 +261,7 @@
 <p>The proper way to obtain an guest session as of Oak is as specified by JSR 283:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">String wspName = null;
+<div class="source"><pre class="prettyprint">String wspName = null;
 Session anonymous = repository.login(new GuestCredentials(), wspName);
 </pre></div></div>
 <p>As of Oak 1.0 <tt>Repository#login()</tt> and <tt>Repository#login(null, wspName)</tt> is no longer treated as guest login. This behavior of Jackrabbit-core is violating the specification, which defines that null-login should be used for those cases where the authentication process is handled outside of the repository (see <a href="preauthentication.html">Pre-Authentication</a>).</p>
@@ -270,7 +272,7 @@ Session anonymous = repository.login(new
 <p>Example JAAS Configuration:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">jackrabbit.oak {
+<div class="source"><pre class="prettyprint">jackrabbit.oak {
    org.apache.jackrabbit.oak.spi.security.authentication.GuestLoginModule  optional;
    org.apache.jackrabbit.oak.security.authentication.user.LoginModuleImpl required;
 };

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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/differences.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/differences.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -268,7 +270,7 @@
 <p>This modification will not affect applications that used JCR API to impersonate a given session. However the following example which &#x2018;manually&#x2019; builds impersonation credentials the way jackrabbit core was handling it will <b>no longer work</b> to impersonate an existing session:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums"> org.apache.jackrabbit.core.SessionImpl sImpl = (SessionImpl) mySession;
+<div class="source"><pre class="prettyprint"> org.apache.jackrabbit.core.SessionImpl sImpl = (SessionImpl) mySession;
  SimpleCredentials jrImpCreds = new SimpleCredentials(&quot;someUserId, new char[0]);
  creds.setAttribute(SecurityConstants.IMPERSONATOR_ATTRIBUTE, sImpl.getSubject());
  Session impersonated = sImpl.getRepository().login(jrImpCreds, sImpl.getWorkspace().getName());
@@ -276,14 +278,14 @@
 <p>Upon migration to Oak such implementation specific code should be refactored to use regular JCR API for impersonation:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums"> // Note: build credentials depends on the auth setup !
+<div class="source"><pre class="prettyprint"> // Note: build credentials depends on the auth setup !
  Credentials impersonationCredentials = new SimpleCredentials(&quot;someUserId, new char[0]);
  Session impersonated = session.impersonate(impersonationCredentials);
 </pre></div></div>
 <p>In order to achieve impersonation on the Oak API directly:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums"> ContentRepository contentRepo = ...
+<div class="source"><pre class="prettyprint"> ContentRepository contentRepo = ...
  ContentSession editingSession = ...
 
  AuthInfo impersonatorInfo = editingSession.getAuthInfo();

Modified: jackrabbit/site/live/oak/docs/security/authentication/external/defaultusersync.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/external/defaultusersync.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/external/defaultusersync.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/external/defaultusersync.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>

Modified: jackrabbit/site/live/oak/docs/security/authentication/external/dynamic.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/external/dynamic.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/external/dynamic.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/external/dynamic.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>

Modified: jackrabbit/site/live/oak/docs/security/authentication/external/externallogin_examples.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/external/externallogin_examples.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/external/externallogin_examples.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/external/externallogin_examples.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -243,7 +245,7 @@
 <h4><a name="Example_JAAS_Configuration"></a>Example JAAS Configuration</h4>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">  Example {
+<div class="source"><pre class="prettyprint">  Example {
      org.apache.jackrabbit.oak.security.authentication.token.TokenLoginModule sufficient;
      org.apache.jackrabbit.oak.security.authentication.user.LoginModuleImpl sufficient;
      org.apache.jackrabbit.oak.spi.security.authentication.external.impl.ExternalLoginModule required
@@ -364,7 +366,7 @@
 <h4><a name="Example_JAAS_Configuration"></a>Example JAAS Configuration</h4>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">  Example {
+<div class="source"><pre class="prettyprint">  Example {
      your.org.PreAuthenticationLoginModule optional;
      org.apache.jackrabbit.oak.security.authentication.user.LoginModuleImpl optional;
      org.apache.jackrabbit.oak.spi.security.authentication.external.impl.ExternalLoginModule sufficient

Modified: jackrabbit/site/live/oak/docs/security/authentication/external/faq.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/external/faq.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/external/faq.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/external/faq.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/externalloginmodule.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/externalloginmodule.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -434,7 +436,7 @@
 <p>The following JAAS configuration shows how the <tt>ExternalLoginModule</tt> could be used in a setup that not solely uses third party login (Note: JAAS configuration equivalents of the parameters defined by <tt>org.apache.felix.jaas.LoginModuleFactory</tt> are omitted):</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">jackrabbit.oak {
+<div class="source"><pre class="prettyprint">jackrabbit.oak {
      org.apache.jackrabbit.oak.security.authentication.token.TokenLoginModule sufficient;
      org.apache.jackrabbit.oak.security.authentication.user.LoginModuleImpl sufficient;
      org.apache.jackrabbit.oak.spi.security.authentication.external.impl.ExternalLoginModule required
@@ -470,7 +472,7 @@
 <h6><a name="Example_CredentialsSupport"></a>Example CredentialsSupport</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">  @Component()
+<div class="source"><pre class="prettyprint">  @Component()
   @Service(ExternalIdentityProvider.class, CredentialsSupport.class)
   public class MyIdentityProvider implements ExternalIdentityProvider, CredentialsSupport {
 

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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/identitymanagement.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/identitymanagement.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/ldap.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/ldap.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/preauthentication.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/preauthentication.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -262,7 +264,7 @@
 <p>Example implementation of <tt>LoginModule#login</tt> that pushes the <tt>PreAuthenticatedLogin</tt> marker to the shared state:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">public class PreAuthLoginModule extends AbstractLoginModule {
+<div class="source"><pre class="prettyprint">public class PreAuthLoginModule extends AbstractLoginModule {
 
 [...]
 
@@ -317,7 +319,7 @@
 <p>Example how to use this type of pre-authentication:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">String userId = &quot;test&quot;;
+<div class="source"><pre class="prettyprint">String userId = &quot;test&quot;;
 /**
  * Retrive valid principals e.g. by using Jackrabbit or Oak API:
  * - PrincipalManager#getPrincipal and/or #getGroupMembership

Modified: jackrabbit/site/live/oak/docs/security/authentication/token/default.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/security/authentication/token/default.html?rev=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/token/default.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/token/default.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -240,7 +242,7 @@
 <p>The <a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/security/authentication/token/TokenLoginModule.html">TokenLoginModule</a> will obtain these <tt>Credentials</tt> from the shared state during the commit phase (i.e. phase 2 of the JAAS authentication) and will pass them to the configured <a href="/oak/docs/apidocs/org/apache/jackrabbit/oak/spi/security/authentication/token/TokenProvider.html">TokenProvider</a> implementation the following sequence:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">Credentials shared = getSharedCredentials();
+<div class="source"><pre class="prettyprint">Credentials shared = getSharedCredentials();
 if (shared != null &amp;&amp; tokenProvider.doCreateToken(shared)) {
     [...]
     TokenInfo ti = tokenProvider.createToken(shared);
@@ -281,7 +283,7 @@ TokenInfo.resetExpiration(long loginTime
 <p>The login tokens issued for a given user are all located underneath a node named <tt>.tokens</tt> that will be created by the <tt>TokenProvider</tt> once the first token is created. The default implementation creates a distinct node for each login token as described below</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">testUser {
+<div class="source"><pre class="prettyprint">testUser {
     &quot;jcr:primaryType&quot;: &quot;rep:User&quot;,
     ...
     &quot;.tokens&quot; {
@@ -315,7 +317,7 @@ TokenInfo.resetExpiration(long loginTime
 <p>The definition of the new built-in node type <tt>rep:Token</tt>:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">[rep:Token] &gt; mix:referenceable
+<div class="source"><pre class="prettyprint">[rep:Token] &gt; mix:referenceable
 - rep:token.key (STRING) protected mandatory
 - rep:token.exp (DATE) protected mandatory
 - * (UNDEFINED) protected
@@ -324,7 +326,7 @@ TokenInfo.resetExpiration(long loginTime
 <p>The following example illustrates the token nodes resulting from this node type definition:</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">testUser {
+<div class="source"><pre class="prettyprint">testUser {
         &quot;jcr:primaryType&quot;: &quot;rep:User&quot;,
         ...
         &quot;.tokens&quot; {
@@ -543,7 +545,7 @@ TokenInfo.resetExpiration(long loginTime
 <p>In an OSGi-based setup it&#x2019;s sufficient to make the service available to the repository in order to enable a custom <tt>CredentialsSupport</tt>.</p>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">@Component
+<div class="source"><pre class="prettyprint">@Component
 @Service(value = {CredentialsSupport.class})
 /**
  * Custom implementation of the {@code CredentialsSupport} interface.

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=1793486&r1=1793485&r2=1793486&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/security/authentication/tokenmanagement.html (original)
+++ jackrabbit/site/live/oak/docs/security/authentication/tokenmanagement.html Tue May  2 13:04:22 2017
@@ -70,6 +70,7 @@
 <a href="../../query/query.html" title="Query">Query</a>
               <ul class="dropdown-menu">
                   <li><a href="../../query/query-engine.html" title="Query Engine">Query Engine</a></li>
+                  <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting">Troubleshooting</a></li>
                   <li><a href="../../query/indexing.html" title="Indexing">Indexing</a></li>
                   <li><a href="../../query/lucene.html" title="Lucene Index">Lucene Index</a></li>
                   <li><a href="../../query/property-index.html" title="Property Index">Property Index</a></li>
@@ -168,6 +169,7 @@
     <li><a href="../../query/query.html" title="Query"><span class="icon-chevron-down"></span>Query</a>
       <ul class="nav nav-list">
     <li><a href="../../query/query-engine.html" title="Query Engine"><span class="none"></span>Query Engine</a>  </li>
+    <li><a href="../../query/query-troubleshooting.html" title="Troubleshooting"><span class="none"></span>Troubleshooting</a>  </li>
     <li><a href="../../query/indexing.html" title="Indexing"><span class="none"></span>Indexing</a>  </li>
     <li><a href="../../query/lucene.html" title="Lucene Index"><span class="none"></span>Lucene Index</a>  </li>
     <li><a href="../../query/property-index.html" title="Property Index"><span class="none"></span>Property Index</a>  </li>
@@ -322,7 +324,7 @@
 <h6><a name="Example_TokenConfiguration"></a>Example TokenConfiguration</h6>
 
 <div class="source">
-<div class="source"><pre class="prettyprint linenums">@Component()
+<div class="source"><pre class="prettyprint">@Component()
 @Service({TokenConfiguration.class, SecurityConfiguration.class})
 public class MyTokenConfiguration extends ConfigurationBase implements TokenConfiguration {
 



Mime
View raw message