Skip to content

Commit d420300

Browse files
committed
Remove usage of transient settings to enable allocations in full restart upgrade docs (#29670)
Since we disable allocation using persistent settings, we should be consistent and remove the setting from the persistent storage. Otherwise an accidental restart will leed for shards not being allocated. Relates to #28757
1 parent 32a7a66 commit d420300

File tree

1 file changed

+4
-9
lines changed

1 file changed

+4
-9
lines changed

docs/reference/upgrade/cluster_restart.asciidoc

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -91,25 +91,20 @@ already have local shard copies.
9191
+
9292
--
9393
When all nodes have joined the cluster and recovered their primary shards,
94-
reenable allocation.
94+
reenable allocation by restoring `cluster.routing.allocation.enable` to its
95+
default:
9596

9697
[source,js]
9798
------------------------------------------------------
9899
PUT _cluster/settings
99100
{
100-
"transient": {
101-
"cluster.routing.allocation.enable": "all"
101+
"persistent": {
102+
"cluster.routing.allocation.enable": null
102103
}
103104
}
104105
------------------------------------------------------
105106
// CONSOLE
106107

107-
NOTE: Because <<_precedence_of_settings, transient
108-
settings take precedence over persistent settings>>, this overrides the
109-
persistent setting used to disable shard allocation in the first step. If you
110-
don't explicitly reenable shard allocation after a full cluster restart, the
111-
persistent setting is used and shard allocation remains disabled.
112-
113108
Once allocation is reenabled, the cluster starts allocating replica shards to
114109
the data nodes. At this point it is safe to resume indexing and searching,
115110
but your cluster will recover more quickly if you can wait until all primary

0 commit comments

Comments
 (0)