This is an automated email from the ASF dual-hosted git repository.
gerlowskija pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/solr.git
The following commit(s) were added to refs/heads/main by this push:
new f29b7cd1efd SOLR-16697: Align install-shard docs
f29b7cd1efd is described below
commit f29b7cd1efdb2244b039d8c9e695804aec9fc3f0
Author: Jason Gerlowski <[email protected]>
AuthorDate: Fri May 5 08:12:28 2023 -0400
SOLR-16697: Align install-shard docs
The "Install Shard" API docs used the wrong v1 "command" or "action"
name. This commit corrects them, so that 'INSTALLSHARDDATA' is now used
instead of "INSTALLSHARD".
---
solr/CHANGES.txt | 2 +-
.../modules/deployment-guide/pages/shard-management.adoc | 10 +++++-----
.../modules/upgrade-notes/pages/major-changes-in-solr-9.adoc | 2 +-
3 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/solr/CHANGES.txt b/solr/CHANGES.txt
index 4a7913515e2..205c3db6dba 100644
--- a/solr/CHANGES.txt
+++ b/solr/CHANGES.txt
@@ -48,7 +48,7 @@ New Features
---------------------
* SOLR-16697: Solr now provides an "Install Shard" API that allows users who
have built (per-shard) indices offline to import
them into SolrCloud shards. The API is available at `POST
/api/collections/collName/shards/shardName/install`
- (v2), or at `GET /solr/admin/collections?action=INSTALLSHARD` (v1). (Jason
Gerlowski)
+ (v2), or at `GET /solr/admin/collections?action=INSTALLSHARDDATA` (v1).
(Jason Gerlowski)
* SOLR-16742: Produce a slim Solr binary and docker image, without the
Prometheus Exporter and Solr Modules. (Houston Putman)
diff --git
a/solr/solr-ref-guide/modules/deployment-guide/pages/shard-management.adoc
b/solr/solr-ref-guide/modules/deployment-guide/pages/shard-management.adoc
index 2efad25dea1..2d5c46fcb77 100644
--- a/solr/solr-ref-guide/modules/deployment-guide/pages/shard-management.adoc
+++ b/solr/solr-ref-guide/modules/deployment-guide/pages/shard-management.adoc
@@ -631,13 +631,13 @@ This parameter is required.
WARNING: This is an expert level command, and should be invoked only when
regular leader election is not working.
This may potentially lead to loss of data in the event that the new leader
doesn't have certain updates, possibly recent ones, which were acknowledged by
the old leader before going down.
-[[installshard]]
-== INSTALLSHARD: Install/Import Data to Shard
+[[installsharddata]]
+== INSTALLSHARDDATA: Install/Import Data to Shard
Under normal circumstances, data is added to Solr collections (and the shards
that make them up) by
xref:indexing-guide:indexing-with-update-handlers.adoc[indexing] documents.
However some use-cases require constructing per-shard indices offline.
Often this is done as a means of insulating query traffic from indexing load,
or because the ETL pipeline in use is particularly complex.
-The INSTALLSHARD API allows installation of these pre-constructed indices into
individual shards within a collection.
+The INSTALLSHARDDATA API allows installation of these pre-constructed indices
into individual shards within a collection.
Installation copies the index files into all replicas within the shard,
overwriting any preexisting data held by that shard.
To install data into a shard, the collection owning that shard must first be
put into "readOnly" mode, using the
xref:deployment-guide:collection-management.adoc#modifycollection[MODIFYCOLLECTION
API].
@@ -659,7 +659,7 @@ Users are responsible for ensuring that the index installed
to a shard is compat
[source,text]
----
-http://localhost:8983/solr/admin/collections?action=INSTALLSHARD&collection=techproducts&shard=shard1&repository=localfs&location=/mounts/myNFSDrive/tech/shard1/data/index
+http://localhost:8983/solr/admin/collections?action=INSTALLSHARDDATA&collection=techproducts&shard=shard1&repository=localfs&location=/mounts/myNFSDrive/tech/shard1/data/index
----
*Output*
@@ -703,7 +703,7 @@ curl -X POST
http://localhost:8983/api/collections/techproducts/shards/shard1/in
====
--
-=== INSTALLSHARD Parameters
+=== INSTALLSHARDDATA Parameters
`collection`::
+
diff --git
a/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc
b/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc
index f92d0919956..250ae993d7e 100644
---
a/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc
+++
b/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc
@@ -71,7 +71,7 @@ The
xref:deployment-guide:installing-solr.adoc#available-solr-packages[Installin
Please refer to the https://solr.apache.org/downloads.html[Solr Downloads]
site for information on how to download these offerings.
=== Shard Management
-* Solr now provides an
xref:deployment-guide:shard-management.adoc#installshard[INSTALLSHARD] API to
allow users who have built (per-shard) indices offline to import them into
SolrCloud shards.
+* Solr now provides an
xref:deployment-guide:shard-management.adoc#installsharddata["Install Shard"]
API to allow users who have built (per-shard) indices offline to import them
into SolrCloud shards.
== Solr 9.3
=== Improvements to Solr CLI
