mirror
/
borg
mirror of https://github.com/borgbackup/borg.git
1
0
Fork 0
Code Issues Releases Wiki Activity

Merge pull request #1015 from ThomasWaldmann/checkpoint-docs 

faq: be more detailed about how checkpoints work, fixes #994
This commit is contained in:
TW 2016-05-05 19:13:18 +02:00
parent 571329e6ae 4c52fcffcc
commit d22bbe17c5
1 changed files with 16 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/faq.rst
View File

@ -223,12 +223,25 @@ Yes, |project_name| supports resuming backups.
During a backup a special checkpoint archive named ``<archive-name>.checkpoint`` During a backup a special checkpoint archive named ``<archive-name>.checkpoint``
is saved every checkpoint interval (the default value for this is 5 is saved every checkpoint interval (the default value for this is 5
minutes) containing all the data backed-up until that point. This means minutes) containing all the data backed-up until that point. This checkpoint
archive is a valid archive, but it is only a partial backup. Having it
in the repo until a successful, full backup is completed is useful because it
references all the transmitted chunks up to the checkpoint time. This means
that at most <checkpoint interval> worth of data needs to be retransmitted that at most <checkpoint interval> worth of data needs to be retransmitted
if a backup needs to be restarted. if you restart the backup.
If a backup was interrupted, you do not need to do any special considerations,
just invoke ``borg create`` as you always do. You may use the same archive name
as in previous attempt or a different one (e.g. if you always include the current
datetime), it does not matter.
|project_name| always does full single-pass backups, so it will start again
from the beginning - but it will be much faster, because some of the data was
already stored into the repo (and is still referenced by the checkpoint
archive), so it does not need to get transmitted and stored again.
Once your backup has finished successfully, you can delete all Once your backup has finished successfully, you can delete all
``<archive-name>.checkpoint`` archives. ``<archive-name>.checkpoint`` archives. If you run ``borg prune``, it will
also care for deleting unneeded checkpoints.
If it crashes with a UnicodeError, what can I do? If it crashes with a UnicodeError, what can I do?
------------------------------------------------- -------------------------------------------------