You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by th...@apache.org on 2017/03/30 12:44:03 UTC
svn commit: r1789517 - /jackrabbit/site/live/oak/docs/query/indexing.html
Author: thomasm
Date: Thu Mar 30 12:44:03 2017
New Revision: 1789517
URL: http://svn.apache.org/viewvc?rev=1789517&view=rev
Log:
OAK-936: Site checkin for project Oak Documentation-1.8-SNAPSHOT
Modified:
jackrabbit/site/live/oak/docs/query/indexing.html
Modified: jackrabbit/site/live/oak/docs/query/indexing.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/query/indexing.html?rev=1789517&r1=1789516&r2=1789517&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/query/indexing.html (original)
+++ jackrabbit/site/live/oak/docs/query/indexing.html Thu Mar 30 12:44:03 2017
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2017-03-29
+ | Generated by Apache Maven Doxia at 2017-03-30
| 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="20170329" />
+ <meta name="Date-Revision-yyyymmdd" content="20170330" />
<meta http-equiv="Content-Language" content="en" />
<title>Jackrabbit Oak - Indexing</title>
<link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
@@ -230,7 +230,7 @@
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2017-03-29</li>
+ <li id="publishDate">Last Published: 2017-03-30</li>
<li class="divider">|</li> <li id="projectVersion">Version: 1.8-SNAPSHOT</li>
@@ -986,11 +986,13 @@ Removing corrupt flag from index [/oak:i
<li>B: Prior to Oak 1.6, in case a <i>Lucene</i> index definition was changed (same as A). In Oak 1.6 and newer, queries will use the old index definition until the index is <a href="lucene.html#stored-index-definition">reindexed</a>.</li>
-<li>C: Prior to Oak 1.6, in case the query engine picks a very slow index for some queries because the counter index <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-4065">got out of sync after adding and removing lots of nodes many times</a>. For this case, it is recommended to verify the contents of the counter index first, and upgrade Oak before reindexing. Only the <tt>counter</tt> index needs to be reindexed in this case. The workaround (to avoid reindexing) is to manually tweak index configurations using manually set <tt>entryCount</tt> in the index configuration.</li>
+<li>C: Prior to Oak 1.6, in case the query engine picks a very slow index for some queries because the counter index (<tt>/oak:index/counter</tt>) <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-4065">got out of sync after adding and removing lots of nodes many times</a>. For this case, it is recommended to verify the contents of the counter index first, and upgrade Oak before reindexing. To view the content, use the NodeCounter JMX bean and run <tt>getEstimatedChildNodeCounts</tt> with p1 = <tt>/</tt> and p2 = <tt>2</tt>. If there is a problem, then the estimated node count of root node typically is very low, more than 10 times lower than the sum of its children. Only the <tt>counter</tt> index needs to be reindexed in this case. The workaround (to avoid reindexing) is to manually tweak index configurations using manually set <tt>entryCount</tt> of the index that should be used to a low value (as high as possible so that the index is still needed
), for example to 100 or 1000.</li>
-<li>D: In case a binary of a Lucene index is missing, for example because the binary is not available in the datastore. This can happen in case the datastore is misconfigured such that garbage collection removed a binary that is still required. In such cases, other binaries might be missing as well; it is best to traverse all nodes of the repository to ensure this is not the case.</li>
+<li>D: In case a binary of a Lucene index (a Lucene index file) is missing, for example because the binary is not available in the datastore. This can happen in case the datastore is misconfigured such that garbage collection removed a binary that is still required. In such cases, other binaries might be missing as well; it is best to traverse all nodes of the repository to ensure this is not the case.</li>
-<li>E: In case a binary of a Lucene index is corrupt. If the index is corrupt, an <tt>AsyncIndexUpdate</tt> run will fail with an exception pointing to the index being corrupt. In such a case, first verify that the following procedure doesn’t resolve the issue: stop Oak, remove the local copy of the Lucene index (directory <tt>index</tt>), and restart. If the index is still corrupt after this, then reindexing is needed. In such cases, please file an Oak issue.</li>
+<li>E: In case a binary of a Lucene index (a Lucene index file) is corrupt. If the index is corrupt, an <tt>AsyncIndexUpdate</tt> run will fail with an exception saying a Lucene index file is corrupt. In such a case, first verify that the following procedure doesn’t resolve the issue: stop Oak, remove the local copy of the Lucene index (directory <tt>index</tt>), and restart. If the index is still corrupt after this, then reindexing is needed. In such cases, please file an Oak issue.</li>
+
+<li>F: Prior to Oak 1.2.24 / 1.4.13 / 1.6.1, when using the document store (MongoDB or RDBMK) in combination with a large transaction (a commit that changed or added many thousand nodes), and if one of the parent nodes had more than 100 child nodes, then indexes (all types) <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-5557">did not see those changes in some cases</a>.</li>
</ul>
<p>To reindex, set the <tt>reindex</tt> property to <tt>true</tt> in the respective index definition:</p>