lucene-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ctarg...@apache.org
Subject lucene-solr:master: Ref Guide: Add info about available back-compat to IndexUpgrader Tool page
Date Tue, 24 Oct 2017 13:54:32 GMT
Repository: lucene-solr
Updated Branches:
  refs/heads/master f821673ff -> 055aa3f95


Ref Guide: Add info about available back-compat to IndexUpgrader Tool page


Project: http://git-wip-us.apache.org/repos/asf/lucene-solr/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucene-solr/commit/055aa3f9
Tree: http://git-wip-us.apache.org/repos/asf/lucene-solr/tree/055aa3f9
Diff: http://git-wip-us.apache.org/repos/asf/lucene-solr/diff/055aa3f9

Branch: refs/heads/master
Commit: 055aa3f95eb95b295f1ab11991e5912f7be98325
Parents: f821673
Author: Cassandra Targett <ctargett@apache.org>
Authored: Tue Oct 24 08:52:43 2017 -0500
Committer: Cassandra Targett <ctargett@apache.org>
Committed: Tue Oct 24 08:53:14 2017 -0500

----------------------------------------------------------------------
 solr/solr-ref-guide/src/indexupgrader-tool.adoc | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/055aa3f9/solr/solr-ref-guide/src/indexupgrader-tool.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/indexupgrader-tool.adoc b/solr/solr-ref-guide/src/indexupgrader-tool.adoc
index 48683a2..a505b35 100644
--- a/solr/solr-ref-guide/src/indexupgrader-tool.adoc
+++ b/solr/solr-ref-guide/src/indexupgrader-tool.adoc
@@ -22,11 +22,20 @@ The Lucene distribution includes {lucene-javadocs}/core/org/apache/lucene/index/
 
 The tool can be used from command line, or it can be instantiated and executed in Java.
 
+[IMPORTANT]
+====
+Indexes can *only* be upgraded from the previous major release version to the current major
release version.
+
+This means that the IndexUpgrader Tool in any Solr 7.x release, for example, can only work
with indexes from 6.x releases, but cannot work with indexes from Solr 5.x or earlier.
+
+If you are currently using an earlier release such as 5.x and want to move more than one
major version ahead, you need to first upgrade your indexes to the next major version (6.x),
then again to the major version after that (7.x), etc.
+====
+
 In a Solr distribution, the Lucene files are located in `./server/solr-webapp/webapp/WEB-INF/lib`.
You will need to include the `lucene-core-<version>.jar` and `lucene-backwards-codecs-<version>.jar`
on the classpath when running the tool.
 
-[source,bash]
+[source,bash,subs="attributes"]
 ----
-java -cp lucene-core-6.0.0.jar:lucene-backward-codecs-6.0.0.jar org.apache.lucene.index.IndexUpgrader
[-delete-prior-commits] [-verbose] /path/to/index
+java -cp lucene-core-{solr-docs-version}.0.jar:lucene-backward-codecs-{solr-docs-version}.0.jar
org.apache.lucene.index.IndexUpgrader [-delete-prior-commits] [-verbose] /path/to/index
 ----
 
 This tool keeps only the last commit in an index. For this reason, if the incoming index
has more than one commit, the tool refuses to run by default. Specify `-delete-prior-commits`
to override this, allowing the tool to delete all but the last commit.
@@ -35,5 +44,5 @@ Upgrading large indexes may take a long time. As a rule of thumb, the upgrade
pr
 
 [WARNING]
 ====
-This tool may reorder documents if the index was partially upgraded before execution (e.g.,
documents were added). If your application relies on monotonicity of document IDs (which means
that the order in which the documents were added to the index is preserved), do a full forceMerge
instead.
+This tool may reorder documents if the index was partially upgraded before execution (e.g.,
documents were added). If your application relies on monotonicity of document IDs (i.e., the
order in which the documents were added to the index is preserved), do a full forceMerge instead.
 ====


Mime
View raw message