Modified: sites/solr/guide/solr/latest/deployment-guide/collection-management.html URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/latest/deployment-guide/collection-management.html?rev=1083697&r1=1083696&r2=1083697&view=diff ============================================================================== --- sites/solr/guide/solr/latest/deployment-guide/collection-management.html (original) +++ sites/solr/guide/solr/latest/deployment-guide/collection-management.html Fri Jul 21 18:07:42 2023 @@ -39,7 +39,7 @@ <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="#">Resources</a> <div class="navbar-dropdown"> - <a class="navbar-item" href="https://solr.apache.org/docs/9_2_1/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> + <a class="navbar-item" href="https://solr.apache.org/docs/9_3_0/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> <a class="navbar-item" href="https://solr.apache.org/community.html#version-control"; target="_blank" rel="noreferrer nopener">Source Code</a> <a class="navbar-item" href="https://solr.apache.org/community.html"; target="_blank" rel="noreferrer nopener">Community Links</a> <a class="navbar-item" href="https://github.com/apache/solr/tree/main/dev-docs/ref-guide"; target="_blank" rel="noreferrer nopener">Contribute</a> @@ -56,25 +56,25 @@ </nav> </header> <div class="body"> -<div class="nav-container" data-component="solr" data-version="9_2"> +<div class="nav-container" data-component="solr" data-version="9_3"> <aside class="nav"> <div class="panels"> <!-- Solr Changes - Start --> <div class="nav-panel-explore" data-panel="explore"> <div class="context"> <span class="title">Solr Reference Guide</span> - <span class="version">9.2</span> + <span class="version">9.3</span> </div> <!-- Programmatically creates the component and version list --> <ul class="components"> <li class="component is-current"> <a class="title" href="../index.html">Solr Reference Guide</a> <ul class="versions"> - <li class="version"> - <a href="../../9_3/index.html">9.3-beta</a> - </li> <li class="version is-current is-latest"> - <a href="../index.html">9.2</a> + <a href="../index.html">9.3</a> + </li> + <li class="version"> + <a href="../../9_2/index.html">9.2</a> </li> <li class="version"> <a href="../../9_1/index.html">9.1</a> @@ -211,7 +211,7 @@ <a class="nav-link" href="../getting-started/tutorial-films.html">Exercise 2: Index Films Data</a> </li> <li class="nav-item" data-depth="2"> - <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3 Index Your Own Data</a> + <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3: Index Your Own Data</a> </li> <li class="nav-item" data-depth="2"> <a class="nav-link" href="../getting-started/tutorial-solrcloud.html">Getting Started with SolrCloud</a> @@ -718,6 +718,9 @@ </ul> </li> <li class="nav-item" data-depth="2"> + <a class="nav-link" href="../indexing-guide/indexing-with-cbor.html">Indexing with Update CBOR data format</a> + </li> + <li class="nav-item" data-depth="2"> <a class="nav-link" href="../indexing-guide/indexing-with-tika.html">Indexing with Solr Cell and Apache Tika</a> </li> <li class="nav-item" data-depth="2"> @@ -1072,17 +1075,17 @@ </ul> </nav> <div class="page-versions"> - <button class="version-menu-toggle" title="Show other versions of page">9.2</button> + <button class="version-menu-toggle" title="Show other versions of page">9.3</button> <div class="version-menu"> - <a class="version" href="../../9_3/deployment-guide/collection-management.html">9.3-beta</a> - <a class="version is-current" href="collection-management.html">9.2</a> + <a class="version is-current" href="collection-management.html">9.3</a> + <a class="version" href="../../9_2/deployment-guide/collection-management.html">9.2</a> <a class="version" href="../../9_1/deployment-guide/collection-management.html">9.1</a> <a class="version" href="../../9_0/deployment-guide/collection-management.html">9.0</a> </div> </div> <!-- Solr Additions - Start --> <!-- Solr New File --> -<span class="perma-link-copy" version="9_2"> +<span class="perma-link-copy" version="9_3"> </span><!-- Solr Additions - End --> <div class="edit-this-page"><a href="https://github.com/apache/solr/tree/main/solr/solr-ref-guide/modules/deployment-guide/pages/collection-management.adoc";>Edit this Page</a></div> </div> @@ -1140,11 +1143,9 @@ <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections -H 'Content-Type: application/json' -d ' { - "create": { - "name": "techproducts_v2", - "config": "techproducts", - "numShards": 1 - } + "name": "techproducts_v2", + "config": "techproducts", + "numShards": 1 } '</code></pre> </div> @@ -1231,7 +1232,7 @@ When using the <code>compositeId</code> This is a required parameter when the <code>router.name</code> is <code>compositeId</code>.</p> </div> </dd> -<dt class="hdlist1"><code>shards</code></dt> +<dt class="hdlist1"><code>shards</code> (v1), <code>shardNames</code> (v2)</dt> <dd> <table class="tableblock frame-none grid-all fit-content"> <colgroup> @@ -1246,8 +1247,10 @@ This is a required parameter when the <c </tbody> </table> <div class="paragraph"> -<p>A comma separated list of shard names, e.g., <code>shard-x,shard-y,shard-z</code>. -This is a required parameter when the <code>router.name</code> is <code>implicit</code>.</p> +<p>The shard names use when creating this collection. +This is a required parameter when <code>router.name</code> is <code>implicit</code>. +For v1 requests, these are provided as a single comma-delimited query parameter, e.g., <code>shard-x,shard-y,shard-z</code>. +For v2 requests shard names are provided as a list of values in the request body, e.g., <code>["shard-x", "shard-y", "shard-z"]</code></p> </div> </dd> <dt class="hdlist1"><code>replicationFactor</code></dt> @@ -1350,13 +1353,38 @@ See the section <a href="solrcloud-shard </table> <div class="paragraph"> <p>Allows defining the nodes to spread the new collection across. -The format is a comma-separated list of node_names, such as <code>localhost:8983_solr,localhost:8984_solr,localhost:8985_solr</code>.</p> +For v1 requests, node names are provided as a single comma-separated list, such as <code>localhost:8983_solr,localhost:8984_solr,localhost:8985_solr</code>. +For v2 requests, node names are provided as a list of individual values, such as <code>["localhost:8983_solr", "localhost:7574_solr"]</code>.</p> +</div> +<div class="paragraph"> +<p>If not provided, the CREATE operation will use all live nodes in the cluster as its node set.</p> +</div> +<div class="paragraph"> +<p>Alternatively, v1 requests allow the special value <code>EMPTY</code> to initially create no shard-replica within the new collection and then later use the <a href="replica-management.html#addreplica" class="xref page">ADDREPLICA</a> operation to add shard-replicas when and where required. +v2 requests may use this same functionality via the <code>createReplicas</code> boolean parameter.</p> </div> +</dd> +<dt class="hdlist1"><code>createReplicas</code> (v2)</dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: true</p></td> +</tr> +</tbody> +</table> <div class="paragraph"> -<p>If not provided, the CREATE operation will create shard-replicas spread across all live Solr nodes.</p> +<p>Controls whether Solr creates replicas for each shard as a part of the collection-creation operation. +(Replicas can always be created later using the <a href="replica-management.html#addreplica" class="xref page">ADDREPLICA</a> operation.)</p> </div> <div class="paragraph"> -<p>Alternatively, use the special value of <code>EMPTY</code> to initially create no shard-replica within the new collection and then later use the <a href="replica-management.html#addreplica" class="xref page">ADDREPLICA</a> operation to add shard-replicas when and where required.</p> +<p>Only available on v2 requests. +v1 requests wishing to defer replica-creation may do so my providing the <code>EMPTY</code> flag value to the <code>createNodeSet</code> parameter.</p> </div> </dd> <dt class="hdlist1"><code>createNodeSet.shuffle</code> (v1), <code>shuffleNodes</code> (v2)</dt> @@ -1582,29 +1610,14 @@ However, for changes to files in configs <p><strong class="tab-label">V2 API</strong></p> </div> <div class="paragraph"> -<p>With the v2 API, the <code>reload</code> command is provided as part of the JSON data that contains the required parameters:</p> +<p>With the v2 API, the <code>reload</code> command is provided as a part of URL path. The request body is optional if the optional <code>async</code> parameter is omitted:</p> </div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections/techproducts_v2 -H 'Content-Type: application/json' -d ' +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections/techproducts_v2/reload -H 'Content-Type: application/json' -d ' { - "reload": {} - } -'</code></pre> -</div> -</div> -<div class="paragraph"> -<p>Additional parameters can be passed in via the <code>reload</code> key:</p> -</div> -<div class="listingblock"> -<div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections/techproducts_v2 -H 'Content-Type: application/json' -d ' - { - "reload": { - "async": "reload1" - } - } -'</code></pre> + "async": "someAsyncId" + }</code></pre> </div> </div> </div> @@ -1631,7 +1644,8 @@ However, for changes to files in configs </table> <div class="paragraph"> <p>The name of the collection to reload. -This parameter is required by the V1 API.</p> +This parameter is required. +It appears as a query-parameter on v1 requests, and in the URL path of v2 requests.</p> </div> </dd> <dt class="hdlist1"><code>async</code></dt> @@ -1933,7 +1947,7 @@ Aliases that refer to more than 1 collec </div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">http://localhost:8983/solr/admin/collections?action=RENAME&name=techproducts_v2&target=renamedCollection</code></pre> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">http://localhost:8983/solr/admin/collections?action=RENAME&name=techproducts_v2&target=newName</code></pre> </div> </div> </div> @@ -1947,7 +1961,7 @@ Aliases that refer to more than 1 collec <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections/techproducts/rename -H 'Content-Type: application/json' -d ' { - "to": "new_name" + "to": "newName" } '</code></pre> </div> @@ -2214,18 +2228,26 @@ If the status is anything other than "su <div class="paragraph"> <p><strong class="tab-label">V2 API</strong></p> </div> +<div class="paragraph"> +<p>To create or update a collection property:</p> +</div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections/techproducts_v2 -H 'Content-Type: application/json' -d ' +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X PUT http://localhost:8983/api/collections/techproducts_v2/properties/foo -H 'Content-Type: application/json' -d ' { - "set-collection-property": { - "name": "foo", - "value": "bar" - } + "value": "bar" } '</code></pre> </div> </div> +<div class="paragraph"> +<p>To delete an existing collection property:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X DELETE http://localhost:8983/api/collections/techproducts_v2/properties/foo</code></pre> +</div> +</div> </div> </div> </div> @@ -2234,7 +2256,7 @@ If the status is anything other than "su <h3 id="collectionprop-parameters"><a class="anchor" href="#collectionprop-parameters"></a>COLLECTIONPROP Parameters</h3> <div class="dlist"> <dl> -<dt class="hdlist1"><code>name</code></dt> +<dt class="hdlist1"><code>name</code> (v1)</dt> <dd> <table class="tableblock frame-none grid-all fit-content"> <colgroup> @@ -2249,10 +2271,11 @@ If the status is anything other than "su </tbody> </table> <div class="paragraph"> -<p>The name of the collection for which the property would be set.</p> +<p>The name of the collection for which the property would be set. +Appears in the path of v2 requests.</p> </div> </dd> -<dt class="hdlist1"><code>propertyName</code> (v1), <code>name</code> (v2)</dt> +<dt class="hdlist1"><code>propertyName</code> (v1)</dt> <dd> <table class="tableblock frame-none grid-all fit-content"> <colgroup> @@ -2267,7 +2290,8 @@ If the status is anything other than "su </tbody> </table> <div class="paragraph"> -<p>The name of the property.</p> +<p>The name of the property. +Appears in the path of v2 requests.</p> </div> </dd> <dt class="hdlist1"><code>propertyValue</code> (v1), <code>value</code> (v2)</dt> @@ -2286,7 +2310,7 @@ If the status is anything other than "su </table> <div class="paragraph"> <p>The value of the property. -When not provided, the property is deleted.</p> +When not provided in v1 requests, the property is deleted.</p> </div> </dd> </dl> @@ -3424,7 +3448,7 @@ of shard leaders.</p> <h2 id="backup"><a class="anchor" href="#backup"></a>BACKUP: Backup Collection</h2> <div class="sectionbody"> <div class="paragraph"> -<p>Backs up Solr collections and associated configurations to a shared filesystem - for example a Network File System.</p> +<p>Backs up Solr collections and associated configurations to a "backup repository".</p> </div> <div class="openblock dynamic-tabs"> <div class="content"> @@ -3445,18 +3469,11 @@ of shard leaders.</p> <div class="paragraph"> <p><strong class="tab-label">V2 API</strong></p> </div> -<div class="paragraph"> -<p>With the v2 API, the <code>backup-collection</code> command is provided as part of the JSON data that contains the required parameters:</p> -</div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections -H 'Content-Type: application/json' -d ' +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections/techproducts/backups/techproducts_backup/versions -H 'Content-Type: application/json' -d ' { - "backup-collection": { - "name": "techproducts_backup", - "collection": "techproducts", - "location": "file:///path/to/my/shared/drive" - } + "location": "file:///path/to/my/shared/drive" } '</code></pre> </div> @@ -3466,7 +3483,7 @@ of shard leaders.</p> </div> </div> <div class="paragraph"> -<p>The BACKUP command will backup Solr indexes and configurations for a specified collection. +<p>The BACKUP API will backup Solr indexes and configurations for a specified collection. The BACKUP command <a href="backup-restore.html" class="xref page">takes one copy from each shard for the indexes</a>. For configurations, it backs up the configset that was associated with the collection and metadata.</p> </div> @@ -3488,8 +3505,8 @@ Multiple collections cannot be backed up </td> <td class="content"> <div class="paragraph"> -<p>Previous versions of Solr supported a different snapshot-based backup method without the incremental support described above. -Solr can still restore from backups that use this old format, but creating new backups of this format is not recommended and snapshot-based backups are officially deprecated. +<p>Previous versions of Solr supported a different backup file format that lacked the incremental support described above. +Solr can still restore from backups that use this old format, but creating new backups of this format is not recommended and is officially deprecated. See the <code>incremental</code> parameter below for more information.</p> </div> </td> @@ -3515,7 +3532,8 @@ See the <code>incremental</code> paramet </tbody> </table> <div class="paragraph"> -<p>The name of the collection to be backed up.</p> +<p>The name of the collection to be backed up. +Provided as a query parameter for v1 requests, and as a path segment for v2 requests.</p> </div> </dd> <dt class="hdlist1"><code>name</code></dt> @@ -3534,6 +3552,7 @@ See the <code>incremental</code> paramet </table> <div class="paragraph"> <p>What to name the backup that is created. +Provided as a query parameter for v1 requests, or as a path segment for v2 requests. This is checked to make sure it doesn’t already exist, and otherwise an error message is raised.</p> </div> </dd> @@ -3624,6 +3643,24 @@ If the current number exceeds this bound This parameter has no effect if <code>incremental=false</code> is specified.</p> </div> </dd> +<dt class="hdlist1"><code>backupConfigset</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: true</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>Indicates if configset files should be included with the index backup or not. Note that in order to restore a collection, the configset must either exist in ZooKeeper or be part of the backup. Only set this to <code>false</code> if you can restore configsets by other means external to Solr (i.e. you have it stored with your application source code, is part of your ZooKeeper backups, etc).</p> +</div> +</dd> <dt class="hdlist1"><code>incremental</code></dt> <dd> <table class="tableblock frame-none grid-all fit-content"> @@ -3639,9 +3676,47 @@ This parameter has no effect if <code>in </tbody> </table> <div class="paragraph"> -<p>A boolean parameter allowing users to choose whether to create an incremental (<code>incremental=true</code>) or a "snapshot" (<code>incremental=false</code>) backup. +<p>A boolean parameter allowing users to choose whether to create an incremental (<code>incremental=true</code>) or a "full" (<code>incremental=false</code>) backup. If unspecified, backups are done incrementally by default. -Incremental backups are preferred in all known circumstances and snapshot backups are deprecated, so this parameter should only be used after much consideration.</p> +Incremental backups are preferred in all known circumstances and "full" (i.e. non-incremental) backups are deprecated, so this parameter should only be used after much consideration.</p> +</div> +</dd> +<dt class="hdlist1"><code>indexBackup</code> (v1), <code>backupStrategy</code> (v2)</dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: "copy-files"</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>A string parameter allowing users to specify one of several different backup "strategies". +Valid options are <code>copy-files</code> (which backs up both the collection configset and index data), and <code>none</code> (which will only backup the collection configset).</p> +</div> +</dd> +<dt class="hdlist1"><code>commitName</code> (v1), <code>snapshotName</code> (v2)</dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: none</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>The name of a the collection "snapshot" to create a backup from. +If not provided, Solr will create the backup from the current collection state (instead of a previous snapshotted state).</p> </div> </dd> </dl> @@ -3693,7 +3768,7 @@ Basic metadata is returned about each ba </td> <td class="content"> <div class="paragraph"> -<p>Previous versions of Solr supported a different snapshot-based backup file structure that did not support the storage of multiple backups at the same location. +<p>Previous versions of Solr supported a different backup file structure that did not support the storage of multiple backups at the same location. Solr can still restore backups stored in this old format, but it is deprecated and will be removed in subsequent versions of Solr. The LISTBACKUP API does not support the deprecated format and attempts to use this API on a location holding an older backup will result in an error message.</p> </div> @@ -3821,14 +3896,7 @@ If no repository is specified then the l </div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/v2/collections/backups -H 'Content-Type: application/json' -d ' - { - "list-backups" : { - "name": "myBackupName", - "location": "/path/to/my/shared/drive" - } - } -'</code></pre> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X GET "http://localhost:8983/api/backups/backupName/versions?location=/path/to/my/shared/drive";</code></pre> </div> </div> </div> @@ -3887,7 +3955,7 @@ If no repository is specified then the l </div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">http://localhost:8983/solr/admin/collections?action=RESTORE&name=techproducts_backup&location=file:///path/to/my/shared/drive&collection=techproducts_v3</code></pre> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X GET http://localhost:8983/solr/admin/collections?action=RESTORE&name=techproducts_backup&location=file:///path/to/my/shared/drive&collection=techproducts_v3&nrtReplicas=2&createNodeSet=node1,node2&property.foo=bar</code></pre> </div> </div> </div> @@ -3897,18 +3965,19 @@ If no repository is specified then the l <div class="paragraph"> <p><strong class="tab-label">V2 API</strong></p> </div> -<div class="paragraph"> -<p>With the v2 API, the <code>restore-collection</code> command is provided as part of the JSON data that contains the required parameters:</p> -</div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections -H 'Content-Type: application/json' -d ' +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/backups/techproducts_backup/restore -H 'Content-Type: application/json' -d ' { - "restore-collection": { - "name": "techproducts_backup", "collection": "techproducts_v3", - "location": "file:///path/to/my/shared/drive" - } + "location": "file:///path/to/my/shared/drive", + "create-collection": { + "nrtReplicas": 2, + "nodeSet": ["node1", "node2"], + "properties": { + "foo": "bar" + } + } } '</code></pre> </div> @@ -3923,8 +3992,8 @@ If no repository is specified then the l <div class="paragraph"> <p>If the provided <code>collection</code> value matches an existing collection, Solr will use it for restoration, assuming it is compatible (same number of shards, etc.) with the stored backup files. If the provided <code>collection</code> value doesn’t exist, a new collection with that name is created in a way compatible with the stored backup files. -The collection created will be have the same number of shards and replicas as the original collection, preserving routing information, etc. -Optionally, you can override some parameters documented below.</p> +The collection created will have the same number of shards and replicas as the original collection, preserving routing information, etc. +Optionally, you can override some parameters (see below).</p> </div> <div class="paragraph"> <p>While restoring, if a configset with the same name exists in ZooKeeper then Solr will reuse that, or else it will upload the backed up configset in ZooKeeper and use that.</p> @@ -3970,7 +4039,9 @@ This parameter is required.</p> </tbody> </table> <div class="paragraph"> -<p>The name of the existing backup that you want to restore.</p> +<p>The name of the existing backup that you want to restore. +This parameter is required. +Provided as a query-parameter for v1 requests, and in the URL path for v2 requests.</p> </div> </dd> <dt class="hdlist1"><code>location</code></dt> @@ -3988,7 +4059,7 @@ This parameter is required.</p> </tbody> </table> <div class="paragraph"> -<p>The location on a shared drive for the RESTORE command to read from. +<p>The location within a backup repository for the RESTORE command to read from. Alternately it can be set as a <a href="cluster-node-management.html#clusterprop" class="xref page">cluster property</a>.+</p> </div> <div class="paragraph"> @@ -4058,19 +4129,14 @@ If not specified the most recent backup </dl> </div> <div class="paragraph"> -<p>There are also optional parameters that determine the target collection layout. -The following parameters are currently supported (described in detail in the <a href="#create">CREATE collection</a> section): -<code>createNodeSet</code>, <code>createNodeSet.shuffle</code>.</p> -</div> -<div class="paragraph"> -<p>Note: for <code>createNodeSet</code> the special value of <code>EMPTY</code> is not allowed with this command.</p> +<p><strong>Overridable Parameters</strong></p> </div> <div class="paragraph"> -<p><strong>Overridable Parameters</strong></p> +<p>Additionally, users may provide a number of collection creation parameters to be used when the collection being restored to doesn’t already exist. +These include: <code>collection.configName</code>, <code>createNodeSet</code> (<code>EMPTY</code> not supported), <code>createNodeSet.shuffle</code>, <code>nrtReplicas</code>, <code>property.<em>name</em>=<em>value</em></code> (i.e. arbitrary collection properties), <code>pullReplicas</code>, <code>replicationFactor</code>, and <code>tlogReplicas</code>.</p> </div> <div class="paragraph"> -<p>Additionally, there are several parameters that may have been set on the original collection that can be overridden when restoring the backup (described in detail in the <a href="#create">CREATE collection</a> section): -<code>collection.configName</code>, <code>replicationFactor</code>, <code>nrtReplicas</code>, <code>tlogReplicas</code>, <code>pullReplicas</code>, <code>property.<em>name</em>=<em>value</em></code>.</p> +<p>See the <a href="#create">collection creation</a> documentation for more information on each of these parameters and details on their v1 or v2 specific syntaxes.</p> </div> </div> </div> @@ -4089,7 +4155,7 @@ The following parameters are currently s </td> <td class="content"> <div class="paragraph"> -<p>Previous versions of Solr supported a different snapshot-based backup file structure that did not support the storage of multiple backups at the same location. +<p>Previous versions of Solr supported a different backup file structure that did not support the storage of multiple backups at the same location. Solr can still restore backups stored in this old format, but it is deprecated and will be removed in subsequent versions of Solr. The DELETEBACKUP API does not support the deprecated format and attempts to use this API on a location holding an older backup will result in an error message.</p> </div> @@ -4099,23 +4165,25 @@ The DELETEBACKUP API does not support th </div> <div class="paragraph"> <p>Solr allows storing multiple backups for the same collection at any given logical "location". -These backup points are each given an identifier (<code>backupId</code>) which can be used to delete them specifically with this API. +These backup points are each given an identifier (<code>backupId</code>) which can be used to delete them individually with this API. Alternatively Solr can be told to keep the last <code>maxNumBackupPoints</code> backups, deleting everything else at the given location. Deleting backup points in these ways can orphan index files that are no longer referenced by any backup points. -These orphaned files can be detected and deleted using the <code>purgeUnused</code> option. -See the parameter descriptions below for more information.</p> +These orphaned files can be detected and deleted using the <code>purgeUnused</code> option.</p> </div> -<div class="sect2"> -<h3 id="deletebackup-example"><a class="anchor" href="#deletebackup-example"></a>DELETEBACKUP Example</h3> <div class="paragraph"> -<p><strong>Input</strong></p> +<p>Alternately, Solr’s v2 API offers separate API endpoints for each of these backup-deletion mechanisms. +See the examples and parameter descriptions below for more information.</p> </div> +<div class="sect2"> +<h3 id="deletebackup-examples"><a class="anchor" href="#deletebackup-examples"></a>DELETEBACKUP Examples</h3> +<div class="sect3"> +<h4 id="deleting-by-backup-id"><a class="anchor" href="#deleting-by-backup-id"></a>Deleting by Backup ID</h4> <div class="paragraph"> -<p>The following API command deletes the first backup (<code>backupId=0</code>) at the specified repository location.</p> +<p><strong>Input</strong></p> </div> <div class="openblock dynamic-tabs"> <div class="content"> -<div id="v1deletebackup" class="exampleblock tab-pane"> +<div id="v1deletebackupsingle" class="exampleblock tab-pane"> <div class="content"> <div class="paragraph"> <p><strong class="tab-label">V1 API</strong></p> @@ -4127,22 +4195,14 @@ See the parameter descriptions below for </div> </div> </div> -<div id="v2deletebackup" class="exampleblock tab-pane"> +<div id="v2deletebackupsingle" class="exampleblock tab-pane"> <div class="content"> <div class="paragraph"> <p><strong class="tab-label">V2 API</strong></p> </div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/v2/collections/backups -H 'Content-Type: application/json' -d ' - { - "delete-backups" : { - "name": "myBackupName", - "location": "/path/to/my/shared/drive", - "backupId": 0 - } - } -'</code></pre> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X DELETE "http://localhost:8983/api/backups/myBackupName/versions/0?location=/path/to/my/shared/drive";</code></pre> </div> </div> </div> @@ -4167,6 +4227,73 @@ See the parameter descriptions below for </div> </div> </div> +<div class="sect3"> +<h4 id="deleting-all-but-n-recent-backups"><a class="anchor" href="#deleting-all-but-n-recent-backups"></a>Deleting all but N recent backups</h4> +<div class="openblock dynamic-tabs"> +<div class="content"> +<div id="v1deletebackupmulti" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V1 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">http://localhost:8983/solr/admin/collections?action=DELETEBACKUP&name=myBackupName&location=/path/to/my/shared/drive&maxNumBackupsPoints=2</code></pre> +</div> +</div> +</div> +</div> +<div id="v2deletebackupmulti" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V2 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X DELETE "http://localhost:8983/api/backups/myBackupName/versions?retainLatest=2&location=/path/to/my/shared/drive";</code></pre> +</div> +</div> +</div> +</div> +</div> +</div> +</div> +<div class="sect3"> +<h4 id="garbage-collecting-unused-files"><a class="anchor" href="#garbage-collecting-unused-files"></a>"Garbage collecting" unused files</h4> +<div class="openblock dynamic-tabs"> +<div class="content"> +<div id="v1deletebackupgc" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V1 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">http://localhost:8983/solr/admin/collections?action=DELETEBACKUP&name=myBackupName&location=/path/to/my/shared/drive&purgeUnused=true</code></pre> +</div> +</div> +</div> +</div> +<div id="v2deletebackupgc" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V2 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X PUT -H "Content-type: application/json" "http://localhost:8983/api/backups/myBackupName/purgeUnused"; ' + { + "location": "/path/to/my/shared/drive" + } +'</code></pre> +</div> +</div> +</div> +</div> +</div> +</div> +</div> +</div> <div class="sect2"> <h3 id="deletebackup-parameters"><a class="anchor" href="#deletebackup-parameters"></a>DELETEBACKUP Parameters</h3> <div class="dlist"> @@ -4186,7 +4313,8 @@ See the parameter descriptions below for </tbody> </table> <div class="paragraph"> -<p>The backup name to delete backup files from.</p> +<p>The backup name to delete backup files from. +Provided as a query parameter in v1 requests, and as a path parameter in v2 requests.</p> </div> </dd> <dt class="hdlist1"><code>location</code></dt> @@ -4250,10 +4378,11 @@ If no repository is specified then the l </table> <div class="paragraph"> <p>Explicitly specify a single backup-ID to delete. -Only one of <code>backupId</code>, <code>maxNumBackupPoints</code>, and <code>purgeUnused</code> may be specified per DELETEBACKUP request.</p> +Only one of <code>backupId</code>, <code>maxNumBackupPoints</code>, and <code>purgeUnused</code> may be specified per v1 DELETEBACKUP request. +Provided as a query parameter in v1 requests, and as a path parameter in v2 requests.</p> </div> </dd> -<dt class="hdlist1"><code>maxNumBackupPoints</code></dt> +<dt class="hdlist1"><code>maxNumBackupPoints</code> (v1), <code>retainLatest</code> (v2)</dt> <dd> <table class="tableblock frame-none grid-all fit-content"> <colgroup> @@ -4268,7 +4397,8 @@ Only one of <code>backupId</code>, <code </tbody> </table> <div class="paragraph"> -<p>Specify how many backups should be retained, deleting all others. +<p>TODO +Specify how many backups should be retained, deleting all others. Only one of <code>backupId</code>, <code>maxNumBackupPoints</code>, and <code>purgeUnused</code> may be specified per DELETEBACKUP request.</p> </div> </dd> @@ -4290,7 +4420,7 @@ Only one of <code>backupId</code>, <code <p>Solr’s incremental backup support can orphan files if the backups referencing them are deleted. The <code>purgeUnused</code> flag parameter triggers a scan to detect these orphaned files and delete them. Administrators doing repeated backups at the same location should plan on using this parameter sporadically to reclaim disk space. -Only one of <code>backupId</code>, <code>maxNumBackupPoints</code>, and <code>purgeUnused</code> may be specified per DELETEBACKUP request.</p> +Only one of <code>backupId</code>, <code>maxNumBackupPoints</code>, and <code>purgeUnused</code> may be specified per v1 DELETEBACKUP request.</p> </div> </dd> <dt class="hdlist1"><code>async</code></dt> @@ -4531,6 +4661,456 @@ The BALANCESHARDUNIQUE command that dist </div> </div> </div> +</div> +<div class="sect1"> +<h2 id="createsnapshot"><a class="anchor" href="#createsnapshot"></a>CREATESNAPSHOT: Create a snapshot of a collection</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Solr has support for creating collection "snapshots", which "checkpoint" the collection state in a way that allows users to revert to that point if needed later on. +This is particularly useful prior to reindexing or making config changes to a collection.</p> +</div> +<div class="paragraph"> +<p>Unlike backups, which copy collection data off-disk, snapshots themselves don’t provide disaster recovery in case of disk or hardware failure. +They provide less protection than backups, at a much cheaper cost.</p> +</div> +<div class="sect2"> +<h3 id="createsnapshot-example"><a class="anchor" href="#createsnapshot-example"></a>CREATESNAPSHOT Example</h3> +<div class="paragraph"> +<p><strong>Input</strong></p> +</div> +<div class="paragraph"> +<p>The following API command creates a snapshot of a specified collection.</p> +</div> +<div class="openblock dynamic-tabs"> +<div class="content"> +<div id="v1createsnapshot" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V1 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">http://localhost:8983/solr/admin/collections?action=CREATESNAPSHOT&collection=techproducts&commitName=snapshot0&followAliases=true&async=someAsyncId</code></pre> +</div> +</div> +</div> +</div> +<div id="v2createsnapshot" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V2 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X POST http://localhost:8983/api/collections/techproducts/snapshots/snapshot0 -H 'Content-Type: application/json' -d ' + { + "followAliases": true, + "async": "someAsyncId" + } +'</code></pre> +</div> +</div> +</div> +</div> +</div> +</div> +<div class="paragraph"> +<p><strong>Output</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ + "responseHeader": { + "status": 0, + "QTime": 214 + }, + "requestid": "someAsyncId", + "collection": "techproducts", + "snapshot": "snapshot0", + "followAliases": true +}</code></pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="createsnapshot-parameters"><a class="anchor" href="#createsnapshot-parameters"></a>CREATESNAPSHOT Parameters</h3> +<div class="dlist"> +<dl> +<dt class="hdlist1"><code>collection</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required</strong></p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: none</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>The name of the collection to create a snapshot for.</p> +</div> +</dd> +<dt class="hdlist1"><code>snapshot</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required</strong></p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: none</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>The name of the snapshot to create for the collection.</p> +</div> +</dd> +<dt class="hdlist1"><code>followAliases</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: false</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>A flag that treats the collection parameter as an alias for the actual collection name to be resolved.</p> +</div> +</dd> +<dt class="hdlist1"><code>async</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: none</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>Request ID to track this action which will be <a href="../configuration-guide/collections-api.html#asynchronous-calls" class="xref page">processed asynchronously</a>.</p> +</div> +</dd> +</dl> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="listsnapshots"><a class="anchor" href="#listsnapshots"></a>LISTSNAPSHOTS: List all snapshots for a collection</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Lists all the snapshots taken of a collection.</p> +</div> +<div class="sect2"> +<h3 id="listsnapshots-example"><a class="anchor" href="#listsnapshots-example"></a>LISTSNAPSHOTS Example</h3> +<div class="paragraph"> +<p><strong>Input</strong></p> +</div> +<div class="paragraph"> +<p>The following API command lists all the snapshots taken of a collection.</p> +</div> +<div class="openblock dynamic-tabs"> +<div class="content"> +<div id="v1listsnapshots" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V1 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">http://localhost:8983/solr/admin/collections?action=LISTSNAPSHOTS&collection=techproducts</code></pre> +</div> +</div> +</div> +</div> +<div id="v2listsnapshots" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V2 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X GET http://localhost:8983/api/collections/techproducts/snapshots</code></pre> +</div> +</div> +</div> +</div> +</div> +</div> +<div class="paragraph"> +<p><strong>Output</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ + "responseHeader": { + "status": 0, + "QTime": 2 + }, + "snapshots": { + "snapshot0": { + "name": "snapshot0", + "status": "Successful", + "creationDate": 1677985318116, + "replicaSnapshots": [ + { + "coreName": "techproducts_shard1_replica_n6", + "indexDirPath": "/path/to/solr/dir/node1/solr/techproducts_shard1_replica_n6/data/index/", + "generationNumber": 2, + "leader": true, + "shardId": "shard1", + "files": [ + "_0.si", + "_0.fdm", + "_0_Lucene90_0.dvd", + "segments_2", + "_0_Lucene90_0.doc", + "_0_Lucene90_0.tim", + "_0.fdx", + "_0.fdt", + "_0_Lucene90_0.dvm", + "_0_Lucene90_0.tip", + "_0_Lucene90_0.tmd", + "_0.fnm" + ] + }, + { + "coreName": "techproducts_shard1_replica_n2", + "indexDirPath": "/path/to/solr/dir/node2/solr/techproducts_shard1_replica_n2/data/index/", + "generationNumber": 2, + "leader": false, + "shardId": "shard1", + "files": [ + "_0.si", + "_0.fdm", + "_0_Lucene90_0.dvd", + "segments_2", + "_0_Lucene90_0.doc", + "_0_Lucene90_0.tim", + "_0.fdx", + "_0.fdt", + "_0_Lucene90_0.dvm", + "_0_Lucene90_0.tip", + "_0_Lucene90_0.tmd", + "_0.fnm" + ] + }, + { + "coreName": "techproducts_shard2_replica_n4", + "indexDirPath": "/path/to/solr/dir/node1/solr/techproducts_shard2_replica_n4/data/index/", + "generationNumber": 6, + "leader": true, + "shardId": "shard2", + "files": [ + "segments_6" + ] + }, + { + "coreName": "techproducts_shard2_replica_n1", + "indexDirPath": "/path/to/solr/dir/node2/solr/techproducts_shard2_replica_n1/data/index/", + "generationNumber": 6, + "leader": false, + "shardId": "shard2", + "files": [ + "segments_6" + ] + } + ], + "shards": [ + "shard2", + "shard1" + ] + } + } +}</code></pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="listsnapshots-parameters"><a class="anchor" href="#listsnapshots-parameters"></a>LISTSNAPSHOTS Parameters</h3> +<div class="dlist"> +<dl> +<dt class="hdlist1"><code>collection</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required</strong></p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: none</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>The name of the collection to create a snapshot for.</p> +</div> +</dd> +</dl> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="deletesnapshot"><a class="anchor" href="#deletesnapshot"></a>DELETESNAPSHOT: Delete a snapshot taken of a collection</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Deletes a snapshot taken of a specified collection.</p> +</div> +<div class="sect2"> +<h3 id="deletesnapshot-example"><a class="anchor" href="#deletesnapshot-example"></a>DELETESNAPSHOT Example</h3> +<div class="paragraph"> +<p><strong>Input</strong></p> +</div> +<div class="paragraph"> +<p>The following API command deletes a snapshot taken of a collection.</p> +</div> +<div class="openblock dynamic-tabs"> +<div class="content"> +<div id="v1deletesnapshot" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V1 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">http://localhost:8983/solr/admin/collections?action=DELETESNAPSHOT&collection=techproducts&commitName=snapshot0&followAliases=true&async=someAsyncId</code></pre> +</div> +</div> +</div> +</div> +<div id="v2deletesnapshot" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V2 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X DELETE http://localhost:8983/api/collections/techproducts/snapshots/snapshot0?followAliases=true&async=someAsyncId</code></pre> +</div> +</div> +</div> +</div> +</div> +</div> +<div class="paragraph"> +<p><strong>Output</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ + "responseHeader": { + "status": 0, + "QTime": 20 + }, + "requestid": "someAsyncId", + "collection": "techproducts", + "snapshot": "snapshot0", + "followAliases": true +}</code></pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="deletesnapshot-parameters"><a class="anchor" href="#deletesnapshot-parameters"></a>DELETESNAPSHOT Parameters</h3> +<div class="dlist"> +<dl> +<dt class="hdlist1"><code>collection</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required</strong></p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: none</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>The name of the collection to delete a snapshot from.</p> +</div> +</dd> +<dt class="hdlist1"><code>snapshot</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required</strong></p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: none</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>The name of the snapshot to delete.</p> +</div> +</dd> +<dt class="hdlist1"><code>followAliases</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: false</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>A flag that treats the collectionName parameter as an alias for the actual collection name to be resolved.</p> +</div> +</dd> +<dt class="hdlist1"><code>async</code></dt> +<dd> +<table class="tableblock frame-none grid-all fit-content"> +<colgroup> +<col> +<col> +</colgroup> +<tbody> +<tr> +<td class="tableblock halign-left valign-top"><p class="tableblock">Optional</p></td> +<td class="tableblock halign-left valign-top"><p class="tableblock">Default: none</p></td> +</tr> +</tbody> +</table> +<div class="paragraph"> +<p>Request ID to track this action which will be <a href="../configuration-guide/collections-api.html#asynchronous-calls" class="xref page">processed asynchronously</a>.</p> +</div> +</dd> +</dl> +</div> +</div> +</div> </div> </article> </div>
Modified: sites/solr/guide/solr/latest/deployment-guide/collections-core-admin.html URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/latest/deployment-guide/collections-core-admin.html?rev=1083697&r1=1083696&r2=1083697&view=diff ============================================================================== --- sites/solr/guide/solr/latest/deployment-guide/collections-core-admin.html (original) +++ sites/solr/guide/solr/latest/deployment-guide/collections-core-admin.html Fri Jul 21 18:07:42 2023 @@ -39,7 +39,7 @@ <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="#">Resources</a> <div class="navbar-dropdown"> - <a class="navbar-item" href="https://solr.apache.org/docs/9_2_1/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> + <a class="navbar-item" href="https://solr.apache.org/docs/9_3_0/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> <a class="navbar-item" href="https://solr.apache.org/community.html#version-control"; target="_blank" rel="noreferrer nopener">Source Code</a> <a class="navbar-item" href="https://solr.apache.org/community.html"; target="_blank" rel="noreferrer nopener">Community Links</a> <a class="navbar-item" href="https://github.com/apache/solr/tree/main/dev-docs/ref-guide"; target="_blank" rel="noreferrer nopener">Contribute</a> @@ -56,25 +56,25 @@ </nav> </header> <div class="body"> -<div class="nav-container" data-component="solr" data-version="9_2"> +<div class="nav-container" data-component="solr" data-version="9_3"> <aside class="nav"> <div class="panels"> <!-- Solr Changes - Start --> <div class="nav-panel-explore" data-panel="explore"> <div class="context"> <span class="title">Solr Reference Guide</span> - <span class="version">9.2</span> + <span class="version">9.3</span> </div> <!-- Programmatically creates the component and version list --> <ul class="components"> <li class="component is-current"> <a class="title" href="../index.html">Solr Reference Guide</a> <ul class="versions"> - <li class="version"> - <a href="../../9_3/index.html">9.3-beta</a> - </li> <li class="version is-current is-latest"> - <a href="../index.html">9.2</a> + <a href="../index.html">9.3</a> + </li> + <li class="version"> + <a href="../../9_2/index.html">9.2</a> </li> <li class="version"> <a href="../../9_1/index.html">9.1</a> @@ -211,7 +211,7 @@ <a class="nav-link" href="../getting-started/tutorial-films.html">Exercise 2: Index Films Data</a> </li> <li class="nav-item" data-depth="2"> - <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3 Index Your Own Data</a> + <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3: Index Your Own Data</a> </li> <li class="nav-item" data-depth="2"> <a class="nav-link" href="../getting-started/tutorial-solrcloud.html">Getting Started with SolrCloud</a> @@ -718,6 +718,9 @@ </ul> </li> <li class="nav-item" data-depth="2"> + <a class="nav-link" href="../indexing-guide/indexing-with-cbor.html">Indexing with Update CBOR data format</a> + </li> + <li class="nav-item" data-depth="2"> <a class="nav-link" href="../indexing-guide/indexing-with-tika.html">Indexing with Solr Cell and Apache Tika</a> </li> <li class="nav-item" data-depth="2"> @@ -1072,17 +1075,17 @@ </ul> </nav> <div class="page-versions"> - <button class="version-menu-toggle" title="Show other versions of page">9.2</button> + <button class="version-menu-toggle" title="Show other versions of page">9.3</button> <div class="version-menu"> - <a class="version" href="../../9_3/deployment-guide/collections-core-admin.html">9.3-beta</a> - <a class="version is-current" href="collections-core-admin.html">9.2</a> + <a class="version is-current" href="collections-core-admin.html">9.3</a> + <a class="version" href="../../9_2/deployment-guide/collections-core-admin.html">9.2</a> <a class="version" href="../../9_1/deployment-guide/collections-core-admin.html">9.1</a> <a class="version" href="../../9_0/deployment-guide/collections-core-admin.html">9.0</a> </div> </div> <!-- Solr Additions - Start --> <!-- Solr New File --> -<span class="perma-link-copy" version="9_2"> +<span class="perma-link-copy" version="9_3"> </span><!-- Solr Additions - End --> <div class="edit-this-page"><a href="https://github.com/apache/solr/tree/main/solr/solr-ref-guide/modules/deployment-guide/pages/collections-core-admin.adoc";>Edit this Page</a></div> </div> Modified: sites/solr/guide/solr/latest/deployment-guide/configuring-logging.html URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/latest/deployment-guide/configuring-logging.html?rev=1083697&r1=1083696&r2=1083697&view=diff ============================================================================== --- sites/solr/guide/solr/latest/deployment-guide/configuring-logging.html (original) +++ sites/solr/guide/solr/latest/deployment-guide/configuring-logging.html Fri Jul 21 18:07:42 2023 @@ -39,7 +39,7 @@ <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="#">Resources</a> <div class="navbar-dropdown"> - <a class="navbar-item" href="https://solr.apache.org/docs/9_2_1/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> + <a class="navbar-item" href="https://solr.apache.org/docs/9_3_0/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> <a class="navbar-item" href="https://solr.apache.org/community.html#version-control"; target="_blank" rel="noreferrer nopener">Source Code</a> <a class="navbar-item" href="https://solr.apache.org/community.html"; target="_blank" rel="noreferrer nopener">Community Links</a> <a class="navbar-item" href="https://github.com/apache/solr/tree/main/dev-docs/ref-guide"; target="_blank" rel="noreferrer nopener">Contribute</a> @@ -56,25 +56,25 @@ </nav> </header> <div class="body"> -<div class="nav-container" data-component="solr" data-version="9_2"> +<div class="nav-container" data-component="solr" data-version="9_3"> <aside class="nav"> <div class="panels"> <!-- Solr Changes - Start --> <div class="nav-panel-explore" data-panel="explore"> <div class="context"> <span class="title">Solr Reference Guide</span> - <span class="version">9.2</span> + <span class="version">9.3</span> </div> <!-- Programmatically creates the component and version list --> <ul class="components"> <li class="component is-current"> <a class="title" href="../index.html">Solr Reference Guide</a> <ul class="versions"> - <li class="version"> - <a href="../../9_3/index.html">9.3-beta</a> - </li> <li class="version is-current is-latest"> - <a href="../index.html">9.2</a> + <a href="../index.html">9.3</a> + </li> + <li class="version"> + <a href="../../9_2/index.html">9.2</a> </li> <li class="version"> <a href="../../9_1/index.html">9.1</a> @@ -211,7 +211,7 @@ <a class="nav-link" href="../getting-started/tutorial-films.html">Exercise 2: Index Films Data</a> </li> <li class="nav-item" data-depth="2"> - <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3 Index Your Own Data</a> + <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3: Index Your Own Data</a> </li> <li class="nav-item" data-depth="2"> <a class="nav-link" href="../getting-started/tutorial-solrcloud.html">Getting Started with SolrCloud</a> @@ -718,6 +718,9 @@ </ul> </li> <li class="nav-item" data-depth="2"> + <a class="nav-link" href="../indexing-guide/indexing-with-cbor.html">Indexing with Update CBOR data format</a> + </li> + <li class="nav-item" data-depth="2"> <a class="nav-link" href="../indexing-guide/indexing-with-tika.html">Indexing with Solr Cell and Apache Tika</a> </li> <li class="nav-item" data-depth="2"> @@ -1070,17 +1073,17 @@ </ul> </nav> <div class="page-versions"> - <button class="version-menu-toggle" title="Show other versions of page">9.2</button> + <button class="version-menu-toggle" title="Show other versions of page">9.3</button> <div class="version-menu"> - <a class="version" href="../../9_3/deployment-guide/configuring-logging.html">9.3-beta</a> - <a class="version is-current" href="configuring-logging.html">9.2</a> + <a class="version is-current" href="configuring-logging.html">9.3</a> + <a class="version" href="../../9_2/deployment-guide/configuring-logging.html">9.2</a> <a class="version" href="../../9_1/deployment-guide/configuring-logging.html">9.1</a> <a class="version" href="../../9_0/deployment-guide/configuring-logging.html">9.0</a> </div> </div> <!-- Solr Additions - Start --> <!-- Solr New File --> -<span class="perma-link-copy" version="9_2"> +<span class="perma-link-copy" version="9_3"> </span><!-- Solr Additions - End --> <div class="edit-this-page"><a href="https://github.com/apache/solr/tree/main/solr/solr-ref-guide/modules/deployment-guide/pages/configuring-logging.adoc";>Edit this Page</a></div> </div> @@ -1213,10 +1216,36 @@ Select the button next to your desired l <div class="paragraph"> <p>Example:</p> </div> +<div class="openblock dynamic-tabs"> +<div class="content"> +<div id="v1createcollection" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V1 API</strong></p> +</div> <div class="listingblock"> <div class="content"> -<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Set the root logger to level WARN -curl -s http://localhost:8983/solr/admin/info/logging --data-binary "set=root:WARN"</code></pre> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X GET "http://localhost:8983/solr/admin/info/logging?set=root:WARN";</code></pre> +</div> +</div> +</div> +</div> +<div id="v2createcollection" class="exampleblock tab-pane"> +<div class="content"> +<div class="paragraph"> +<p><strong class="tab-label">V2 API</strong></p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X PUT http://localhost:8983/api/node/logging/levels -H 'Content-Type: application/json' -d ' + [ + {"logger": "root", "level": "WARN"} + ] +'</code></pre> +</div> +</div> +</div> +</div> </div> </div> </div> @@ -1316,6 +1345,27 @@ See the section on <a href="../query-gui </div> </div> </div> +<div class="sect1"> +<h2 id="selective-logging-on-solrcore"><a class="anchor" href="#selective-logging-on-solrcore"></a>Selective Logging on SolrCore</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Solr logs all core requests at INFO level using the o.a.s.c.SolrCore.Request. This can be disabled entirely by changing the level of these loggers to WARN or ERROR, or more selectively by using the <code>MarkerFilter</code> on request paths in <code>log4j2.xml</code>.</p> +</div> +<div class="paragraph"> +<p>For example:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><Logger name="org.apache.solr.core.SolrCore.Request" level="info"> + <Filters> + <MarkerFilter marker="/get" onMatch="DENY" onMismatch="NEUTRAL"/> + <MarkerFilter marker="/replication" onMatch="DENY" onMismatch="NEUTRAL"/> + </Filters> +</Logger></code></pre> +</div> +</div> +</div> +</div> <div class="sect1"> <h2 id="request-logging"><a class="anchor" href="#request-logging"></a>Request Logging</h2> <div class="sectionbody"> Modified: sites/solr/guide/solr/latest/deployment-guide/distributed-tracing.html URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/latest/deployment-guide/distributed-tracing.html?rev=1083697&r1=1083696&r2=1083697&view=diff ============================================================================== --- sites/solr/guide/solr/latest/deployment-guide/distributed-tracing.html (original) +++ sites/solr/guide/solr/latest/deployment-guide/distributed-tracing.html Fri Jul 21 18:07:42 2023 @@ -39,7 +39,7 @@ <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="#">Resources</a> <div class="navbar-dropdown"> - <a class="navbar-item" href="https://solr.apache.org/docs/9_2_1/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> + <a class="navbar-item" href="https://solr.apache.org/docs/9_3_0/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> <a class="navbar-item" href="https://solr.apache.org/community.html#version-control"; target="_blank" rel="noreferrer nopener">Source Code</a> <a class="navbar-item" href="https://solr.apache.org/community.html"; target="_blank" rel="noreferrer nopener">Community Links</a> <a class="navbar-item" href="https://github.com/apache/solr/tree/main/dev-docs/ref-guide"; target="_blank" rel="noreferrer nopener">Contribute</a> @@ -56,25 +56,25 @@ </nav> </header> <div class="body"> -<div class="nav-container" data-component="solr" data-version="9_2"> +<div class="nav-container" data-component="solr" data-version="9_3"> <aside class="nav"> <div class="panels"> <!-- Solr Changes - Start --> <div class="nav-panel-explore" data-panel="explore"> <div class="context"> <span class="title">Solr Reference Guide</span> - <span class="version">9.2</span> + <span class="version">9.3</span> </div> <!-- Programmatically creates the component and version list --> <ul class="components"> <li class="component is-current"> <a class="title" href="../index.html">Solr Reference Guide</a> <ul class="versions"> - <li class="version"> - <a href="../../9_3/index.html">9.3-beta</a> - </li> <li class="version is-current is-latest"> - <a href="../index.html">9.2</a> + <a href="../index.html">9.3</a> + </li> + <li class="version"> + <a href="../../9_2/index.html">9.2</a> </li> <li class="version"> <a href="../../9_1/index.html">9.1</a> @@ -211,7 +211,7 @@ <a class="nav-link" href="../getting-started/tutorial-films.html">Exercise 2: Index Films Data</a> </li> <li class="nav-item" data-depth="2"> - <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3 Index Your Own Data</a> + <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3: Index Your Own Data</a> </li> <li class="nav-item" data-depth="2"> <a class="nav-link" href="../getting-started/tutorial-solrcloud.html">Getting Started with SolrCloud</a> @@ -718,6 +718,9 @@ </ul> </li> <li class="nav-item" data-depth="2"> + <a class="nav-link" href="../indexing-guide/indexing-with-cbor.html">Indexing with Update CBOR data format</a> + </li> + <li class="nav-item" data-depth="2"> <a class="nav-link" href="../indexing-guide/indexing-with-tika.html">Indexing with Solr Cell and Apache Tika</a> </li> <li class="nav-item" data-depth="2"> @@ -1070,17 +1073,17 @@ </ul> </nav> <div class="page-versions"> - <button class="version-menu-toggle" title="Show other versions of page">9.2</button> + <button class="version-menu-toggle" title="Show other versions of page">9.3</button> <div class="version-menu"> - <a class="version" href="../../9_3/deployment-guide/distributed-tracing.html">9.3-beta</a> - <a class="version is-current" href="distributed-tracing.html">9.2</a> + <a class="version is-current" href="distributed-tracing.html">9.3</a> + <a class="version" href="../../9_2/deployment-guide/distributed-tracing.html">9.2</a> <a class="version" href="../../9_1/deployment-guide/distributed-tracing.html">9.1</a> <a class="version" href="../../9_0/deployment-guide/distributed-tracing.html">9.0</a> </div> </div> <!-- Solr Additions - Start --> <!-- Solr New File --> -<span class="perma-link-copy" version="9_2"> +<span class="perma-link-copy" version="9_3"> </span><!-- Solr Additions - End --> <div class="edit-this-page"><a href="https://github.com/apache/solr/tree/main/solr/solr-ref-guide/modules/deployment-guide/pages/distributed-tracing.adoc";>Edit this Page</a></div> </div> Modified: sites/solr/guide/solr/latest/deployment-guide/docker-faq.html URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/latest/deployment-guide/docker-faq.html?rev=1083697&r1=1083696&r2=1083697&view=diff ============================================================================== --- sites/solr/guide/solr/latest/deployment-guide/docker-faq.html (original) +++ sites/solr/guide/solr/latest/deployment-guide/docker-faq.html Fri Jul 21 18:07:42 2023 @@ -39,7 +39,7 @@ <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="#">Resources</a> <div class="navbar-dropdown"> - <a class="navbar-item" href="https://solr.apache.org/docs/9_2_1/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> + <a class="navbar-item" href="https://solr.apache.org/docs/9_3_0/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> <a class="navbar-item" href="https://solr.apache.org/community.html#version-control"; target="_blank" rel="noreferrer nopener">Source Code</a> <a class="navbar-item" href="https://solr.apache.org/community.html"; target="_blank" rel="noreferrer nopener">Community Links</a> <a class="navbar-item" href="https://github.com/apache/solr/tree/main/dev-docs/ref-guide"; target="_blank" rel="noreferrer nopener">Contribute</a> @@ -56,25 +56,25 @@ </nav> </header> <div class="body"> -<div class="nav-container" data-component="solr" data-version="9_2"> +<div class="nav-container" data-component="solr" data-version="9_3"> <aside class="nav"> <div class="panels"> <!-- Solr Changes - Start --> <div class="nav-panel-explore" data-panel="explore"> <div class="context"> <span class="title">Solr Reference Guide</span> - <span class="version">9.2</span> + <span class="version">9.3</span> </div> <!-- Programmatically creates the component and version list --> <ul class="components"> <li class="component is-current"> <a class="title" href="../index.html">Solr Reference Guide</a> <ul class="versions"> - <li class="version"> - <a href="../../9_3/index.html">9.3-beta</a> - </li> <li class="version is-current is-latest"> - <a href="../index.html">9.2</a> + <a href="../index.html">9.3</a> + </li> + <li class="version"> + <a href="../../9_2/index.html">9.2</a> </li> <li class="version"> <a href="../../9_1/index.html">9.1</a> @@ -211,7 +211,7 @@ <a class="nav-link" href="../getting-started/tutorial-films.html">Exercise 2: Index Films Data</a> </li> <li class="nav-item" data-depth="2"> - <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3 Index Your Own Data</a> + <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3: Index Your Own Data</a> </li> <li class="nav-item" data-depth="2"> <a class="nav-link" href="../getting-started/tutorial-solrcloud.html">Getting Started with SolrCloud</a> @@ -718,6 +718,9 @@ </ul> </li> <li class="nav-item" data-depth="2"> + <a class="nav-link" href="../indexing-guide/indexing-with-cbor.html">Indexing with Update CBOR data format</a> + </li> + <li class="nav-item" data-depth="2"> <a class="nav-link" href="../indexing-guide/indexing-with-tika.html">Indexing with Solr Cell and Apache Tika</a> </li> <li class="nav-item" data-depth="2"> @@ -1071,17 +1074,17 @@ </ul> </nav> <div class="page-versions"> - <button class="version-menu-toggle" title="Show other versions of page">9.2</button> + <button class="version-menu-toggle" title="Show other versions of page">9.3</button> <div class="version-menu"> - <a class="version" href="../../9_3/deployment-guide/docker-faq.html">9.3-beta</a> - <a class="version is-current" href="docker-faq.html">9.2</a> + <a class="version is-current" href="docker-faq.html">9.3</a> + <a class="version" href="../../9_2/deployment-guide/docker-faq.html">9.2</a> <a class="version" href="../../9_1/deployment-guide/docker-faq.html">9.1</a> <a class="version" href="../../9_0/deployment-guide/docker-faq.html">9.0</a> </div> </div> <!-- Solr Additions - Start --> <!-- Solr New File --> -<span class="perma-link-copy" version="9_2"> +<span class="perma-link-copy" version="9_3"> </span><!-- Solr Additions - End --> <div class="edit-this-page"><a href="https://github.com/apache/solr/tree/main/solr/solr-ref-guide/modules/deployment-guide/pages/docker-faq.adoc";>Edit this Page</a></div> </div> Modified: sites/solr/guide/solr/latest/deployment-guide/docker-networking.html URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/latest/deployment-guide/docker-networking.html?rev=1083697&r1=1083696&r2=1083697&view=diff ============================================================================== --- sites/solr/guide/solr/latest/deployment-guide/docker-networking.html (original) +++ sites/solr/guide/solr/latest/deployment-guide/docker-networking.html Fri Jul 21 18:07:42 2023 @@ -39,7 +39,7 @@ <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="#">Resources</a> <div class="navbar-dropdown"> - <a class="navbar-item" href="https://solr.apache.org/docs/9_2_1/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> + <a class="navbar-item" href="https://solr.apache.org/docs/9_3_0/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> <a class="navbar-item" href="https://solr.apache.org/community.html#version-control"; target="_blank" rel="noreferrer nopener">Source Code</a> <a class="navbar-item" href="https://solr.apache.org/community.html"; target="_blank" rel="noreferrer nopener">Community Links</a> <a class="navbar-item" href="https://github.com/apache/solr/tree/main/dev-docs/ref-guide"; target="_blank" rel="noreferrer nopener">Contribute</a> @@ -56,25 +56,25 @@ </nav> </header> <div class="body"> -<div class="nav-container" data-component="solr" data-version="9_2"> +<div class="nav-container" data-component="solr" data-version="9_3"> <aside class="nav"> <div class="panels"> <!-- Solr Changes - Start --> <div class="nav-panel-explore" data-panel="explore"> <div class="context"> <span class="title">Solr Reference Guide</span> - <span class="version">9.2</span> + <span class="version">9.3</span> </div> <!-- Programmatically creates the component and version list --> <ul class="components"> <li class="component is-current"> <a class="title" href="../index.html">Solr Reference Guide</a> <ul class="versions"> - <li class="version"> - <a href="../../9_3/index.html">9.3-beta</a> - </li> <li class="version is-current is-latest"> - <a href="../index.html">9.2</a> + <a href="../index.html">9.3</a> + </li> + <li class="version"> + <a href="../../9_2/index.html">9.2</a> </li> <li class="version"> <a href="../../9_1/index.html">9.1</a> @@ -211,7 +211,7 @@ <a class="nav-link" href="../getting-started/tutorial-films.html">Exercise 2: Index Films Data</a> </li> <li class="nav-item" data-depth="2"> - <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3 Index Your Own Data</a> + <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3: Index Your Own Data</a> </li> <li class="nav-item" data-depth="2"> <a class="nav-link" href="../getting-started/tutorial-solrcloud.html">Getting Started with SolrCloud</a> @@ -718,6 +718,9 @@ </ul> </li> <li class="nav-item" data-depth="2"> + <a class="nav-link" href="../indexing-guide/indexing-with-cbor.html">Indexing with Update CBOR data format</a> + </li> + <li class="nav-item" data-depth="2"> <a class="nav-link" href="../indexing-guide/indexing-with-tika.html">Indexing with Solr Cell and Apache Tika</a> </li> <li class="nav-item" data-depth="2"> @@ -1071,17 +1074,17 @@ </ul> </nav> <div class="page-versions"> - <button class="version-menu-toggle" title="Show other versions of page">9.2</button> + <button class="version-menu-toggle" title="Show other versions of page">9.3</button> <div class="version-menu"> - <a class="version" href="../../9_3/deployment-guide/docker-networking.html">9.3-beta</a> - <a class="version is-current" href="docker-networking.html">9.2</a> + <a class="version is-current" href="docker-networking.html">9.3</a> + <a class="version" href="../../9_2/deployment-guide/docker-networking.html">9.2</a> <a class="version" href="../../9_1/deployment-guide/docker-networking.html">9.1</a> <a class="version" href="../../9_0/deployment-guide/docker-networking.html">9.0</a> </div> </div> <!-- Solr Additions - Start --> <!-- Solr New File --> -<span class="perma-link-copy" version="9_2"> +<span class="perma-link-copy" version="9_3"> </span><!-- Solr Additions - End --> <div class="edit-this-page"><a href="https://github.com/apache/solr/tree/main/solr/solr-ref-guide/modules/deployment-guide/pages/docker-networking.adoc";>Edit this Page</a></div> </div> @@ -1306,8 +1309,8 @@ ssh -n $ZKSOLR3_HOST "docker exec -i zks <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker exec -it --user=solr zksolr1 bin/post -c my_collection1 example/exampledocs/manufacturers.xml -# /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java -classpath /opt/solr/server/lib/ext/*:/opt/solr/server/solr-webapp/webapp/WEB-INF/lib/* -Dauto=yes -Dc=my_collection1 -Ddata=files org.apache.solr.util.SimplePostTool example/exampledocs/manufacturers.xml -# SimplePostTool version 9.2.1 +# /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java -classpath /opt/solr/server/lib/ext/*:/opt/solr/server/solr-webapp/webapp/WEB-INF/lib/* -Dauto=yes -Dc=my_collection1 -Ddata=files org.apache.solr.cli.SimplePostTool example/exampledocs/manufacturers.xml +# SimplePostTool version 9.3.0 # Posting files to [base] url http://localhost:8983/solr/my_collection1/update... # Entering auto mode. File endings considered are xml,json,csv,pdf,doc,docx,ppt,pptx,xls,xlsx,odt,odp,ods,ott,otp,ots,rtf,htm,html,txt,log # POSTing file manufacturers.xml (application/xml) to [base] Modified: sites/solr/guide/solr/latest/deployment-guide/enabling-ssl.html URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/latest/deployment-guide/enabling-ssl.html?rev=1083697&r1=1083696&r2=1083697&view=diff ============================================================================== --- sites/solr/guide/solr/latest/deployment-guide/enabling-ssl.html (original) +++ sites/solr/guide/solr/latest/deployment-guide/enabling-ssl.html Fri Jul 21 18:07:42 2023 @@ -39,7 +39,7 @@ <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="#">Resources</a> <div class="navbar-dropdown"> - <a class="navbar-item" href="https://solr.apache.org/docs/9_2_1/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> + <a class="navbar-item" href="https://solr.apache.org/docs/9_3_0/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> <a class="navbar-item" href="https://solr.apache.org/community.html#version-control"; target="_blank" rel="noreferrer nopener">Source Code</a> <a class="navbar-item" href="https://solr.apache.org/community.html"; target="_blank" rel="noreferrer nopener">Community Links</a> <a class="navbar-item" href="https://github.com/apache/solr/tree/main/dev-docs/ref-guide"; target="_blank" rel="noreferrer nopener">Contribute</a> @@ -56,25 +56,25 @@ </nav> </header> <div class="body"> -<div class="nav-container" data-component="solr" data-version="9_2"> +<div class="nav-container" data-component="solr" data-version="9_3"> <aside class="nav"> <div class="panels"> <!-- Solr Changes - Start --> <div class="nav-panel-explore" data-panel="explore"> <div class="context"> <span class="title">Solr Reference Guide</span> - <span class="version">9.2</span> + <span class="version">9.3</span> </div> <!-- Programmatically creates the component and version list --> <ul class="components"> <li class="component is-current"> <a class="title" href="../index.html">Solr Reference Guide</a> <ul class="versions"> - <li class="version"> - <a href="../../9_3/index.html">9.3-beta</a> - </li> <li class="version is-current is-latest"> - <a href="../index.html">9.2</a> + <a href="../index.html">9.3</a> + </li> + <li class="version"> + <a href="../../9_2/index.html">9.2</a> </li> <li class="version"> <a href="../../9_1/index.html">9.1</a> @@ -211,7 +211,7 @@ <a class="nav-link" href="../getting-started/tutorial-films.html">Exercise 2: Index Films Data</a> </li> <li class="nav-item" data-depth="2"> - <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3 Index Your Own Data</a> + <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3: Index Your Own Data</a> </li> <li class="nav-item" data-depth="2"> <a class="nav-link" href="../getting-started/tutorial-solrcloud.html">Getting Started with SolrCloud</a> @@ -718,6 +718,9 @@ </ul> </li> <li class="nav-item" data-depth="2"> + <a class="nav-link" href="../indexing-guide/indexing-with-cbor.html">Indexing with Update CBOR data format</a> + </li> + <li class="nav-item" data-depth="2"> <a class="nav-link" href="../indexing-guide/indexing-with-tika.html">Indexing with Solr Cell and Apache Tika</a> </li> <li class="nav-item" data-depth="2"> @@ -1070,17 +1073,17 @@ </ul> </nav> <div class="page-versions"> - <button class="version-menu-toggle" title="Show other versions of page">9.2</button> + <button class="version-menu-toggle" title="Show other versions of page">9.3</button> <div class="version-menu"> - <a class="version" href="../../9_3/deployment-guide/enabling-ssl.html">9.3-beta</a> - <a class="version is-current" href="enabling-ssl.html">9.2</a> + <a class="version is-current" href="enabling-ssl.html">9.3</a> + <a class="version" href="../../9_2/deployment-guide/enabling-ssl.html">9.2</a> <a class="version" href="../../9_1/deployment-guide/enabling-ssl.html">9.1</a> <a class="version" href="../../9_0/deployment-guide/enabling-ssl.html">9.0</a> </div> </div> <!-- Solr Additions - Start --> <!-- Solr New File --> -<span class="perma-link-copy" version="9_2"> +<span class="perma-link-copy" version="9_3"> </span><!-- Solr Additions - End --> <div class="edit-this-page"><a href="https://github.com/apache/solr/tree/main/solr/solr-ref-guide/modules/deployment-guide/pages/enabling-ssl.adoc";>Edit this Page</a></div> </div> @@ -1703,8 +1706,7 @@ System.setProperty("javax.net.ssl.trustS System.setProperty("javax.net.ssl.trustStorePassword", "secret"); System.setProperty("javax.net.ssl.trustStoreType", "pkcs12"); String zkHost = "127.0.0.1:2181"; -CloudSolrClient client = new CloudSolrClient.Builder(Collections.singletonList(zkHost),Optional.empty()).build(); -client.setDefaultCollection("mycollection"); +CloudSolrClient client = new CloudSolrClient.Builder(Collections.singletonList(zkHost),Optional.empty()).withDefaultCollection("mycollection").build(); SolrInputDocument doc = new SolrInputDocument(); doc.addField("id", "1234"); doc.addField("name", "A lovely summer holiday"); Modified: sites/solr/guide/solr/latest/deployment-guide/hadoop-authentication-plugin.html URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/latest/deployment-guide/hadoop-authentication-plugin.html?rev=1083697&r1=1083696&r2=1083697&view=diff ============================================================================== --- sites/solr/guide/solr/latest/deployment-guide/hadoop-authentication-plugin.html (original) +++ sites/solr/guide/solr/latest/deployment-guide/hadoop-authentication-plugin.html Fri Jul 21 18:07:42 2023 @@ -39,7 +39,7 @@ <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="#">Resources</a> <div class="navbar-dropdown"> - <a class="navbar-item" href="https://solr.apache.org/docs/9_2_1/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> + <a class="navbar-item" href="https://solr.apache.org/docs/9_3_0/index.html"; target="_blank" rel="noreferrer nopener">Solr Javadocs</a> <a class="navbar-item" href="https://solr.apache.org/community.html#version-control"; target="_blank" rel="noreferrer nopener">Source Code</a> <a class="navbar-item" href="https://solr.apache.org/community.html"; target="_blank" rel="noreferrer nopener">Community Links</a> <a class="navbar-item" href="https://github.com/apache/solr/tree/main/dev-docs/ref-guide"; target="_blank" rel="noreferrer nopener">Contribute</a> @@ -56,25 +56,25 @@ </nav> </header> <div class="body"> -<div class="nav-container" data-component="solr" data-version="9_2"> +<div class="nav-container" data-component="solr" data-version="9_3"> <aside class="nav"> <div class="panels"> <!-- Solr Changes - Start --> <div class="nav-panel-explore" data-panel="explore"> <div class="context"> <span class="title">Solr Reference Guide</span> - <span class="version">9.2</span> + <span class="version">9.3</span> </div> <!-- Programmatically creates the component and version list --> <ul class="components"> <li class="component is-current"> <a class="title" href="../index.html">Solr Reference Guide</a> <ul class="versions"> - <li class="version"> - <a href="../../9_3/index.html">9.3-beta</a> - </li> <li class="version is-current is-latest"> - <a href="../index.html">9.2</a> + <a href="../index.html">9.3</a> + </li> + <li class="version"> + <a href="../../9_2/index.html">9.2</a> </li> <li class="version"> <a href="../../9_1/index.html">9.1</a> @@ -211,7 +211,7 @@ <a class="nav-link" href="../getting-started/tutorial-films.html">Exercise 2: Index Films Data</a> </li> <li class="nav-item" data-depth="2"> - <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3 Index Your Own Data</a> + <a class="nav-link" href="../getting-started/tutorial-diy.html">Exercise 3: Index Your Own Data</a> </li> <li class="nav-item" data-depth="2"> <a class="nav-link" href="../getting-started/tutorial-solrcloud.html">Getting Started with SolrCloud</a> @@ -718,6 +718,9 @@ </ul> </li> <li class="nav-item" data-depth="2"> + <a class="nav-link" href="../indexing-guide/indexing-with-cbor.html">Indexing with Update CBOR data format</a> + </li> + <li class="nav-item" data-depth="2"> <a class="nav-link" href="../indexing-guide/indexing-with-tika.html">Indexing with Solr Cell and Apache Tika</a> </li> <li class="nav-item" data-depth="2"> @@ -1071,17 +1074,17 @@ </ul> </nav> <div class="page-versions"> - <button class="version-menu-toggle" title="Show other versions of page">9.2</button> + <button class="version-menu-toggle" title="Show other versions of page">9.3</button> <div class="version-menu"> - <a class="version" href="../../9_3/deployment-guide/hadoop-authentication-plugin.html">9.3-beta</a> - <a class="version is-current" href="hadoop-authentication-plugin.html">9.2</a> + <a class="version is-current" href="hadoop-authentication-plugin.html">9.3</a> + <a class="version" href="../../9_2/deployment-guide/hadoop-authentication-plugin.html">9.2</a> <a class="version" href="../../9_1/deployment-guide/hadoop-authentication-plugin.html">9.1</a> <a class="version" href="../../9_0/deployment-guide/hadoop-authentication-plugin.html">9.0</a> </div> </div> <!-- Solr Additions - Start --> <!-- Solr New File --> -<span class="perma-link-copy" version="9_2"> +<span class="perma-link-copy" version="9_3"> </span><!-- Solr Additions - End --> <div class="edit-this-page"><a href="https://github.com/apache/solr/tree/main/solr/solr-ref-guide/modules/deployment-guide/pages/hadoop-authentication-plugin.adoc";>Edit this Page</a></div> </div>
