From 2ca0dadc68075f3a922b8d69e6a4786231bb744e Mon Sep 17 00:00:00 2001 From: Yannick Welsch Date: Fri, 11 May 2018 10:49:21 +0200 Subject: [PATCH 1/2] Document woes between auto-expand-replicas and allocation filtering --- docs/reference/index-modules.asciidoc | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/reference/index-modules.asciidoc b/docs/reference/index-modules.asciidoc index ed0077a629d7c..7ea7b297690d4 100644 --- a/docs/reference/index-modules.asciidoc +++ b/docs/reference/index-modules.asciidoc @@ -103,9 +103,11 @@ specific index module: `index.auto_expand_replicas`:: - Auto-expand the number of replicas based on the number of available nodes. + Auto-expand the number of replicas based on the number of available data nodes. + Note that this does not take <> + into account and can lead to a yellow cluster health. Set to a dash delimited lower and upper bound (e.g. `0-5`) or use `all` - for the upper bound (e.g. `0-all`). Defaults to `false` (i.e. disabled). + for the upper bound (e.g. `0-all`). Defaults to `false` (i.e. disabled). `index.search.idle.after`:: How long a shard can not receive a search or get request until it's considered From dd6135cbafebc9bbee429b83e9d21609dd2e2c51 Mon Sep 17 00:00:00 2001 From: Yannick Welsch Date: Fri, 11 May 2018 14:21:52 +0200 Subject: [PATCH 2/2] feedback --- docs/reference/index-modules.asciidoc | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/reference/index-modules.asciidoc b/docs/reference/index-modules.asciidoc index 7ea7b297690d4..54c0c1c1b157c 100644 --- a/docs/reference/index-modules.asciidoc +++ b/docs/reference/index-modules.asciidoc @@ -103,11 +103,14 @@ specific index module: `index.auto_expand_replicas`:: - Auto-expand the number of replicas based on the number of available data nodes. - Note that this does not take <> - into account and can lead to a yellow cluster health. + Auto-expand the number of replicas based on the number of data nodes in the cluster. Set to a dash delimited lower and upper bound (e.g. `0-5`) or use `all` for the upper bound (e.g. `0-all`). Defaults to `false` (i.e. disabled). + Note that the auto-expanded number of replicas does not take any other allocation + rules into account, such as <>, + <> or <>, + and this can lead to the cluster health becoming `YELLOW` if the applicable rules + prevent all the replicas from being allocated. `index.search.idle.after`:: How long a shard can not receive a search or get request until it's considered