Skip to content

Commit d8534cf

Browse files
authored
Reword docs on snapshot repo backup (#115062) (#115069)
Because of #93575 it's not sufficient to mark repositories with `readonly: true` while taking a backup. The only safe way to avoid writes is to completely unregister them.
1 parent f9b6b57 commit d8534cf

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

docs/reference/snapshot-restore/register-repository.asciidoc

+5-4
Original file line numberDiff line numberDiff line change
@@ -320,10 +320,11 @@ that you have an archive copy of its contents that you can use to recreate the
320320
repository in its current state at a later date.
321321

322322
You must ensure that {es} does not write to the repository while you are taking
323-
the backup of its contents. You can do this by unregistering it, or registering
324-
it with `readonly: true`, on all your clusters. If {es} writes any data to the
325-
repository during the backup then the contents of the backup may not be
326-
consistent and it may not be possible to recover any data from it in future.
323+
the backup of its contents. If {es} writes any data to the repository during
324+
the backup then the contents of the backup may not be consistent and it may not
325+
be possible to recover any data from it in future. Prevent writes to the
326+
repository by unregistering the repository from the cluster which has write
327+
access to it.
327328

328329
Alternatively, if your repository supports it, you may take an atomic snapshot
329330
of the underlying filesystem and then take a backup of this filesystem

0 commit comments

Comments
 (0)