Skip to content

Commit fe45947

Browse files
authored
[DOCS] Add deprecation docs for cluster.routing.allocation.disk.include_relocations (#77726) (#77938)
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 a509d23 commit fe45947

File tree

1 file changed

+23
-1
lines changed

1 file changed

+23
-1
lines changed

docs/reference/migration/migrate_7_5.asciidoc

+23-1
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,32 @@ your application to Elasticsearch 7.5.
99

1010
See also <<release-highlights>> and <<es-release-notes>>.
1111

12+
* <<breaking_75_allocation_deprecations>>
13+
* <<breaking_75_search_changes>>
14+
1215
//NOTE: The notable-breaking-changes tagged regions are re-used in the
1316
//Installation and Upgrade Guide
1417

1518
//tag::notable-breaking-changes[]
1619

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

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

0 commit comments

Comments
 (0)