This is an automated email from the ASF dual-hosted git repository.
mdrob 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 ad1d943 SOLR-15965 Clarify Upgrade Instructions (#649)
ad1d943 is described below
commit ad1d9439afb36c3164c0418cec369ffe937b81f1
Author: Mike Drob <[email protected]>
AuthorDate: Thu Feb 17 15:09:46 2022 -0600
SOLR-15965 Clarify Upgrade Instructions (#649)
---
.../modules/upgrade-notes/pages/major-changes-in-solr-9.adoc | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
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 55c15e9..040dd77 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
@@ -51,18 +51,18 @@ SolrCloud doesn't support that but may sometime.
=== Rolling Upgrades
+WARNING: Rolling upgrades from Solr 8 to Solr 9 require upgrading from Solr
8.7 or newer.
+
* SOLR-14702: All references to "master" and "slave" were replaced in the code
with "leader" and "follower".
This includes API calls for the replication handler and metrics.
-For rolling upgrades into 9.0, you need to be on Solr version 8.7 or greater.
Some metrics also changed, alerts and monitors on Solr KPIs that mention
"master" or "slave" will also now be "leader" and "follower"
+Some metrics also changed, alerts and monitors on Solr KPIs that mention
"master" or "slave" will also now be "leader" and "follower"
* SOLR-15965: Internode communication secured by PKI Authentication has
changed formats. For detailed information, see
xref:deployment-guide:authentication-and-authorization-plugins.adoc#pkiauthenticationplugin[PKI
Authentication Plugin].
A rolling upgrade from Solr 8 to Solr 9 requires the following multiple
restart sequence:
-** Either:
-*** Upgrade to Solr 8.11.2 or newer
-*** Upgrade to Solr 9 and set system properties: `solr.pki.sendVersion=v1` and
`solr.pki.acceptVersions=v1,v2`
-** Upgrade to Solr 9 with `solr.pki.acceptVersions=v1,v2`. If you had already
upgraded to Solr 9 in the previous step, this will be a rolling restart, not
upgrade.
-** (Optional) A rolling restart with system property
`solr.pki.acceptVersions=v2` to prevent outdated nodes from connecting to your
cluster.
+1. Upgrade to Solr 9 and set system properties: `solr.pki.sendVersion=v1` and
`solr.pki.acceptVersions=v1,v2`. This will allow Solr 9 nodes to send messages
to Solr 8 nodes while the upgrade is in progress.
+2. Restart with `solr.pki.sendVersion=v2` (default, can be unset) and
`solr.pki.acceptVersions=v1,v2`. This will force all nodes to send the new
header.
+3. (Optional) Restart with system property `solr.pki.acceptVersions=v2`
(default, can be unset) to prevent outdated nodes from connecting to your
cluster.
=== Reindexing After Upgrade
