You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: docs/en/install-upgrade/upgrading-elasticsearch.asciidoc
+14-10Lines changed: 14 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -22,16 +22,20 @@ running the older version.
22
22
Before you start, <<upgrading-elastic-stack,take the upgrade preparation
23
23
steps>>. When performing a <<rolling-upgrades, rolling upgrade>>:
24
24
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`.
35
39
36
40
This order ensures that all nodes can join the cluster during the upgrade.
37
41
Upgraded nodes can join a cluster with an older master, but older nodes cannot
0 commit comments