mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-26 17:57:59 +00:00
126 lines
5.3 KiB
Text
126 lines
5.3 KiB
Text
borg prune visualized
|
|
=====================
|
|
|
|
Assume it is 2016-01-01, today's backup has not yet been made, you have
|
|
created at least one backup on each day in 2015 except on 2015-12-19 (no
|
|
backup made on that day), and you started backing up with borg on
|
|
2015-01-01.
|
|
|
|
This is what borg prune --keep-daily 14 --keep-monthly 6 --keep-yearly 1
|
|
would keep.
|
|
|
|
Backups kept by the --keep-daily rule are marked by a "d" to the right,
|
|
backups kept by the --keep-monthly rule are marked by a "m" to the right,
|
|
and backups kept by the --keep-yearly rule are marked by a "y" to the
|
|
right.
|
|
|
|
Calendar view
|
|
-------------
|
|
|
|
2015
|
|
January February March
|
|
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
|
|
1y 2 3 4 1 1
|
|
5 6 7 8 9 10 11 2 3 4 5 6 7 8 2 3 4 5 6 7 8
|
|
12 13 14 15 16 17 18 9 10 11 12 13 14 15 9 10 11 12 13 14 15
|
|
19 20 21 22 23 24 25 16 17 18 19 20 21 22 16 17 18 19 20 21 22
|
|
26 27 28 29 30 31 23 24 25 26 27 28 23 24 25 26 27 28 29
|
|
30 31
|
|
|
|
April May June
|
|
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
|
|
1 2 3 4 5 1 2 3 1 2 3 4 5 6 7
|
|
6 7 8 9 10 11 12 4 5 6 7 8 9 10 8 9 10 11 12 13 14
|
|
13 14 15 16 17 18 19 11 12 13 14 15 16 17 15 16 17 18 19 20 21
|
|
20 21 22 23 24 25 26 18 19 20 21 22 23 24 22 23 24 25 26 27 28
|
|
27 28 29 30 25 26 27 28 29 30 31 29 30m
|
|
|
|
|
|
July August September
|
|
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
|
|
1 2 3 4 5 1 2 1 2 3 4 5 6
|
|
6 7 8 9 10 11 12 3 4 5 6 7 8 9 7 8 9 10 11 12 13
|
|
13 14 15 16 17 18 19 10 11 12 13 14 15 16 14 15 16 17 18 19 20
|
|
20 21 22 23 24 25 26 17 18 19 20 21 22 23 21 22 23 24 25 26 27
|
|
27 28 29 30 31m 24 25 26 27 28 29 30 28 29 30m
|
|
31m
|
|
|
|
October November December
|
|
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
|
|
1 2 3 4 1 1 2 3 4 5 6
|
|
5 6 7 8 9 10 11 2 3 4 5 6 7 8 7 8 9 10 11 12 13
|
|
12 13 14 15 16 17 18 9 10 11 12 13 14 15 14 15 16 17d18d19 20d
|
|
19 20 21 22 23 24 25 16 17 18 19 20 21 22 21d22d23d24d25d26d27d
|
|
26 27 28 29 30 31m 23 24 25 26 27 28 29 28d29d30d31d
|
|
30m
|
|
|
|
List view
|
|
---------
|
|
|
|
--keep-daily 14 --keep-monthly 6 --keep-yearly 1
|
|
----------------------------------------------------------------
|
|
1. 2015-12-31 (2015-12-31 kept (2015-12-31 kept
|
|
2. 2015-12-30 by daily rule) by daily rule)
|
|
3. 2015-12-29 1. 2015-11-30 1. 2015-01-01 (oldest)
|
|
4. 2015-12-28 2. 2015-10-31
|
|
5. 2015-12-27 3. 2015-09-30
|
|
6. 2015-12-26 4. 2015-08-31
|
|
7. 2015-12-25 5. 2015-07-31
|
|
8. 2015-12-24 6. 2015-06-30
|
|
9. 2015-12-23
|
|
10. 2015-12-22
|
|
11. 2015-12-21
|
|
12. 2015-12-20
|
|
(no backup made on 2015-12-19)
|
|
13. 2015-12-18
|
|
14. 2015-12-17
|
|
|
|
|
|
Notes
|
|
-----
|
|
|
|
2015-12-31 is kept due to the --keep-daily 14 rule (because it is applied
|
|
first), not due to the --keep-monthly or --keep-yearly rule.
|
|
|
|
The --keep-yearly 1 rule does not consider the December 31st backup because it
|
|
has already been kept due to the daily rule. There are no backups available
|
|
from previous years, so the --keep-yearly target of 1 backup is not satisfied.
|
|
Because of this, the 2015-01-01 archive (the oldest archive available) is kept.
|
|
|
|
The --keep-monthly 6 rule keeps Nov, Oct, Sep, Aug, Jul and Jun. December is
|
|
not considered for this rule, because that backup was already kept because of
|
|
the daily rule.
|
|
|
|
2015-12-17 is kept to satisfy the --keep-daily 14 rule - because no backup was
|
|
made on 2015-12-19. If a backup had been made on that day, it would not keep
|
|
the one from 2015-12-17.
|
|
|
|
We did not include weekly, hourly, minutely or secondly rules to keep this
|
|
example simple. They all work in basically the same way.
|
|
|
|
The weekly rule is easy to understand roughly, but hard to understand in all
|
|
details. If interested, read "ISO 8601:2000 standard week-based year".
|
|
|
|
The 13weekly and 3monthly rules are two different strategies for keeping one
|
|
every quarter of a year. There are `multiple ways` to define a quarter-year;
|
|
borg prune recognizes two:
|
|
|
|
* --keep-13weekly keeps one backup every 13 weeks using ISO 8601:2000's
|
|
definition of the week-based year. January 4th is always included in the
|
|
first week of a year, and January 1st to 3rd may be in week 52 or 53 of the
|
|
previous year. Week 53 is also in the fourth quarter of the year.
|
|
* --keep-3monthly keeps one backup every 3 months. January 1st to
|
|
March 31, April 1st to June 30th, July 1st to September 30th, and October 1st
|
|
to December 31st form the quarters.
|
|
|
|
If the subtleties of the definition of a quarter year don't matter to you, a
|
|
short summary of behavior is:
|
|
|
|
* --keep-13weekly favors keeping backups at the beginning of Jan, Apr, July,
|
|
and Oct.
|
|
* --keep-3monthly favors keeping backups at the end of Dec, Mar, Jun, and Sept.
|
|
* Both strategies will have some overlap in which backups are kept.
|
|
* The differences are negligible unless backups considered for deletion were
|
|
created weekly or more frequently.
|
|
|
|
.. _multiple ways: https://en.wikipedia.org/wiki/Calendar_year#Quarter_year
|