diff --git a/docs/reference/modules/snapshots.asciidoc b/docs/reference/modules/snapshots.asciidoc index bcbb77161e5..d6d421b35bf 100644 --- a/docs/reference/modules/snapshots.asciidoc +++ b/docs/reference/modules/snapshots.asciidoc @@ -23,7 +23,7 @@ $ curl -XPUT 'http://localhost:9200/_snapshot/my_backup' -d '{ }' ----------------------------------- -Once repository is registered, its information can be obtained using the following command: +Once a repository is registered, its information can be obtained using the following command: [source,js] ----------------------------------- @@ -122,7 +122,7 @@ initialization (default) or wait for snapshot completion. During snapshot initia previous snapshots is loaded into the memory, which means that in large repositories it may take several seconds (or even minutes) for this command to return even if the `wait_for_completion` parameter is set to `false`. -By default snapshot of all open and started indices in the cluster is created. This behavior can be changed by +By default a snapshot of all open and started indices in the cluster is created. This behavior can be changed by specifying the list of indices in the body of the snapshot request. [source,js] @@ -139,7 +139,7 @@ supports <>. The snapshot request al `ignore_unavailable` option. Setting it to `true` will cause indices that do not exist to be ignored during snapshot creation. By default, when `ignore_unavailable` option is not set and an index is missing the snapshot request will fail. By setting `include_global_state` to false it's possible to prevent the cluster global state to be stored as part of -the snapshot. By default, entire snapshot will fail if one or more indices participating in the snapshot don't have +the snapshot. By default, the entire snapshot will fail if one or more indices participating in the snapshot don't have all primary shards available. This behaviour can be changed by setting `partial` to `true`. The index snapshot process is incremental. In the process of making the index snapshot Elasticsearch analyses @@ -147,7 +147,7 @@ the list of the index files that are already stored in the repository and copies changed since the last snapshot. That allows multiple snapshots to be preserved in the repository in a compact form. Snapshotting process is executed in non-blocking fashion. All indexing and searching operation can continue to be executed against the index that is being snapshotted. However, a snapshot represents the point-in-time view of the index -at the moment when snapshot was created, so no records that were added to the index after snapshot process had started +at the moment when snapshot was created, so no records that were added to the index after the snapshot process was started will be present in the snapshot. The snapshot process starts immediately for the primary shards that has been started and are not relocating at the moment. Before version 1.2.0, the snapshot operation fails if the cluster has any relocating or initializing primaries of indices participating in the snapshot. Starting with version 1.2.0, Elasticsearch waits for @@ -159,8 +159,8 @@ the snapshot. Only one snapshot process can be executed in the cluster at any time. While snapshot of a particular shard is being created this shard cannot be moved to another node, which can interfere with rebalancing process and allocation -filtering. Once snapshot of the shard is finished Elasticsearch will be able to move shard to another node according -to the current allocation filtering settings and rebalancing algorithm. +filtering. Elasticsearch will only be able to move a shard to another node (according to the current allocation +filtering settings and rebalancing algorithm) once the snapshot is finished. Once a snapshot is created information about this snapshot can be obtained using the following command: @@ -244,7 +244,7 @@ persistent settings are added to the existing persistent settings. [float] === Partial restore -By default, entire restore operation will fail if one or more indices participating in the operation don't have +By default, the entire restore operation will fail if one or more indices participating in the operation don't have snapshots of all shards available. It can occur if some shards failed to snapshot for example. It is still possible to restore such indices by setting `partial` to `true`. Please note, that only successfully snapshotted shards will be restored in this case and all missing shards will be recreated empty. @@ -344,10 +344,10 @@ detailed insight into the current state of the recovery process by using <