You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by ct...@apache.org on 2020/07/15 16:52:39 UTC
svn commit: r1063067 [28/28] - in
/websites/production/lucene/content/solr/guide/8_6: ./ meta-docs/
Modified: websites/production/lucene/content/solr/guide/8_6/using-the-solr-administration-user-interface.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/using-the-solr-administration-user-interface.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/using-the-solr-administration-user-interface.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Using the Solr Administration User Interface | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Using the Solr Administration User Interface | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="using-the-solr-administration-user-interface">
+<body class="" id="using-the-solr-administration-user-interface">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1658,7 +1653,7 @@
<section class="content">
<p>This section discusses the Solr Administration User Interface ("Admin UI").</p>
<p>The <a href="overview-of-the-solr-admin-ui.html#overview-of-the-solr-admin-ui">Overview of the Solr Admin UI</a> explains the basic features of the user interface, what’s on the initial Admin UI page, and how to configure the interface. In addition, there are pages describing each screen of the Admin UI:</p>
-<div class="ulist"><ul><li><strong><a href="logging.html#logging">Logging</a></strong> shows recent messages logged by this Solr node and provides a way to change logging levels for specific classes.</li><li><strong><a href="cloud-screens.html#cloud-screens">Cloud Screens</a></strong> display information about nodes when running in SolrCloud mode.</li><li><strong><a href="collections-core-admin.html#collections-core-admin">Collections / Core Admin</a></strong> explains how to get management information about each core.</li><li><strong><a href="java-properties.html#java-properties">Java Properties</a></strong> shows the Java information about each core.</li><li><strong><a href="thread-dump.html#thread-dump">Thread Dump</a></strong> lets you see detailed information about each thread, along with state information.</li><li><strong><a href="suggestions-screen.html#suggestions-screen">Suggestions Screen</a></strong> displays the state of the system with regard to the autoscaling policies
that are in place.</li><li><strong><a href="collection-specific-tools.html#collection-specific-tools">Collection-Specific Tools</a></strong> is a section explaining additional screens available for each collection.<ul><li><a href="analysis-screen.html#analysis-screen">Analysis</a> - lets you analyze the data found in specific fields.</li><li><a href="dataimport-screen.html#dataimport-screen">Dataimport</a> - shows you information about the current status of the Data Import Handler.</li><li><a href="documents-screen.html#documents-screen">Documents</a> - provides a simple form allowing you to execute various Solr indexing commands directly from the browser.</li><li><a href="files-screen.html#files-screen">Files</a> - shows the current core configuration files such as <code>solrconfig.xml</code>.</li><li><a href="query-screen.html#query-screen">Query</a> - lets you submit a structured query about various elements of a core.</li><li><a href="stream-screen.html#stream-screen">Stream</a
> - allows you to submit streaming expressions and see results and parsing explanations.</li><li><a href="schema-browser-screen.html#schema-browser-screen">Schema Browser</a> - displays schema data in a browser window.</li></ul></li><li><strong><a href="core-specific-tools.html#core-specific-tools">Core-Specific Tools</a></strong> is a section explaining additional screens available for each named core.<ul><li><a href="ping.html#ping">Ping</a> - lets you ping a named core and determine whether the core is active.</li><li><a href="plugins-stats-screen.html#plugins-stats-screen">Plugins/Stats</a> - shows statistics for plugins and other installed components.</li><li><a href="replication-screen.html#replication-screen">Replication</a> - shows you the current replication status for the core, and lets you enable/disable replication.</li><li><a href="segments-info.html#segments-info">Segments Info</a> - Provides a visualization of the underlying Lucene index segments.</li></ul></li></ul><
/div>
+<div class="ulist"><ul><li><p><strong><a href="logging.html#logging">Logging</a></strong> shows recent messages logged by this Solr node and provides a way to change logging levels for specific classes.</p></li><li><p><strong><a href="cloud-screens.html#cloud-screens">Cloud Screens</a></strong> display information about nodes when running in SolrCloud mode.</p></li><li><p><strong><a href="collections-core-admin.html#collections-core-admin">Collections / Core Admin</a></strong> explains how to get management information about each core.</p></li><li><p><strong><a href="java-properties.html#java-properties">Java Properties</a></strong> shows the Java information about each core.</p></li><li><p><strong><a href="thread-dump.html#thread-dump">Thread Dump</a></strong> lets you see detailed information about each thread, along with state information.</p></li><li><p><strong><a href="suggestions-screen.html#suggestions-screen">Suggestions Screen</a></strong> displays the state of the system w
ith regard to the autoscaling policies that are in place.</p></li><li><p><strong><a href="collection-specific-tools.html#collection-specific-tools">Collection-Specific Tools</a></strong> is a section explaining additional screens available for each collection.<ul><li><p><a href="analysis-screen.html#analysis-screen">Analysis</a> - lets you analyze the data found in specific fields.</p></li><li><p><a href="dataimport-screen.html#dataimport-screen">Dataimport</a> - shows you information about the current status of the Data Import Handler.</p></li><li><p><a href="documents-screen.html#documents-screen">Documents</a> - provides a simple form allowing you to execute various Solr indexing commands directly from the browser.</p></li><li><p><a href="files-screen.html#files-screen">Files</a> - shows the current core configuration files such as <code>solrconfig.xml</code>.</p></li><li><p><a href="query-screen.html#query-screen">Query</a> - lets you submit a structured query about various elem
ents of a core.</p></li><li><p><a href="stream-screen.html#stream-screen">Stream</a> - allows you to submit streaming expressions and see results and parsing explanations.</p></li><li><p><a href="schema-browser-screen.html#schema-browser-screen">Schema Browser</a> - displays schema data in a browser window.</p></li></ul></p></li><li><p><strong><a href="core-specific-tools.html#core-specific-tools">Core-Specific Tools</a></strong> is a section explaining additional screens available for each named core.<ul><li><p><a href="ping.html#ping">Ping</a> - lets you ping a named core and determine whether the core is active.</p></li><li><p><a href="plugins-stats-screen.html#plugins-stats-screen">Plugins/Stats</a> - shows statistics for plugins and other installed components.</p></li><li><p><a href="replication-screen.html#replication-screen">Replication</a> - shows you the current replication status for the core, and lets you enable/disable replication.</p></li><li><p><a href="segments-info.h
tml#segments-info">Segments Info</a> - Provides a visualization of the underlying Lucene index segments.</p></li></ul></p></li></ul></div>
</section>
@@ -1688,7 +1683,7 @@
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/using-zookeeper-to-manage-configuration-files.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/using-zookeeper-to-manage-configuration-files.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/using-zookeeper-to-manage-configuration-files.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Using ZooKeeper to Manage Configuration Files | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Using ZooKeeper to Manage Configuration Files | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="using-zookeeper-to-manage-configuration-files">
+<body class="" id="using-zookeeper-to-manage-configuration-files">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1663,7 +1658,7 @@
<section class="content">
<section id="preamble" aria-label="Preamble"><p>With SolrCloud your configuration files are kept in ZooKeeper.</p>
<p>These files are uploaded in either of the following cases:</p>
-<div class="ulist"><ul><li>When you start a SolrCloud example using the <code>bin/solr</code> script.</li><li>When you create a collection using the <code>bin/solr</code> script.</li><li>Explicitly upload a configuration set to ZooKeeper.</li></ul></div></section>
+<div class="ulist"><ul><li><p>When you start a SolrCloud example using the <code>bin/solr</code> script.</p></li><li><p>When you create a collection using the <code>bin/solr</code> script.</p></li><li><p>Explicitly upload a configuration set to ZooKeeper.</p></li></ul></div></section>
<section class="sect1"><h2 id="startup-bootstrap">Startup Bootstrap</h2><p>When you try SolrCloud for the first time using the <code>bin/solr -e cloud</code>, the related configset gets uploaded to ZooKeeper automatically and is linked with the newly created collection.</p>
<p>The below command would start SolrCloud with the default collection name (gettingstarted) and default configset (_default) uploaded and linked to it.</p>
<div class="listingblock"><pre class="rouge highlight"><code class="language-bash" data-lang="bash"><pre class="highlight"><code>bin/solr -e cloud -noprompt</code></pre></code></pre></div>
@@ -1739,7 +1734,7 @@ If you have defined <code>ZK_HOST</code>
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/v2-api.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/v2-api.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/v2-api.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>v2 API | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>v2 API | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="v2-api">
+<body class="" id="v2-api">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1698,7 +1693,7 @@
</span><span style="color: #000080">"availableSubPaths"</span><span style="background-color: #f8f8f8">:{}</span><span style="color: #bbbbbb">
</span><span style="background-color: #f8f8f8">}</span></code></pre></code></pre></div>
<p>Description of some of the keys in the above example:</p>
-<div class="ulist"><ul><li><code><strong>documentation</strong></code>: URL to the online Solr reference guide section for this API</li><li><code><strong>description</strong></code>: A text description of the feature/variable/command, etc.</li><li><code><strong>spec/methods</strong></code>: HTTP methods supported by this API</li><li><code><strong>spec/url/paths</strong></code>: URL paths supported by this API</li><li><code><strong>spec/url/params</strong></code>: List of supported URL request params</li><li><code><strong>availableSubPaths</strong></code>: List of valid URL subpaths and the HTTP method(s) each supports</li></ul></div>
+<div class="ulist"><ul><li><p><code><strong>documentation</strong></code>: URL to the online Solr reference guide section for this API</p></li><li><p><code><strong>description</strong></code>: A text description of the feature/variable/command, etc.</p></li><li><p><code><strong>spec/methods</strong></code>: HTTP methods supported by this API</p></li><li><p><code><strong>spec/url/paths</strong></code>: URL paths supported by this API</p></li><li><p><code><strong>spec/url/params</strong></code>: List of supported URL request params</p></li><li><p><code><strong>availableSubPaths</strong></code>: List of valid URL subpaths and the HTTP method(s) each supports</p></li></ul></div>
<p>Example of introspect for a POST API: <code>http://localhost:8983/api/c/gettingstarted/_introspect?method=POST&command=modify</code></p>
<div class="listingblock"><pre class="rouge highlight"><code class="language-json" data-lang="json"><pre class="highlight"><code><span style="background-color: #f8f8f8">{</span><span style="color: #bbbbbb">
</span><span style="color: #000080">"spec"</span><span style="background-color: #f8f8f8">:[{</span><span style="color: #bbbbbb">
@@ -1784,7 +1779,7 @@
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/variables.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/variables.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/variables.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Variables | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Variables | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="variables">
+<body class="" id="variables">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1892,7 +1887,7 @@ and returns the object that was removed.
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/vector-math.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/vector-math.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/vector-math.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Vector Math | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Vector Math | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="vector-math">
+<body class="" id="vector-math">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1940,7 +1935,7 @@ is a measure only of angle.</p>
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/vectorization.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/vectorization.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/vectorization.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Streams and Vectorization | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Streams and Vectorization | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="vectorization">
+<body class="" id="vectorization">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1673,37 +1668,37 @@ vectorize text fields.</p></section>
retrieve data from Solr Cloud collections. Math expressions can be used
to vectorize and analyze the results sets.</p>
<p>Below are some of the key stream sources:</p>
-<div class="ulist"><ul><li><strong><code>facet</code></strong>: Multi-dimensional aggregations are a powerful tool for generating
+<div class="ulist"><ul><li><p><strong><code>facet</code></strong>: Multi-dimensional aggregations are a powerful tool for generating
co-occurrence counts for categorical data. The <code>facet</code> function uses the JSON facet API
under the covers to provide fast, distributed, multi-dimension aggregations. With math expressions
the aggregated results can be pivoted into a co-occurance matrix which can be mined for
-correlations and hidden similarities within the data.</li><li><strong><code>random</code></strong>: Random sampling is widely used in statistics, probability and machine learning.
+correlations and hidden similarities within the data.</p></li><li><p><strong><code>random</code></strong>: Random sampling is widely used in statistics, probability and machine learning.
The <code>random</code> function returns a random sample of search results that match a
query. The random samples can be vectorized and operated on by math expressions and the results
-can be used to describe and make inferences about the entire population.</li><li><strong><code>timeseries</code></strong>: The <code>timeseries</code>
+can be used to describe and make inferences about the entire population.</p></li><li><p><strong><code>timeseries</code></strong>: The <code>timeseries</code>
expression provides fast distributed time series aggregations, which can be
-vectorized and analyzed with math expressions.</li><li><strong><code>knnSearch</code></strong>: K-nearest neighbor is a core machine learning algorithm. The <code>knnSearch</code>
+vectorized and analyzed with math expressions.</p></li><li><p><strong><code>knnSearch</code></strong>: K-nearest neighbor is a core machine learning algorithm. The <code>knnSearch</code>
function is a specialized knn algorithm optimized to find the k-nearest neighbors of a document in
a distributed index. Once the nearest neighbors are retrieved they can be vectorized
-and operated on by machine learning and text mining algorithms.</li><li><strong><code>sql</code></strong>: SQL is the primary query language used by data scientists. The <code>sql</code> function supports
+and operated on by machine learning and text mining algorithms.</p></li><li><p><strong><code>sql</code></strong>: SQL is the primary query language used by data scientists. The <code>sql</code> function supports
data retrieval using a subset of SQL which includes both full text search and
fast distributed aggregations. The result sets can then be vectorized and operated
-on by math expressions.</li><li><strong><code>jdbc</code></strong>: The <code>jdbc</code> function allows data from any JDBC compliant data source to be combined with
+on by math expressions.</p></li><li><p><strong><code>jdbc</code></strong>: The <code>jdbc</code> function allows data from any JDBC compliant data source to be combined with
streams originating from Solr. Result sets from outside data sources can be vectorized and operated
-on by math expressions in the same manner as result sets originating from Solr.</li><li><strong><code>topic</code></strong>: Messaging is an important foundational technology for large scale computing. The <code>topic</code>
+on by math expressions in the same manner as result sets originating from Solr.</p></li><li><p><strong><code>topic</code></strong>: Messaging is an important foundational technology for large scale computing. The <code>topic</code>
function provides publish/subscribe messaging capabilities by treating
Solr Cloud as a distributed message queue. Topics are extremely powerful
because they allow subscription by query. Topics can be use to support a broad set of
-use cases including bulk text mining operations and AI alerting.</li><li><strong><code>nodes</code></strong>: Graph queries are frequently used by recommendation engines and are an important
+use cases including bulk text mining operations and AI alerting.</p></li><li><p><strong><code>nodes</code></strong>: Graph queries are frequently used by recommendation engines and are an important
machine learning tool. The <code>nodes</code> function provides fast, distributed, breadth
first graph traversal over documents in a Solr Cloud collection. The node sets collected
by the <code>nodes</code> function can be operated on by statistical and machine learning expressions to
-gain more insight into the graph.</li><li><strong><code>search</code></strong>: Ranked search results are a powerful tool for finding the most relevant
+gain more insight into the graph.</p></li><li><p><strong><code>search</code></strong>: Ranked search results are a powerful tool for finding the most relevant
documents from a large document corpus. The <code>search</code> expression
returns the top N ranked search results that match any
Solr query, including geo-spatial queries. The smaller set of relevant
documents can then be explored with statistical, machine learning and
-text mining expressions to gather insights about the data set.</li></ul></div></section>
+text mining expressions to gather insights about the data set.</p></li></ul></div></section>
<section class="sect1"><h2 id="assigning-streams-to-variables">Assigning Streams to Variables</h2><p>The output of any streaming expression can be set to a variable.
Below is a very simple example using the <code>random</code> function to fetch
three random samples from collection1. The random samples are returned
@@ -1959,7 +1954,7 @@ vectors from.</p>
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/velocity-response-writer.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/velocity-response-writer.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/velocity-response-writer.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Velocity Response Writer | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Velocity Response Writer | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="velocity-response-writer">
+<body class="" id="velocity-response-writer">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1729,7 +1724,7 @@ is specified those templates are rendera
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/velocity-search-ui.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/velocity-search-ui.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/velocity-search-ui.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Velocity Search UI | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Velocity Search UI | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="velocity-search-ui">
+<body class="" id="velocity-search-ui">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1690,7 +1685,7 @@
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/working-with-currencies-and-exchange-rates.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/working-with-currencies-and-exchange-rates.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/working-with-currencies-and-exchange-rates.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Working with Currencies and Exchange Rates | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Working with Currencies and Exchange Rates | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="working-with-currencies-and-exchange-rates">
+<body class="" id="working-with-currencies-and-exchange-rates">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1669,7 +1664,7 @@
<section class="content">
<section id="preamble" aria-label="Preamble"><p>The <code>currency</code> FieldType provides support for monetary values to Solr/Lucene with query-time currency conversion and exchange rates. The following features are supported:</p>
-<div class="ulist"><ul><li>Point queries</li><li>Range queries</li><li>Function range queries</li><li>Sorting</li><li>Currency parsing by either currency code or symbol</li><li>Symmetric & asymmetric exchange rates (asymmetric exchange rates are useful if there are fees associated with exchanging the currency)</li><li>Range faceting (using either <code>facet.range</code> or <code>type:range</code> in <code>json.facet</code>) as long as the <code>start</code> and <code>end</code> values are specified in the same Currency.</li></ul></div></section>
+<div class="ulist"><ul><li><p>Point queries</p></li><li><p>Range queries</p></li><li><p>Function range queries</p></li><li><p>Sorting</p></li><li><p>Currency parsing by either currency code or symbol</p></li><li><p>Symmetric & asymmetric exchange rates (asymmetric exchange rates are useful if there are fees associated with exchanging the currency)</p></li><li><p>Range faceting (using either <code>facet.range</code> or <code>type:range</code> in <code>json.facet</code>) as long as the <code>start</code> and <code>end</code> values are specified in the same Currency.</p></li></ul></div></section>
<section class="sect1"><h2 id="configuring-currencies">Configuring Currencies</h2><div class="admonitionblock warning">
<table>
<tr>
@@ -1768,7 +1763,7 @@
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/working-with-dates.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/working-with-dates.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/working-with-dates.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Working with Dates | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Working with Dates | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="working-with-dates">
+<body class="" id="working-with-dates">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1671,11 +1666,11 @@
<section class="content">
<section class="sect1"><h2 id="date-formatting">Date Formatting</h2><p>Solr’s date fields (<code>DatePointField</code>, <code>DateRangeField</code> and the deprecated <code>TrieDateField</code>) represent "dates" as a point in time with millisecond precision. The format used is a restricted form of the canonical representation of dateTime in the <a href="http://www.w3.org/TR/xmlschema-2/#dateTime">XML Schema specification</a> â a restricted subset of <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO-8601</a>. For those familiar with Java date handling, Solr uses <a href="https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#ISO_INSTANT">DateTimeFormatter.ISO_INSTANT</a> for formatting, and parsing too with "leniency".</p>
<p><code>YYYY-MM-DDThh:mm:ssZ</code></p>
-<div class="ulist"><ul><li><code>YYYY</code> is the year.</li><li><code>MM</code> is the month.</li><li><code>DD</code> is the day of the month.</li><li><code>hh</code> is the hour of the day as on a 24-hour clock.</li><li><code>mm</code> is minutes.</li><li><code>ss</code> is seconds.</li><li><code>Z</code> is a literal 'Z' character indicating that this string representation of the date is in UTC</li></ul></div>
+<div class="ulist"><ul><li><p><code>YYYY</code> is the year.</p></li><li><p><code>MM</code> is the month.</p></li><li><p><code>DD</code> is the day of the month.</p></li><li><p><code>hh</code> is the hour of the day as on a 24-hour clock.</p></li><li><p><code>mm</code> is minutes.</p></li><li><p><code>ss</code> is seconds.</p></li><li><p><code>Z</code> is a literal 'Z' character indicating that this string representation of the date is in UTC</p></li></ul></div>
<p>Note that no time zone can be specified; the String representations of dates is always expressed in Coordinated Universal Time (UTC). Here is an example value:</p>
<p><code>1972-05-20T17:33:18Z</code></p>
<p>You can optionally include fractional seconds if you wish, although any precision beyond milliseconds will be ignored. Here are example values with sub-seconds:</p>
-<div class="ulist"><ul><li><code>1972-05-20T17:33:18.772Z</code></li><li><code>1972-05-20T17:33:18.77Z</code></li><li><code>1972-05-20T17:33:18.7Z</code></li></ul></div>
+<div class="ulist"><ul><li><p><code>1972-05-20T17:33:18.772Z</code></p></li><li><p><code>1972-05-20T17:33:18.77Z</code></p></li><li><p><code>1972-05-20T17:33:18.7Z</code></p></li></ul></div>
<p>There must be a leading <code>'-'</code> for dates prior to year 0000, and Solr will format dates with a leading <code>'+'</code> for years after 9999. Year 0000 is considered year 1 BC; there is no such thing as year 0 AD or BC.</p>
<div class="admonitionblock warning">
<table>
@@ -1696,7 +1691,7 @@
</table>
</div>
<section class="sect2"><h3 id="date-range-formatting">Date Range Formatting</h3><p>Solr’s <code>DateRangeField</code> supports the same point in time date syntax described above (with <em>date math</em> described below) and more to express date ranges. One class of examples is truncated dates, which represent the entire date span to the precision indicated. The other class uses the range syntax (<code>[ TO ]</code>). Here are some examples:</p>
-<div class="ulist"><ul><li><code>2000-11</code> â The entire month of November, 2000.</li><li><code>1605-11-05</code> â The Fifth of November.</li><li><code>2000-11-05T13</code> â Likewise but for an hour of the day (1300 to before 1400, i.e., 1pm to 2pm).</li><li><code>-0009</code> â The year 10 BC. A 0 in the year position is 0 AD, and is also considered 1 BC.</li><li><code>[2000-11-01 TO 2014-12-01]</code> â The specified date range at a day resolution.</li><li><code>[2014 TO 2014-12-01]</code> â From the start of 2014 till the end of the first day of December.</li><li><code>[* TO 2014-12-01]</code> â From the earliest representable time thru till the end of the day on 2014-12-01.</li></ul></div>
+<div class="ulist"><ul><li><p><code>2000-11</code> â The entire month of November, 2000.</p></li><li><p><code>1605-11-05</code> â The Fifth of November.</p></li><li><p><code>2000-11-05T13</code> â Likewise but for an hour of the day (1300 to before 1400, i.e., 1pm to 2pm).</p></li><li><p><code>-0009</code> â The year 10 BC. A 0 in the year position is 0 AD, and is also considered 1 BC.</p></li><li><p><code>[2000-11-01 TO 2014-12-01]</code> â The specified date range at a day resolution.</p></li><li><p><code>[2014 TO 2014-12-01]</code> â From the start of 2014 till the end of the first day of December.</p></li><li><p><code>[* TO 2014-12-01]</code> â From the earliest representable time thru till the end of the day on 2014-12-01.</p></li></ul></div>
<p>Limitations: The range syntax doesn’t support embedded date math. If you specify a date instance supported by DatePointField with date math truncating it, like <code>NOW/DAY</code>, you still get the first millisecond of that day, not the entire day’s range. Exclusive ranges (using <code>{</code> & <code>}</code>) work in <em>queries</em> but not for <em>indexing</em> ranges.</p></section></section>
<section class="sect1"><h2 id="date-math">Date Math</h2><p>Solr’s date field types also supports <em>date math</em> expressions, which makes it easy to create times relative to fixed moments in time, include the current time which can be represented using the special value of “<code>NOW</code>”.</p>
<section class="sect2"><h3 id="date-math-syntax">Date Math Syntax</h3><p>Date math expressions consist either adding some quantity of time in a specified unit, or rounding the current time by a specified unit. expressions can be chained and are evaluated left to right.</p>
@@ -1737,7 +1732,7 @@
...</code></pre></code></pre></div></section></section></section>
<section class="sect1"><h2 id="more-daterangefield-details">More DateRangeField Details</h2><p><code>DateRangeField</code> is almost a drop-in replacement for places where <code>DatePointField</code> is used. The only difference is that Solr’s XML or SolrJ response formats will expose the stored data as a String instead of a Date. The underlying index data for this field will be a bit larger. Queries that align to units of time a second on up should be faster than TrieDateField, especially if it’s in UTC.</p>
<p>The main point of <code>DateRangeField</code>, as its name suggests, is to allow indexing date ranges. To do that, simply supply strings in the format shown above. It also supports specifying 3 different relational predicates between the indexed data, and the query range:</p>
-<div class="ulist"><ul><li><code>Intersects</code> (default)</li><li><code>Contains</code></li><li><code>Within</code></li></ul></div>
+<div class="ulist"><ul><li><p><code>Intersects</code> (default)</p></li><li><p><code>Contains</code></p></li><li><p><code>Within</code></p></li></ul></div>
<p>You can specify the predicate by querying using the <code>op</code> local-params parameter like so:</p>
<div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>fq={!field f=dateRange op=Contains}[2013 TO 2018]</code></pre></code></pre></div>
<p>Unlike most local parameters, <code>op</code> is actually <em>not</em> defined by any query parser (<code>field</code>), it is defined by the field type, in this case <code>DateRangeField</code>. In the above example, it would find documents with indexed ranges that <em>contain</em> (or equals) the range 2013 thru 2018. Multi-valued overlapping indexed ranges in a document are effectively coalesced.</p>
@@ -1771,7 +1766,7 @@
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/working-with-enum-fields.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/working-with-enum-fields.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/working-with-enum-fields.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Working with Enum Fields | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Working with Enum Fields | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="working-with-enum-fields">
+<body class="" id="working-with-enum-fields">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1742,7 +1737,7 @@
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/working-with-external-files-and-processes.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/working-with-external-files-and-processes.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/working-with-external-files-and-processes.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>Working with External Files and Processes | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>Working with External Files and Processes | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="working-with-external-files-and-processes">
+<body class="" id="working-with-external-files-and-processes">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1709,7 +1704,7 @@ doc40=42</code></pre></code></pre></div>
<span style="color: #000080"><listener</span> <span style="color: #008080">event=</span><span style="color: #d14">"firstSearcher"</span> <span style="color: #008080">class=</span><span style="color: #d14">"org.apache.solr.schema.ExternalFileFieldReloader"</span><span style="color: #000080">/></span></code></pre></code></pre></div></section></section>
<section class="sect1"><h2 id="the-preanalyzedfield-type">The PreAnalyzedField Type</h2><p>The <code>PreAnalyzedField</code> type provides a way to send to Solr serialized token streams, optionally with independent stored values of a field, and have this information stored and indexed without any additional text processing applied in Solr. This is useful if user wants to submit field content that was already processed by some existing external text processing pipeline (e.g., it has been tokenized, annotated, stemmed, synonyms inserted, etc.), while using all the rich attributes that Lucene’s TokenStream provides (per-token attributes).</p>
<p>The serialization format is pluggable using implementations of PreAnalyzedParser interface. There are two out-of-the-box implementations:</p>
-<div class="ulist"><ul><li><a href="#jsonpreanalyzedparser">JsonPreAnalyzedParser</a>: as the name suggests, it parses content that uses JSON to represent field’s content. This is the default parser to use if the field type is not configured otherwise.</li><li><a href="#simplepreanalyzedparser">SimplePreAnalyzedParser</a>: uses a simple strict plain text format, which in some situations may be easier to create than JSON.</li></ul></div>
+<div class="ulist"><ul><li><p><a href="#jsonpreanalyzedparser">JsonPreAnalyzedParser</a>: as the name suggests, it parses content that uses JSON to represent field’s content. This is the default parser to use if the field type is not configured otherwise.</p></li><li><p><a href="#simplepreanalyzedparser">SimplePreAnalyzedParser</a>: uses a simple strict plain text format, which in some situations may be easier to create than JSON.</p></li></ul></div>
<p>There is only one configuration parameter, <code>parserImpl</code>. The value of this parameter should be a fully qualified class name of a class that implements PreAnalyzedParser interface. The default value of this parameter is <code>org.apache.solr.schema.JsonPreAnalyzedParser</code>.</p>
<p>By default, the query-time analyzer for fields of this type will be the same as the index-time analyzer, which expects serialized pre-analyzed text. You must add a query type analyzer to your fieldType in order to perform analysis on non-pre-analyzed queries. In the example below, the index-time analyzer expects the default JSON serialization format, and the query-time analyzer will employ StandardTokenizer/LowerCaseFilter:</p>
<div class="listingblock"><pre class="rouge highlight"><code class="language-xml" data-lang="xml"><pre class="highlight"><code><span style="color: #000080"><fieldType</span> <span style="color: #008080">name=</span><span style="color: #d14">"pre_with_query_analyzer"</span> <span style="color: #008080">class=</span><span style="color: #d14">"solr.PreAnalyzedField"</span><span style="color: #000080">></span>
@@ -1752,26 +1747,26 @@ value ::= text</code></pre></code></pre>
<div class="tableblock"><table class="frame-all grid-all spread"><colgroup><col style="width: 10%;"><col style="width: 30%;"><col style="width: 30%;"><col style="width: 30%;"></colgroup><thead><tr><th class="halign-left valign-top">Name</th><th class="halign-left valign-top">Description</th><th class="halign-left valign-top">Lucene attribute</th><th class="halign-left valign-top">Value format</th></tr><tbody><tr><td class="halign-left valign-top"><code>i</code></td><td class="halign-left valign-top">position increment</td><td class="halign-left valign-top"><a href="https://lucene.apache.org/core/8_6_0//core/org/apache/lucene/analysis/tokenattributes/PositionIncrementAttribute.html">PositionIncrementAttribute</a></td><td class="halign-left valign-top">integer</td></tr><tr><td class="halign-left valign-top"><code>s</code></td><td class="halign-left valign-top">start offset</td><td class="halign-left valign-top"><a href="https://lucene.apache.org/core/8_6_0//core/org/apache/lucene/anal
ysis/tokenattributes/OffsetAttribute.html">OffsetAttribute</a></td><td class="halign-left valign-top">integer</td></tr><tr><td class="halign-left valign-top"><code>e</code></td><td class="halign-left valign-top">end offset</td><td class="halign-left valign-top">OffsetAttribute</td><td class="halign-left valign-top">integer</td></tr><tr><td class="halign-left valign-top"><code>y</code></td><td class="halign-left valign-top">lexical type</td><td class="halign-left valign-top"><a href="https://lucene.apache.org/core/8_6_0//core/org/apache/lucene/analysis/tokenattributes/TypeAttribute.html">TypeAttribute</a></td><td class="halign-left valign-top">string</td></tr><tr><td class="halign-left valign-top"><code>f</code></td><td class="halign-left valign-top">flags</td><td class="halign-left valign-top"><a href="https://lucene.apache.org/core/8_6_0//core/org/apache/lucene/analysis/tokenattributes/FlagsAttribute.html">FlagsAttribute</a></td><td class="halign-left valign-top">hexadecimal intege
r</td></tr><tr><td class="halign-left valign-top"><code>p</code></td><td class="halign-left valign-top">payload</td><td class="halign-left valign-top"><a href="https://lucene.apache.org/core/8_6_0//core/org/apache/lucene/analysis/tokenattributes/PayloadAttribute.html">PayloadAttribute</a></td><td class="halign-left valign-top">bytes in hexadecimal format; whitespace is ignored</td></tr></table></div>
<p>Token positions are tracked and implicitly added to the token stream - the start and end offsets consider only the term text and whitespace, and exclude the space taken by token attributes.</p></section>
<section class="sect3"><h4 id="example-token-streams">Example Token Streams</h4><div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>1 one two three</code></pre></code></pre></div>
-<div class="ulist"><ul><li>version: 1</li><li>stored: null</li><li>token: (term=<code>one</code>,startOffset=0,endOffset=3)</li><li>token: (term=<code>two</code>,startOffset=4,endOffset=7)</li><li>token: (term=<code>three</code>,startOffset=8,endOffset=13)</li></ul></div>
+<div class="ulist"><ul><li><p>version: 1</p></li><li><p>stored: null</p></li><li><p>token: (term=<code>one</code>,startOffset=0,endOffset=3)</p></li><li><p>token: (term=<code>two</code>,startOffset=4,endOffset=7)</p></li><li><p>token: (term=<code>three</code>,startOffset=8,endOffset=13)</p></li></ul></div>
<div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>1 one two three</code></pre></code></pre></div>
-<div class="ulist"><ul><li>version: 1</li><li>stored: null</li><li>token: (term=<code>one</code>,startOffset=0,endOffset=3)</li><li>token: (term=<code>two</code>,startOffset=5,endOffset=8)</li><li>token: (term=<code>three</code>,startOffset=11,endOffset=16)</li></ul></div>
+<div class="ulist"><ul><li><p>version: 1</p></li><li><p>stored: null</p></li><li><p>token: (term=<code>one</code>,startOffset=0,endOffset=3)</p></li><li><p>token: (term=<code>two</code>,startOffset=5,endOffset=8)</p></li><li><p>token: (term=<code>three</code>,startOffset=11,endOffset=16)</p></li></ul></div>
<div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>1 one,s=123,e=128,i=22 two three,s=20,e=22</code></pre></code></pre></div>
-<div class="ulist"><ul><li>version: 1</li><li>stored: null</li><li>token: (term=<code>one</code>,positionIncrement=22,startOffset=123,endOffset=128)</li><li>token: (term=<code>two</code>,positionIncrement=1,startOffset=5,endOffset=8)</li><li>token: (term=<code>three</code>,positionIncrement=1,startOffset=20,endOffset=22)</li></ul></div>
+<div class="ulist"><ul><li><p>version: 1</p></li><li><p>stored: null</p></li><li><p>token: (term=<code>one</code>,positionIncrement=22,startOffset=123,endOffset=128)</p></li><li><p>token: (term=<code>two</code>,positionIncrement=1,startOffset=5,endOffset=8)</p></li><li><p>token: (term=<code>three</code>,positionIncrement=1,startOffset=20,endOffset=22)</p></li></ul></div>
<div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>1 \ one\ \,,i=22,a=\, two\=
\n,\ =\ \</code></pre></code></pre></div>
-<div class="ulist"><ul><li>version: 1</li><li>stored: null</li><li>token: (term=<code>one ,</code>,positionIncrement=22,startOffset=0,endOffset=6)</li><li>token: (term=<code>two=</code> ,positionIncrement=1,startOffset=7,endOffset=15)</li><li>token: (term=<code>\</code>,positionIncrement=1,startOffset=17,endOffset=18)</li></ul></div>
+<div class="ulist"><ul><li><p>version: 1</p></li><li><p>stored: null</p></li><li><p>token: (term=<code>one ,</code>,positionIncrement=22,startOffset=0,endOffset=6)</p></li><li><p>token: (term=<code>two=</code> ,positionIncrement=1,startOffset=7,endOffset=15)</p></li><li><p>token: (term=<code>\</code>,positionIncrement=1,startOffset=17,endOffset=18)</p></li></ul></div>
<p>Note that unknown attributes and their values are ignored, so in this example, the “<code>a</code>” attribute on the first token and the " " (escaped space) attribute on the second token are ignored, along with their values, because they are not among the supported attribute names.</p>
<div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>1 ,i=22 ,i=33,s=2,e=20 ,</code></pre></code></pre></div>
-<div class="ulist"><ul><li>version: 1</li><li>stored: null</li><li>token: (term=,positionIncrement=22,startOffset=0,endOffset=0)</li><li>token: (term=,positionIncrement=33,startOffset=2,endOffset=20)</li><li>token: (term=,positionIncrement=1,startOffset=2,endOffset=2)</li></ul></div>
+<div class="ulist"><ul><li><p>version: 1</p></li><li><p>stored: null</p></li><li><p>token: (term=,positionIncrement=22,startOffset=0,endOffset=0)</p></li><li><p>token: (term=,positionIncrement=33,startOffset=2,endOffset=20)</p></li><li><p>token: (term=,positionIncrement=1,startOffset=2,endOffset=2)</p></li></ul></div>
<div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>1 =This is the stored part with \=
\n \t escapes.=one two three</code></pre></code></pre></div>
-<div class="ulist"><ul><li>version: 1</li><li>stored: <code>This is the stored part with = \t escapes.</code></li><li>token: (term=<code>one</code>,startOffset=0,endOffset=3)</li><li>token: (term=<code>two</code>,startOffset=4,endOffset=7)</li><li>token: (term=<code>three</code>,startOffset=8,endOffset=13)</li></ul></div>
+<div class="ulist"><ul><li><p>version: 1</p></li><li><p>stored: <code>This is the stored part with = \t escapes.</code></p></li><li><p>token: (term=<code>one</code>,startOffset=0,endOffset=3)</p></li><li><p>token: (term=<code>two</code>,startOffset=4,endOffset=7)</p></li><li><p>token: (term=<code>three</code>,startOffset=8,endOffset=13)</p></li></ul></div>
<p>Note that the <code>\t</code> in the above stored value is not literal; it’s shown that way to visually indicate the actual tab char that is in the stored value.</p>
<div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>1 ==</code></pre></code></pre></div>
-<div class="ulist"><ul><li>version: 1</li><li>stored: ""</li><li>(no tokens)</li></ul></div>
+<div class="ulist"><ul><li><p>version: 1</p></li><li><p>stored: ""</p></li><li><p>(no tokens)</p></li></ul></div>
<div class="listingblock"><pre class="rouge highlight"><code class="language-text" data-lang="text"><pre class="highlight"><code>1 =this is a test.=</code></pre></code></pre></div>
-<div class="ulist"><ul><li>version: 1</li><li>stored: <code>this is a test.</code></li><li>(no tokens)</li></ul></div></section></section></section>
+<div class="ulist"><ul><li><p>version: 1</p></li><li><p>stored: <code>this is a test.</code></p></li><li><p>(no tokens)</p></li></ul></div></section></section></section>
</section>
@@ -1801,7 +1796,7 @@ value ::= text</code></pre></code></pre>
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>
Modified: websites/production/lucene/content/solr/guide/8_6/zookeeper-access-control.html
==============================================================================
--- websites/production/lucene/content/solr/guide/8_6/zookeeper-access-control.html (original)
+++ websites/production/lucene/content/solr/guide/8_6/zookeeper-access-control.html Wed Jul 15 16:52:36 2020
@@ -8,7 +8,7 @@
<meta name="description" content="">
<meta name="keywords" content=" ">
-<title>ZooKeeper Access Control | Apache Solr Reference Guide 8.6-DRAFT</title>
+<title>ZooKeeper Access Control | Apache Solr Reference Guide 8.6</title>
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
@@ -71,7 +71,7 @@
</script>
</head>
-<body class="DRAFT" id="zookeeper-access-control">
+<body class="" id="zookeeper-access-control">
<div class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-2 d-none d-md-block">
@@ -79,11 +79,6 @@
<div class="sidebar-header">
<div class="sidebarTitle text-center">Apache Solr Reference Guide</div>
- <p class="draft-notice">
- This is an unofficial DRAFT of the Guide for 8.6.
- <a href="https://lucene.apache.org/solr/guide/">Official releases are available from the Solr website</a>.
- </p>
-
<!--comment out this block if you want to hide search-->
<!--start search-->
@@ -1670,9 +1665,9 @@
<section class="sect1"><h2 id="about-zookeeper-acls">About ZooKeeper ACLs</h2><p>SolrCloud uses ZooKeeper for shared information and for coordination.</p>
<p>This section describes how to configure Solr to add more restrictive ACLs to the ZooKeeper content it creates, and how to tell Solr about the credentials required to access the content in ZooKeeper. If you want to use ACLs in your ZooKeeper nodes, you will have to activate this functionality; by default, Solr behavior is open-unsafe ACL everywhere and uses no credentials.</p>
<p>Content stored in ZooKeeper is critical to the operation of a SolrCloud cluster. Open access to SolrCloud content on ZooKeeper could lead to a variety of problems. For example:</p>
-<div class="ulist"><ul><li>Changing configuration might cause Solr to fail or behave in an unintended way.</li><li>Changing cluster state information into something wrong or inconsistent might very well make a SolrCloud cluster behave strangely.</li><li>Adding a delete-collection job to be carried out by the Overseer will cause data to be deleted from the cluster.</li></ul></div>
+<div class="ulist"><ul><li><p>Changing configuration might cause Solr to fail or behave in an unintended way.</p></li><li><p>Changing cluster state information into something wrong or inconsistent might very well make a SolrCloud cluster behave strangely.</p></li><li><p>Adding a delete-collection job to be carried out by the Overseer will cause data to be deleted from the cluster.</p></li></ul></div>
<p>You may want to enable ZooKeeper ACLs with Solr if you grant access to your ZooKeeper ensemble to entities you do not trust, or if you want to reduce risk of bad actions resulting from, for example:</p>
-<div class="ulist"><ul><li>Malware that found its way into your system.</li><li>Other systems using the same ZooKeeper ensemble (a "bad thing" might be done by accident).</li></ul></div>
+<div class="ulist"><ul><li><p>Malware that found its way into your system.</p></li><li><p>Other systems using the same ZooKeeper ensemble (a "bad thing" might be done by accident).</p></li></ul></div>
<p>You might even want to limit read-access, if you think there is stuff in ZooKeeper that not everyone should know about. Or you might just in general work on a need-to-know basis.</p>
<p>Protecting ZooKeeper itself could mean many different things. <strong>This section is about protecting Solr content in ZooKeeper</strong>. ZooKeeper content basically lives persisted on disk and (partly) in memory of the ZooKeeper processes. <strong>This section is not about protecting ZooKeeper data at storage or ZooKeeper process levels</strong> - that’s for ZooKeeper to deal with.</p>
<p>But this content is also available to "the outside" via the ZooKeeper API. Outside processes can connect to ZooKeeper and create/update/delete/read content; for example, a Solr node in a SolrCloud cluster wants to create/update/delete/read, and a SolrJ client wants to read from the cluster. It is the responsibility of the outside processes that create/update content to setup ACLs on the content. ACLs describe who is allowed to read, update, delete, create, etc. Each piece of information (znode/content) in ZooKeeper has its own set of ACLs, and inheritance or sharing is not possible. The default behavior in Solr is to add one ACL on all the content it creates - one ACL that gives anyone the permission to do anything (in ZooKeeper terms this is called "the open-unsafe ACL").</p></section>
@@ -1681,15 +1676,15 @@
<p>Solr nodes, clients and tools (e.g., ZkCLI) always use a java class called <a href="https://lucene.apache.org/solr/8_6_0//solr-solrj/org/apache/solr/common/cloud/SolrZkClient.html"><code>SolrZkClient</code></a> to deal with their ZooKeeper stuff. The implementation of the solution described here is all about changing <code>SolrZkClient</code>. If you use <code>SolrZkClient</code> in your application, the descriptions below will be true for your application too.</p>
<section class="sect2"><h3 id="controlling-credentials">Controlling Credentials</h3><p>You control which credentials provider will be used by configuring the <code>zkCredentialsProvider</code> property in <code>solr.xml</code> 's <code><solrcloud></code> section to the name of a class (on the classpath) implementing the <a href="https://lucene.apache.org/solr/8_6_0//solr-solrj/org/apache/solr/common/cloud/ZkCredentialsProvider.html"><code>ZkCredentialsProvider</code></a> interface. <code>server/solr/solr.xml</code> in the Solr distribution defines the <code>zkCredentialsProvider</code> such that it will take on the value of the same-named <code>zkCredentialsProvider</code> system property if it is defined (e.g., by uncommenting the <code>SOLR_ZK_CREDS_AND_ACLS</code> environment variable definition in <code>solr.in.sh/.cmd</code> - see below), or if not, default to the <code>DefaultZkCredentialsProvider</code> implementation.</p>
<section class="sect3"><h4 id="out-of-the-box-credential-implementations">Out of the Box Credential Implementations</h4><p>You can always make you own implementation, but Solr comes with two implementations:</p>
-<div class="ulist"><ul><li><code>org.apache.solr.common.cloud.DefaultZkCredentialsProvider</code>: Its <code>getCredentials()</code> returns a list of length zero, or "no credentials used". This is the default.</li><li><code>org.apache.solr.common.cloud.VMParamsSingleSetCredentialsDigestZkCredentialsProvider</code>: This lets you define your credentials using system properties. It supports at most one set of credentials.<ul><li>The schema is "digest". The username and password are defined by system properties <code>zkDigestUsername</code> and <code>zkDigestPassword</code>. This set of credentials will be added to the list of credentials returned by <code>getCredentials()</code> if both username and password are provided.</li><li>If the one set of credentials above is not added to the list, this implementation will fall back to default behavior and use the (empty) credentials list from <code>DefaultZkCredentialsProvider</code>.</li></ul></li></ul></div></section></section>
+<div class="ulist"><ul><li><p><code>org.apache.solr.common.cloud.DefaultZkCredentialsProvider</code>: Its <code>getCredentials()</code> returns a list of length zero, or "no credentials used". This is the default.</p></li><li><p><code>org.apache.solr.common.cloud.VMParamsSingleSetCredentialsDigestZkCredentialsProvider</code>: This lets you define your credentials using system properties. It supports at most one set of credentials.<ul><li><p>The schema is "digest". The username and password are defined by system properties <code>zkDigestUsername</code> and <code>zkDigestPassword</code>. This set of credentials will be added to the list of credentials returned by <code>getCredentials()</code> if both username and password are provided.</p></li><li><p>If the one set of credentials above is not added to the list, this implementation will fall back to default behavior and use the (empty) credentials list from <code>DefaultZkCredentialsProvider</code>.</p></li></ul></p></li></ul></div></s
ection></section>
<section class="sect2"><h3 id="controlling-acls">Controlling ACLs</h3><p>You control which ACLs will be added by configuring <code>zkACLProvider</code> property in <code>solr.xml</code> 's <code><solrcloud></code> section to the name of a class (on the classpath) implementing the <a href="https://lucene.apache.org/solr/8_6_0///solr-solrj/org/apache/solr/common/cloud/ZkACLProvider.html"><code>ZkACLProvider</code></a> interface. <code>server/solr/solr.xml</code> in the Solr distribution defines the <code>zkACLProvider</code> such that it will take on the value of the same-named <code>zkACLProvider</code> system property if it is defined (e.g., by uncommenting the <code>SOLR_ZK_CREDS_AND_ACLS</code> environment variable definition in <code>solr.in.sh/.cmd</code> - see below), or if not, default to the <code>DefaultZkACLProvider</code> implementation.</p>
<section class="sect3"><h4 id="out-of-the-box-acl-implementations">Out of the Box ACL Implementations</h4><p>You can always make you own implementation, but Solr comes with:</p>
-<div class="ulist"><ul><li><code>org.apache.solr.common.cloud.DefaultZkACLProvider</code>: It returns a list of length one for all <code>zNodePath</code>-s. The single ACL entry in the list is "open-unsafe". This is the default.</li><li><code>org.apache.solr.common.cloud.VMParamsAllAndReadonlyDigestZkACLProvider</code>: This lets you define your ACLs using system properties. Its <code>getACLsToAdd()</code> implementation does not use <code>zNodePath</code> for anything, so all znodes will get the same set of ACLs. It supports adding one or both of these options:<ul><li>A user that is allowed to do everything.<ul><li>The permission is <code>ALL</code> (corresponding to all of <code>CREATE</code>, <code>READ</code>, <code>WRITE</code>, <code>DELETE</code>, and <code>ADMIN</code>), and the schema is "digest".</li><li>The username and password are defined by system properties <code>zkDigestUsername</code> and <code>zkDigestPassword</code>, respectively.</li><li>This ACL will not be adde
d to the list of ACLs unless both username and password are provided.</li></ul></li><li>A user that is only allowed to perform read operations.<ul><li>The permission is <code>READ</code> and the schema is <code>digest</code>.</li><li>The username and password are defined by system properties <code>zkDigestReadonlyUsername</code> and <code>zkDigestReadonlyPassword</code>, respectively.</li><li>This ACL will not be added to the list of ACLs unless both username and password are provided.</li></ul></li></ul></li><li><code>org.apache.solr.common.cloud.SaslZkACLProvider</code>: Requires SASL authentication. Gives all permissions for the user specified in system property <code>solr.authorization.superuser</code> (default: <code>solr</code>) when using SASL, and gives read permissions for anyone else. Designed for a setup where configurations have already been set up and will not be modified, or where configuration changes are controlled via Solr APIs. This provider will be useful for admi
nistration in a kerberos environment. In such an environment, the administrator wants Solr to authenticate to ZooKeeper using SASL, since this is only way to authenticate with ZooKeeper via Kerberos.</li></ul></div>
+<div class="ulist"><ul><li><p><code>org.apache.solr.common.cloud.DefaultZkACLProvider</code>: It returns a list of length one for all <code>zNodePath</code>-s. The single ACL entry in the list is "open-unsafe". This is the default.</p></li><li><p><code>org.apache.solr.common.cloud.VMParamsAllAndReadonlyDigestZkACLProvider</code>: This lets you define your ACLs using system properties. Its <code>getACLsToAdd()</code> implementation does not use <code>zNodePath</code> for anything, so all znodes will get the same set of ACLs. It supports adding one or both of these options:<ul><li><p>A user that is allowed to do everything.<ul><li><p>The permission is <code>ALL</code> (corresponding to all of <code>CREATE</code>, <code>READ</code>, <code>WRITE</code>, <code>DELETE</code>, and <code>ADMIN</code>), and the schema is "digest".</p></li><li><p>The username and password are defined by system properties <code>zkDigestUsername</code> and <code>zkDigestPassword</code>, respectively.</p></li><l
i><p>This ACL will not be added to the list of ACLs unless both username and password are provided.</p></li></ul></p></li><li><p>A user that is only allowed to perform read operations.<ul><li><p>The permission is <code>READ</code> and the schema is <code>digest</code>.</p></li><li><p>The username and password are defined by system properties <code>zkDigestReadonlyUsername</code> and <code>zkDigestReadonlyPassword</code>, respectively.</p></li><li><p>This ACL will not be added to the list of ACLs unless both username and password are provided.</p></li></ul></p></li></ul></p></li><li><p><code>org.apache.solr.common.cloud.SaslZkACLProvider</code>: Requires SASL authentication. Gives all permissions for the user specified in system property <code>solr.authorization.superuser</code> (default: <code>solr</code>) when using SASL, and gives read permissions for anyone else. Designed for a setup where configurations have already been set up and will not be modified, or where configuration ch
anges are controlled via Solr APIs. This provider will be useful for administration in a kerberos environment. In such an environment, the administrator wants Solr to authenticate to ZooKeeper using SASL, since this is only way to authenticate with ZooKeeper via Kerberos.</p></li></ul></div>
<p>If none of the above ACLs is added to the list, the (empty) ACL list of <code>DefaultZkACLProvider</code> will be used by default.</p>
<p>Notice the overlap in system property names with credentials provider <code>VMParamsSingleSetCredentialsDigestZkCredentialsProvider</code> (described above). This is to let the two providers collaborate in a nice and perhaps common way: we always protect access to content by limiting to two users - an admin-user and a readonly-user - AND we always connect with credentials corresponding to this same admin-user, basically so that we can do anything to the content/znodes we create ourselves.</p>
<p>You can give the readonly credentials to "clients" of your SolrCloud cluster - e.g., to be used by SolrJ clients. They will be able to read whatever is necessary to run a functioning SolrJ client, but they will not be able to modify any content in ZooKeeper.</p></section></section>
<section class="sect2"><h3 id="zookeeper-acls-in-solr-scripts">ZooKeeper ACLs in Solr Scripts</h3><p>There are two scripts that impact ZooKeeper ACLs:</p>
-<div class="ulist"><ul><li>For *nix systems: <code>bin/solr</code> & <code>server/scripts/cloud-scripts/zkcli.sh</code></li><li>For Windows systems: <code>bin/solr.cmd</code> & <code>server/scripts/cloud-scripts/zkcli.bat</code></li></ul></div>
+<div class="ulist"><ul><li><p>For *nix systems: <code>bin/solr</code> & <code>server/scripts/cloud-scripts/zkcli.sh</code></p></li><li><p>For Windows systems: <code>bin/solr.cmd</code> & <code>server/scripts/cloud-scripts/zkcli.bat</code></p></li></ul></div>
<p>These Solr scripts can enable use of ZooKeeper ACLs by setting the appropriate system properties: uncomment the following and replace the passwords with ones you choose to enable the above-described VM parameters ACL and credentials providers in the following files:</p>
<figure class="listingblock"><figcaption>solr.in.sh</figcaption>
<pre class="rouge highlight"><code class="language-bash" data-lang="bash"><pre class="highlight"><code><span style="color: #999988;font-style: italic"># Settings for ZK ACL</span>
@@ -1720,7 +1715,7 @@ REM -DzkDigestReadonlyUsername<span sty
<section class="sect1"><h2 id="changing-acl-schemes">Changing ACL Schemes</h2><p>Over the lifetime of operating your Solr cluster, you may decide to move from an unsecured ZooKeeper to a secured instance. Changing the configured <code>zkACLProvider</code> in <code>solr.xml</code> will ensure that newly created nodes are secure, but will not protect the already existing data. To modify all existing ACLs, you can use the <code>updateacls</code> command with Solr’s ZkCLI. First uncomment the <code>SOLR_ZK_CREDS_AND_ACLS</code> environment variable definition in <code>server/scripts/cloud-scripts/zkcli.sh</code> (or <code>zkcli.bat</code> on Windows) and fill in the passwords for the admin-user and the readonly-user - see above - then run <code>server/scripts/cloud-scripts/zkcli.sh -cmd updateacls /zk-path</code>, or on Windows run <code>server\scripts\cloud-scripts\zkcli.bat cmd updateacls /zk-path</code>.</p>
<p>Changing ACLs in ZK should only be done while your SolrCloud cluster is stopped. Attempting to do so while Solr is running may result in inconsistent state and some nodes becoming inaccessible.</p>
<p>The VM properties <code>zkACLProvider</code> and <code>zkCredentialsProvider</code>, included in the <code>SOLR_ZK_CREDS_AND_ACLS</code> environment variable in <code>zkcli.sh/.bat</code>, control the conversion:</p>
-<div class="ulist"><ul><li>The Credentials Provider must be one that has current admin privileges on the nodes. When omitted, the process will use no credentials (suitable for an unsecure configuration).</li><li>The ACL Provider will be used to compute the new ACLs. When omitted, the process will set all permissions to all users, removing any security present.</li></ul></div>
+<div class="ulist"><ul><li><p>The Credentials Provider must be one that has current admin privileges on the nodes. When omitted, the process will use no credentials (suitable for an unsecure configuration).</p></li><li><p>The ACL Provider will be used to compute the new ACLs. When omitted, the process will set all permissions to all users, removing any security present.</p></li></ul></div>
<p>The uncommented <code>SOLR_ZK_CREDS_AND_ACLS</code> environment variable in <code>zkcli.sh/.bat</code> sets the credentials and ACL providers to the <code>VMParamsSingleSetCredentialsDigestZkCredentialsProvider</code> and <code>VMParamsAllAndReadonlyDigestZkACLProvider</code> implementations, described earlier in the page.</p></section>
</section>
@@ -1751,7 +1746,7 @@ REM -DzkDigestReadonlyUsername<span sty
<div class="row">
<div class="col-lg-12 footer">
©2020 Apache Software Foundation. All rights reserved. <br />
- Site Version: 8.6-DRAFT <br />Site last generated: 2020-07-08 <br />
+ Site Version: 8.6 <br />Site last generated: 2020-07-15 <br />
<p><img src="images/solr-sunOnly-small.png" alt="Apache Solr"/></p>
</div>
</div>