mirror of https://github.com/borgbackup/borg.git
Merge pull request #1015 from ThomasWaldmann/checkpoint-docs
faq: be more detailed about how checkpoints work, fixes #994
This commit is contained in:
commit
d22bbe17c5
19
docs/faq.rst
19
docs/faq.rst
|
@ -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?
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
|
|
Loading…
Reference in New Issue