@@ -18,14 +18,16 @@ Snapshots can be stored in either local or remote repositories.
1818Remote repositories can reside on Amazon S3, HDFS, Microsoft Azure,
1919Google Cloud Storage,
2020and other platforms supported by a {plugins}/repository.html[repository plugin].
21+ // end::snapshot-intro[]
2122
2223{es} takes snapshots incrementally: the snapshotting process only copies data
2324to the repository that was not already copied there by an earlier snapshot,
2425avoiding unnecessary duplication of work or storage space. This means you can
25- safely take snapshots very frequently with minimal overhead. However, snapshots
26- are also logically independent: deleting a snapshot does not affect the
26+ safely take snapshots very frequently with minimal overhead. This
27+ incrementality only applies within a single repository because no data is
28+ shared between repositories. Snapshots are also logically independent from each
29+ other, even within a single repository: deleting a snapshot does not affect the
2730integrity of any other snapshot.
28- // end::snapshot-intro[]
2931
3032// tag::restore-intro[]
3133You can <<snapshots-restore-snapshot,restore snapshots>> to a running cluster, which includes all data streams and indices in the snapshot
@@ -39,17 +41,22 @@ You can use
3941to automatically take and manage snapshots.
4042
4143// tag::backup-warning[]
42- WARNING: You cannot back up an {es} cluster by simply copying
43- the data directories of all of its nodes. {es} may be making changes to
44- the contents of its data directories while it is running; copying its data
45- directories cannot be expected to capture a consistent picture of their contents.
46- If you try to restore a cluster from such a backup, it may fail and report
47- corruption and/or missing files. Alternatively, it may appear to have succeeded
48- though it silently lost some of its data. The only reliable way to back up a
49- cluster is by using the snapshot and restore functionality.
50-
44+ WARNING: **The only reliable and supported way to back up a cluster is by
45+ taking a snapshot**. You cannot back up an {es} cluster by making copies of the
46+ data directories of its nodes. There are no supported methods to restore any
47+ data from a filesystem-level backup. If you try to restore a cluster from such
48+ a backup, it may fail with reports of corruption or missing files or other data
49+ inconsistencies, or it may appear to have succeeded having silently lost some
50+ of your data.
5151// end::backup-warning[]
5252
53+ A copy of the data directories of a cluster's nodes does not work as a backup
54+ because it is not a consistent representation of their contents at a single
55+ point in time. You cannot fix this by shutting down nodes while making the
56+ copies, nor by taking atomic filesystem-level snapshots, because {es} has
57+ consistency requirements that span the whole cluster. You must use the built-in
58+ snapshot functionality for cluster backups.
59+
5360[discrete]
5461[[snapshot-restore-version-compatibility]]
5562=== Version compatibility
@@ -116,4 +123,3 @@ include::monitor-snapshot-restore.asciidoc[]
116123include::delete-snapshot.asciidoc[]
117124include::../slm/index.asciidoc[]
118125include::../searchable-snapshots/index.asciidoc[]
119-
0 commit comments