You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by er...@apache.org on 2018/02/19 21:10:02 UTC
lucene-solr:branch_7x: SOLR-11964: SOLR-11874: Docs for ulimits
(system) and queryAnalyzerFieldType (spellcheck)
Repository: lucene-solr
Updated Branches:
refs/heads/branch_7x 539225eff -> aac11fc12
SOLR-11964: SOLR-11874: Docs for ulimits (system) and queryAnalyzerFieldType (spellcheck)
(cherry picked from commit be7a811)
Project: http://git-wip-us.apache.org/repos/asf/lucene-solr/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucene-solr/commit/aac11fc1
Tree: http://git-wip-us.apache.org/repos/asf/lucene-solr/tree/aac11fc1
Diff: http://git-wip-us.apache.org/repos/asf/lucene-solr/diff/aac11fc1
Branch: refs/heads/branch_7x
Commit: aac11fc1209e7afeee49b112630ec421000e9195
Parents: 539225e
Author: Erick Erickson <er...@apache.org>
Authored: Mon Feb 19 13:07:53 2018 -0800
Committer: Erick Erickson <er...@apache.org>
Committed: Mon Feb 19 13:09:52 2018 -0800
----------------------------------------------------------------------
solr/solr-ref-guide/src/spell-checking.adoc | 3 +++
.../src/taking-solr-to-production.adoc | 15 +++++++++++++++
2 files changed, 18 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/aac11fc1/solr/solr-ref-guide/src/spell-checking.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/spell-checking.adoc b/solr/solr-ref-guide/src/spell-checking.adoc
index 26ec194..9936ece 100644
--- a/solr/solr-ref-guide/src/spell-checking.adoc
+++ b/solr/solr-ref-guide/src/spell-checking.adoc
@@ -191,6 +191,9 @@ If set to `true`, this parameter reloads the spellchecker. The results depend on
`spellcheck.count`::
This parameter specifies the maximum number of suggestions that the spellchecker should return for a term. If this parameter isn't set, the value defaults to `1`. If the parameter is set but not assigned a number, the value defaults to `5`. If the parameter is set to a positive integer, that number becomes the maximum number of suggestions returned by the spellchecker.
+`spellcheck.queryAnalyzerFieldtype`::
+This field type's analyzer is used by the QueryConverter to tokenize the value for "q" parameter. The field specified by this parameter should do minimal transformations, it's usually a best practice to avoid types that aggressively stem or ngram for instance.
+
`spellcheck.onlyMorePopular`::
If `true`, Solr will return suggestions that result in more hits for the query than the existing query. Note that this will return more popular suggestions even when the given query term is present in the index and considered "correct".
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/aac11fc1/solr/solr-ref-guide/src/taking-solr-to-production.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/taking-solr-to-production.adoc b/solr/solr-ref-guide/src/taking-solr-to-production.adoc
index 7097526..ca0f4eb 100644
--- a/solr/solr-ref-guide/src/taking-solr-to-production.adoc
+++ b/solr/solr-ref-guide/src/taking-solr-to-production.adoc
@@ -246,6 +246,21 @@ The `bin/solr` script simply passes options starting with `-D` on to the JVM dur
SOLR_OPTS="$SOLR_OPTS -Dsolr.autoSoftCommit.maxTime=10000"
----
+=== File Handles and Processes (ulimit settings)
+
+Two common settings that result in errors on *nix systems are file handles and user processes. It is common for the default limits for number of processes and file handles to default to values that are too low for a large Solr installation. The required number of each of these will increase based on a combination of the number of replicas hosted per node and the number of segments in the index for each replica. The usual recommendation is to make processes and file handles at least 65,000 each, unlimited if possible. On most *nix systems, this command:
+
+[source,bash]
+----
+ulimit -a
+----
+will show the currently-defined limits. It is strongly recommended that file handle and process limits be permanently raised as above. The exact form of the command will vary per operating system, and some systems require editing configuration files and restarting your server. Consult your system administrators for guidance in your particular environment.
+
+[TIP]
+====
+If these limits are exceeded, the problems reported by Solr vary depending on the specific operation responsible for exceeding the limit. Errors such as to "too many open files", "connection error", and "max processes exceeded" have been reported, as well as SolrCloud recovery failures. Since exceeding these limits can result in such varied symptoms it is _strongly_ recommended that these limits be permanently raised as recommended above.
+====
+
== Running Multiple Solr Nodes Per Host
The `bin/solr` script is capable of running multiple instances on one machine, but for a *typical* installation, this is not a recommended setup. Extra CPU and memory resources are required for each additional instance. A single instance is easily capable of handling multiple indexes.