Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

SOLR-15965 Clarify Upgrade Instructions #649

Merged
merged 1 commit into from Feb 17, 2022
Merged

SOLR-15965 Clarify Upgrade Instructions #649

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
12 changes: 6 additions & 6 deletions solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc
View file
Open in desktop
Expand Up @@ -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

Expand Down