Skip to content

Commit

Permalink
Clarify rolling-upgrade docs (#47279)
Browse files Browse the repository at this point in the history
Note to upgrade the master-eligible nodes last, and note that
`cluster.initial_master_nodes` should not be set.
  • Loading branch information
DaveCTurner committed Sep 30, 2019
1 parent ad1485b commit 628316a
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions docs/reference/upgrade/rolling_upgrade.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,12 @@ a time so upgrading does not interrupt service. Running multiple versions of
not supported, as shards cannot be replicated from upgraded nodes to nodes
running the older version.

It is best to upgrade the master-ineligible nodes in your cluster first and then
upgrade the master-eligible nodes. Once enough of the master-eligible nodes have
been upgraded they may form a cluster that nodes of older versions cannot join.
If you upgrade the master-eligible nodes last then all the other nodes will not
be running an older version and so they will be able to join the cluster.

Rolling upgrades are supported:

* Between minor versions
Expand Down Expand Up @@ -52,6 +58,11 @@ include::shut-down-node.asciidoc[]
--
include::upgrade-node.asciidoc[]
include::set-paths-tip.asciidoc[]

[[rolling-upgrades-bootstrapping]]
NOTE: You should leave `cluster.initial_master_nodes` unset while performing a
rolling upgrade. Each upgraded node is joining an existing cluster so there is
no need for <<modules-discovery-bootstrap-cluster,cluster bootstrapping>>.
--

. *Upgrade any plugins.*
Expand Down

0 comments on commit 628316a

Please sign in to comment.