Skip to content

Commit 5ddf495

Browse files
committed
[DOCS] Add deprecation docs for cluster.routing.allocation.disk.include_relocations
We deprecated the `cluster.routing.allocation.disk.include_relocations` setting in 7.5 with PR #47443. However, we didn't add a related item to the 7.5 deprecation docs. This adds the missing item. Relates to #47717.
1 parent 7eb4615 commit 5ddf495

File tree

1 file changed

+20
-1
lines changed

1 file changed

+20
-1
lines changed

docs/reference/migration/migrate_7_5.asciidoc

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,24 @@ See also <<release-highlights>> and <<es-release-notes>>.
1414

1515
//tag::notable-breaking-changes[]
1616

17-
//end::notable-breaking-changes[]
17+
[discrete]
18+
[[breaking_75_allocation_deprecations]]
19+
=== Allocation deprecations
20+
21+
[discrete]
22+
[[deprecate-cluster-routing-allocation-disk-include-relocations-setting]]
23+
==== The `cluster.routing.allocation.disk.include_relocations` setting is deprecated.
24+
25+
The `cluster.routing.allocation.disk.include_relocations` cluster setting is now
26+
deprecated. In future versions, {es} will account for the sizes of relocating
27+
shards when making allocation decisions based on the disk usage of nodes in the
28+
cluster.
29+
30+
Currently, you can set `cluster.routing.allocation.disk.include_relocations` to
31+
`false` to disable this accounting. This can result in poor allocation decisions
32+
that might overshoot watermarks and require significant work to correct.
33+
34+
To avoid deprecation warnings, discontinue use of the setting.
1835

1936
[discrete]
2037
[[breaking_75_search_changes]]
@@ -26,3 +43,5 @@ Previously, a wildcard query on the `_index` field matched directly against the
2643
fully-qualified index name. Now, in order to match against remote indices like
2744
`cluster:index`, the query must contain a colon, as in `cl*ster:inde*`. This
2845
behavior aligns with the way indices are matched in the search endpoint.
46+
47+
//end::notable-breaking-changes[]

0 commit comments

Comments
 (0)