From 1ae920cb90047d3e2a908fc5526de069e0542442 Mon Sep 17 00:00:00 2001 From: Peter Dyson Date: Mon, 22 Jan 2018 18:39:21 +1000 Subject: [PATCH] Provide explanation of dangling indices, fixes #26008 (#26999) * Provide explanation of dangling indices, fixes #26008 Adjusted from PR review comments * updates to suggested wording and minor typo fix. --- docs/reference/modules/gateway.asciidoc | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/reference/modules/gateway.asciidoc b/docs/reference/modules/gateway.asciidoc index 0af0d31fba2..76e08407939 100644 --- a/docs/reference/modules/gateway.asciidoc +++ b/docs/reference/modules/gateway.asciidoc @@ -48,3 +48,12 @@ as long as the following conditions are met: Recover as long as this many data nodes have joined the cluster. NOTE: These settings only take effect on a full cluster restart. + +=== Dangling indices + +When a node joins the cluster, any shards stored in its local data directory +directory which do not already exist in the cluster will be imported into the +cluster. This functionality is intended as a best effort to help users who +lose all master nodes. If a new master node is started which is unaware of +the other indices in the cluster, adding the old nodes will cause the old +indices to be imported, instead of being deleted.