WARNING: Version 1.5 of Elasticsearch has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
The local gateway allows for recovery of the full cluster state and indices from the local storage of each node, and does not require a common node level shared storage.
Note, different from shared gateway types, the persistency to the local gateway is not done in an async manner. Once an operation is performed, the data is there for the local gateway to recover it in case of full cluster failure.
It is important to configure the
to include most of the expected nodes to be started after a full cluster
restart. This will insure that the latest cluster state is recovered.
gateway: recover_after_nodes: 3 expected_nodes: 5
When a node joins the cluster, any shards/indices stored in its local
directory which do not already exist in the cluster will be imported into the
cluster by default. This functionality has two purposes:
- 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.
An old index can be added to an existing cluster by copying it to the
data/directory of a new node, starting the node and letting it join the cluster. Once the index has been replicated to other nodes in the cluster, the new node can be shut down and removed.
The import of dangling indices can be controlled with the
gateway.local.auto_import_dangled which accepts:
Import dangling indices into the cluster (default).
Import dangling indices into the cluster state, but leave them closed.
Delete dangling indices after