Skip to content

Commit bbb481f

Browse files
authored
Only recommend disabling allocation of replicas in a rolling upgrade (#40299)
The current documentation recommends disabling allocations of all shards. This prevents shards of new indices from being allocated as well. That means that during a rolling upgrade, operations like roll over and index shrinking will operate correctly. This, in turn, can cause issues for data ingestion and ILM.
1 parent f47e018 commit bbb481f

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

docs/reference/upgrade/disable-shard-alloc.asciidoc

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,18 @@ When you shut down a node, the allocation process waits for
33
`index.unassigned.node_left.delayed_timeout` (by default, one minute) before
44
starting to replicate the shards on that node to other nodes in the cluster,
55
which can involve a lot of I/O. Since the node is shortly going to be
6-
restarted, this I/O is unnecessary. You can avoid racing the clock by disabling
7-
allocation before shutting down the node:
6+
restarted, this I/O is unnecessary. You can avoid racing the clock by
7+
<<shards-allocation, disabling allocation>> of replicas before shutting down
8+
the node:
89

910
[source,js]
1011
--------------------------------------------------
1112
PUT _cluster/settings
1213
{
1314
"persistent": {
14-
"cluster.routing.allocation.enable": "none"
15+
"cluster.routing.allocation.enable": "primaries"
1516
}
1617
}
1718
--------------------------------------------------
1819
// CONSOLE
19-
// TEST[skip:indexes don't assign]
20+
// TEST[skip:indexes don't assign]

0 commit comments

Comments
 (0)