From 2f443cae73143fac3bcbe79222f22e8a1469f846 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Fri, 9 Mar 2018 23:27:31 +0100 Subject: [PATCH] docs: extend append-only repo rollback docs, fixes #3579 (cherry picked from commit 451b22ee511c2470f4df33bbb88d8c5cd5ecb172) --- docs/usage/notes.rst | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/docs/usage/notes.rst b/docs/usage/notes.rst index d5415d0e9..e5a912bfa 100644 --- a/docs/usage/notes.rst +++ b/docs/usage/notes.rst @@ -201,15 +201,28 @@ copy just in case something goes wrong during the recovery. Since recovery is do deleting some files, a hard link copy (``cp -al``) is sufficient. The first step to reset the repository to transaction 5, the last uncompromised transaction, -is to remove the ``hints.N`` and ``index.N`` files in the repository (these two files are -always expendable). In this example N is 13. +is to remove the ``hints.N``, ``index.N`` and ``integrity.N``files in the repository (these +files are always expendable). In this example N is 13. Then remove or move all segment files from the segment directories in ``data/`` starting with file 6:: rm data/**/{6..13} -That's all to it. +That's all to do in the repository. + +If you want to access this rollbacked repository from a client that already has +a cache for this repository, the cache will reflect a newer repository state +than what you actually have in the repository now, after the rollback. + +Thus, you need to clear the cache:: + + borg delete --cache-only repo + +The cache will get rebuilt automatically. Depending on repo size and archive +count, it may take a while. + +You also will need to remove ~/.config/borg/security/REPOID/manifest-timestamp. Drawbacks +++++++++