From f250821ceb51a88b260b8d906473b20d9ea6657c Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Thu, 16 Sep 2021 17:30:04 -0400 Subject: [PATCH] [DOCS] Add deprecation docs for cluster recovery defer settings (#77786) (#77958) We deprecated the following settings in 7.7 with PR #53646: * `gateway.expected_nodes` * `gateway.expected_master_nodes` * `gateway.recover_after_nodes` * `gateway.recover_after_master_nodes` However, we didn't add a related item to the 7.7 deprecation docs. This adds the missing item. Relates to #53845. --- docs/reference/migration/migrate_7_7.asciidoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/reference/migration/migrate_7_7.asciidoc b/docs/reference/migration/migrate_7_7.asciidoc index 14301a643ba18..c8b4ecc67ed6b 100644 --- a/docs/reference/migration/migrate_7_7.asciidoc +++ b/docs/reference/migration/migrate_7_7.asciidoc @@ -97,6 +97,25 @@ If you configure more than one realm of any type with the same order, the node w The `auth.password` setting for the monitoring HTTP exporter has been deprecated and will be removed in version 8.0.0. Please use the `auth.secure_password` setting instead. +[discrete] +[[deprecate-defer-cluster-recovery-settings]] +==== Settings used to defer cluster recovery pending a certain number of master nodes are deprecated. + +The following cluster settings are now deprecated: + +* `gateway.expected_nodes` +* `gateway.expected_master_nodes` +* `gateway.recover_after_nodes` +* `gateway.recover_after_master_nodes` + +It is safe to recover the cluster as soon as a majority of master-eligible nodes +have joined. There is no benefit in waiting for any additional master-eligible +nodes to start. + +To avoid deprecation warnings, discontinue use of the deprecated settings. If +needed, use `gateway.expected_data_nodes` or `gateway.recover_after_data_nodes` +to defer cluster recovery pending a certain number of data nodes. + [discrete] [[breaking_77_search_changes]] === Search changes