Skip to content

Commit 2e35b7e

Browse files
Improve rolling upgrade order docs (#2576) (#2578)
The first point in the list (upgrade the master-ineligible nodes) is redundant and sort of contradicts the second one (upgrade the data nodes tier-by-tier). This commit drops it. The second point had some redundant sentences in a somewhat awkward order. This commit cleans that up. There's no mention of nodes that are neither data nodes nor master-eligible nodes. In fact it doesn't really matter when these nodes are upgraded, but this commit specifies to upgrade them before the master-eligible nodes for the sake of completeness. Finally, there were some over-long lines so this commit reflows the source. (cherry picked from commit d401cda) Co-authored-by: David Turner <[email protected]>
1 parent f71fcee commit 2e35b7e

File tree

1 file changed

+14
-10
lines changed

1 file changed

+14
-10
lines changed

docs/en/install-upgrade/upgrading-elasticsearch.asciidoc

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -22,16 +22,20 @@ running the older version.
2222
Before you start, <<upgrading-elastic-stack,take the upgrade preparation
2323
steps>>. When performing a <<rolling-upgrades, rolling upgrade>>:
2424

25-
. Upgrade nodes that are **NOT** {ref}/modules-node.html#master-node[master-eligible] first.
26-
You can retrieve a list of these nodes with `GET /_nodes/_all,master:false/_none` or by finding all the nodes configured with `node.master: false`.
27-
28-
. Upgrade nodes tier-by-tier, starting with the frozen tier.
29-
Complete the upgrade for all nodes in each data tier before moving to the next.
30-
Upgrade the frozen tier, then the cold tier, then the warm tier, and upgrade the hot tier last. This ensures {ilm-init} can continue to move data through the tiers during the upgrade. You can get the list of nodes in a specific tier with a `GET /_nodes` request,
31-
for example: `GET /_nodes/data_frozen:true/_none`.
32-
33-
. Upgrade the master-eligible nodes last. You can retrieve a list
34-
of these nodes with `GET /_nodes/master:true`.
25+
. Upgrade the data nodes first, tier-by-tier, starting with the frozen tier,
26+
then the cold tier, then the warm tier, then the hot tier, and finally any other
27+
data nodes which are not in a tier. Complete the upgrade for all nodes in each
28+
data tier before moving to the next. This ensures {ilm-init} can continue to
29+
move data through the tiers during the upgrade. You can get the list of nodes in
30+
a specific tier with a `GET /_nodes` request, for example:
31+
`GET /_nodes/data_frozen:true/_none`.
32+
33+
. Upgrade all remaining nodes that are neither master-eligible nor data nodes.
34+
This includes dedicated ML nodes, dedicated ingest nodes, and dedicated
35+
coordinating nodes.
36+
37+
. Upgrade the master-eligible nodes last. You can retrieve a list of these nodes
38+
with `GET /_nodes/master:true/_none`.
3539

3640
This order ensures that all nodes can join the cluster during the upgrade.
3741
Upgraded nodes can join a cluster with an older master, but older nodes cannot

0 commit comments

Comments
 (0)