Browse Source

[DOCS] Update 8.0 breaking change for searchable snapshot shared cache (#80793)

You can no longer configure `xpack.searchable.snapshot.shared_cache.size` as a user setting in ESS on 7.13+ deployments. This PR removes the ESS icon from the related 8.0 breaking change for the setting.

It also clarifies the breaking change text to indicate that configuring the setting on non-frozen nodes will result in an error on startup.

Relates to https://github.com/elastic/elasticsearch/pull/80795
James Rodewig 3 years ago
parent
commit
58f32b361f

+ 16 - 13
docs/reference/migration/migrate_8_0/cluster-node-setting-changes.asciidoc

@@ -8,19 +8,6 @@
 //tag::notable-breaking-changes[]
 TIP: {ess-setting-change}
 
-.You can no longer set `xpack.searchable.snapshot.shared_cache.size` on non-frozen nodes. {ess-icon}
-[%collapsible]
-====
-*Details* +
-Setting `xpack.searchable.snapshot.shared_cache.size` on a node
-that does not have the `data_frozen` role was deprecated in {es} 7.12.0 and has
-been removed in {es} 8.0.0.
-
-*Impact* +
-{es} only allocates partially mounted indices to nodes with the `data_frozen`
-role. Remove the `xpack.searchable.snapshot.shared_cache.size` setting from nodes that don't have the `data_frozen` role. 
-====
-
 .`action.destructive_requires_name` now defaults to `false`. {ess-icon}
 [%collapsible]
 ====
@@ -40,6 +27,22 @@ To use wildcard patterns for destructive actions, set
 {ref}/cluster-update-settings.html[] cluster settings API].
 ====
 
+.You can no longer set `xpack.searchable.snapshot.shared_cache.size` on non-frozen nodes.
+[%collapsible]
+====
+*Details* +
+You can no longer set
+{ref}/searchable-snapshots.html#searchable-snapshots-shared-cache[`xpack.searchable.snapshot.shared_cache.size`]
+on a node that doesn't have the `data_frozen` node role. This setting reserves
+disk space for the shared cache of partially mounted indices. {es} only
+allocates partially mounted indices to nodes with the `data_frozen` role.
+
+*Impact* +
+Remove `xpack.searchable.snapshot.shared_cache.size` from `elasticsearch.yml`
+for nodes that don't have the `data_frozen` role. Specifying the setting on a
+non-frozen node will result in an error on startup.
+====
+
 [[max_clause_count_change]]
 .The `indices.query.bool.max_clause_count` setting now limits all query clauses.
 [%collapsible]