From 4c7b7c0063b2fd194d24444037fd769c2b0e5fcf Mon Sep 17 00:00:00 2001 From: Cassandra Targett Date: Fri, 8 Jun 2018 14:38:31 -0500 Subject: [PATCH] SOLR-4793: Ref Guide: shorten the section heading & fix refs --- solr/solr-ref-guide/src/learning-to-rank.adoc | 2 +- .../src/setting-up-an-external-zookeeper-ensemble.adoc | 8 +++++--- solr/solr-ref-guide/src/update-request-processors.adoc | 2 +- 3 files changed, 7 insertions(+), 5 deletions(-) diff --git a/solr/solr-ref-guide/src/learning-to-rank.adoc b/solr/solr-ref-guide/src/learning-to-rank.adoc index 938fd448ecf..c85f6c60915 100644 --- a/solr/solr-ref-guide/src/learning-to-rank.adoc +++ b/solr/solr-ref-guide/src/learning-to-rank.adoc @@ -560,7 +560,7 @@ NOTE: No `"features"` are configured in `myWrapperModel` because the features of CAUTION: `` doesn't work as expected in this case, because `SolrResourceLoader` considers given resources as JAR if `` indicates files. -As an alternative to the above-described `DefaultWrapperModel`, it is possible to <>. +As an alternative to the above-described `DefaultWrapperModel`, it is possible to <>. === Applying Changes diff --git a/solr/solr-ref-guide/src/setting-up-an-external-zookeeper-ensemble.adoc b/solr/solr-ref-guide/src/setting-up-an-external-zookeeper-ensemble.adoc index 3192e08c6ef..b292e1ae4a0 100644 --- a/solr/solr-ref-guide/src/setting-up-an-external-zookeeper-ensemble.adoc +++ b/solr/solr-ref-guide/src/setting-up-an-external-zookeeper-ensemble.adoc @@ -349,13 +349,13 @@ set ZK_HOST=zk1:2181,zk2:2181,zk3:2181/solr Now you will not have to enter the connection string when starting Solr. -== Increasing ZooKeeper's 1MB File Size Limit +== Increasing the File Size Limit ZooKeeper is designed to hold small files, on the order of kilobytes. By default, ZooKeeper's file size limit is 1MB. Attempting to write or read files larger than this will cause errors. Some Solr features, e.g., text analysis synonyms, LTR, and OpenNLP named entity recognition, require configuration resources that can be larger than the default limit. ZooKeeper can be configured, via Java system property https://zookeeper.apache.org/doc/r{ivy-zookeeper-version}/zookeeperAdmin.html#Unsafe+Options[`jute.maxbuffer`], to increase this limit. Note that this configuration, which is required both for ZooKeeper server(s) and for all clients that connect to the server(s), must be the same everywhere it is specified. -=== Configuring jute.maxbuffer on ZooKeeper nodes +=== Configuring jute.maxbuffer on ZooKeeper Nodes `jute.maxbuffer` must be configured on each external ZooKeeper node. This can be achieved in any of the following ways; note though that only the first option works on Windows: @@ -372,7 +372,7 @@ JVMFLAGS="$JVMFLAGS -Djute.maxbuffer=50000000" [source,properties] JVMFLAGS="$JVMFLAGS -Djute.maxbuffer=5000000" -=== Configuring jute.maxbuffer for ZooKeeper clients +=== Configuring jute.maxbuffer for ZooKeeper Clients The `bin/solr` script invokes Java programs that act as ZooKeeper clients. When you use Solr's bundled ZooKeeper server instead of setting up an external ZooKeeper ensemble, the configuration described below will also configure the ZooKeeper server. @@ -415,7 +415,9 @@ REM -a option on start script, those options will be appended as well. Examples: Add the following line to increase the file size limit to 2MB: [source,bat] +---- set SOLR_OPTS=%SOLR_OPTS% -Djute.maxbuffer=0x200000 +---- ==== -- diff --git a/solr/solr-ref-guide/src/update-request-processors.adoc b/solr/solr-ref-guide/src/update-request-processors.adoc index cf76d3bbe9d..c73eb6a8271 100644 --- a/solr/solr-ref-guide/src/update-request-processors.adoc +++ b/solr/solr-ref-guide/src/update-request-processors.adoc @@ -357,7 +357,7 @@ The {solr-javadocs}/solr-uima/index.html[`uima`] contrib provides:: The {solr-javadocs}/solr-analysis-extras/index.html[`analysis-extras`] contrib provides:: -{solr-javadocs}/solr-analysis-extras/org/apache/solr/update/processor/OpenNLPExtractNamedEntitiesUpdateProcessorFactory.html[OpenNLPExtractNamedEntitiesUpdateProcessorFactory]::: Update document(s) to be indexed with named entities extracted using an OpenNLP NER model. Note that in order to use model files larger than 1MB on SolrCloud, <>. +{solr-javadocs}/solr-analysis-extras/org/apache/solr/update/processor/OpenNLPExtractNamedEntitiesUpdateProcessorFactory.html[OpenNLPExtractNamedEntitiesUpdateProcessorFactory]::: Update document(s) to be indexed with named entities extracted using an OpenNLP NER model. Note that in order to use model files larger than 1MB on SolrCloud, <>. === Update Processor Factories You Should _Not_ Modify or Remove