2013-08-28 19:24:34 -04:00
|
|
|
[[modules-gateway]]
|
2020-06-01 12:40:15 -04:00
|
|
|
=== Local gateway settings
|
2015-06-22 17:49:45 -04:00
|
|
|
|
2020-06-01 12:40:15 -04:00
|
|
|
The local gateway stores the cluster state and shard data across full
|
2015-06-22 17:49:45 -04:00
|
|
|
cluster restarts.
|
|
|
|
|
2017-09-05 04:42:58 -04:00
|
|
|
The following _static_ settings, which must be set on every master node,
|
|
|
|
control how long a freshly elected master should wait before it tries to
|
|
|
|
recover the cluster state and the cluster's data:
|
2015-06-22 17:49:45 -04:00
|
|
|
|
|
|
|
`gateway.expected_nodes`::
|
|
|
|
|
2020-03-18 06:03:21 -04:00
|
|
|
deprecated:[7.7.0, This setting will be removed in 8.0. You should use `gateway.expected_data_nodes` instead.]
|
2015-06-22 17:49:45 -04:00
|
|
|
The number of (data or master) nodes that are expected to be in the cluster.
|
|
|
|
Recovery of local shards will start as soon as the expected number of
|
|
|
|
nodes have joined the cluster. Defaults to `0`
|
|
|
|
|
|
|
|
`gateway.expected_master_nodes`::
|
|
|
|
|
2020-03-18 06:03:21 -04:00
|
|
|
deprecated:[7.7.0, This setting will be removed in 8.0. You should use `gateway.expected_data_nodes` instead.]
|
2015-06-22 17:49:45 -04:00
|
|
|
The number of master nodes that are expected to be in the cluster.
|
|
|
|
Recovery of local shards will start as soon as the expected number of
|
|
|
|
master nodes have joined the cluster. Defaults to `0`
|
|
|
|
|
|
|
|
`gateway.expected_data_nodes`::
|
|
|
|
|
|
|
|
The number of data nodes that are expected to be in the cluster.
|
|
|
|
Recovery of local shards will start as soon as the expected number of
|
|
|
|
data nodes have joined the cluster. Defaults to `0`
|
|
|
|
|
|
|
|
`gateway.recover_after_time`::
|
|
|
|
|
|
|
|
If the expected number of nodes is not achieved, the recovery process waits
|
|
|
|
for the configured amount of time before trying to recover regardless.
|
|
|
|
Defaults to `5m` if one of the `expected_nodes` settings is configured.
|
|
|
|
|
|
|
|
Once the `recover_after_time` duration has timed out, recovery will start
|
|
|
|
as long as the following conditions are met:
|
|
|
|
|
|
|
|
`gateway.recover_after_nodes`::
|
|
|
|
|
2020-03-18 06:03:21 -04:00
|
|
|
deprecated:[7.7.0, This setting will be removed in 8.0. You should use `gateway.recover_after_data_nodes` instead.]
|
2015-06-22 17:49:45 -04:00
|
|
|
Recover as long as this many data or master nodes have joined the cluster.
|
|
|
|
|
|
|
|
`gateway.recover_after_master_nodes`::
|
|
|
|
|
2020-03-18 06:03:21 -04:00
|
|
|
deprecated:[7.7.0, This setting will be removed in 8.0. You should use `gateway.recover_after_data_nodes` instead.]
|
2015-06-22 17:49:45 -04:00
|
|
|
Recover as long as this many master nodes have joined the cluster.
|
|
|
|
|
|
|
|
`gateway.recover_after_data_nodes`::
|
|
|
|
|
|
|
|
Recover as long as this many data nodes have joined the cluster.
|
|
|
|
|
|
|
|
NOTE: These settings only take effect on a full cluster restart.
|
2018-01-22 03:39:21 -05:00
|
|
|
|
2020-06-01 12:40:15 -04:00
|
|
|
[[dangling-indices]]
|
|
|
|
==== Dangling indices
|
2018-01-22 03:39:21 -05:00
|
|
|
|
2018-08-28 07:16:43 -04:00
|
|
|
When a node joins the cluster, any shards stored in its local data
|
2020-03-18 06:03:21 -04:00
|
|
|
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
|
2018-01-22 03:39:21 -05:00
|
|
|
indices to be imported, instead of being deleted.
|