From 5ad80c27f48fb84a7bf6002f326d1f181d35362f Mon Sep 17 00:00:00 2001 From: James Rodewig Date: Tue, 18 Jan 2022 08:52:19 -0500 Subject: [PATCH] [DOCS] Add 7.13 breaking change for ESS searchable snapshot shared cache (#80795) (#82725) You can no longer configure `xpack.searchable.snapshot.shared_cache.size` as a user setting in ESS on 7.13+ deployments. This adds a related breaking change to the 7.13 docs. Relates to https://github.com/elastic/elasticsearch/pull/80793 (cherry picked from commit 44c7cb7278b6d516241f128d015c24239478e214) --- .../reference/migration/migrate_7_13.asciidoc | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/reference/migration/migrate_7_13.asciidoc b/docs/reference/migration/migrate_7_13.asciidoc index 0a39f0ac9ff16..7de132a544351 100644 --- a/docs/reference/migration/migrate_7_13.asciidoc +++ b/docs/reference/migration/migrate_7_13.asciidoc @@ -91,6 +91,26 @@ SSL/TLS versions on your JDK]. [[breaking_713_settings_changes]] ==== Settings changes +[[breaking_713_searchable_snapshot_cache_ess]] +.`xpack.searchable.snapshot.shared_cache.size` is no longer a supported user setting for {ess} +[%collapsible] +==== +*Details* + +You can no longer configure +{ref}/searchable-snapshots.html#searchable-snapshots-shared-cache[`xpack.searchable.snapshot.shared_cache.size`] +on {ess} deployments running {es} 7.13 or a later version. This setting reserves +disk space for the shared cache of partially mounted indices. {es} now +automatically configures the setting to 90% of total disk space for frozen data +tier nodes and to `0b` for non-frozen data tier nodes. + +*Impact* + +If you use {ess} and previously configured +`xpack.searchable.snapshot.shared_cache.size`, remove it from your +{cloud}/ec-add-user-settings.html[user settings] before upgrading to 7.13 or a +later version. Otherwise, attempts to upgrade the deployment will fail and +return an error. +==== + [[breaking_713_frozen_multiple_data_paths_changes]] .Changes to the frozen tier and multiple data paths [%collapsible]