mirror of https://github.com/digint/btrbk
documentation: moved documentation on non-btrfs sources from FAQ to README; adapted key features and debian link
parent
5c8d3f94f3
commit
799665bac1
|
@ -21,6 +21,7 @@ btrbk-current
|
||||||
* Better error handling for send/receive commands (close: #33).
|
* Better error handling for send/receive commands (close: #33).
|
||||||
* Hardened ssh_filter_btrbk.sh script: fine-grained access control,
|
* Hardened ssh_filter_btrbk.sh script: fine-grained access control,
|
||||||
restrict-path option, sudo option (close: #45).
|
restrict-path option, sudo option (close: #45).
|
||||||
|
* Added example cron script.
|
||||||
|
|
||||||
btrbk-0.20.0
|
btrbk-0.20.0
|
||||||
|
|
||||||
|
|
34
README.md
34
README.md
|
@ -19,6 +19,8 @@ Key Features:
|
||||||
- Backups to multiple destinations
|
- Backups to multiple destinations
|
||||||
- Transfer via ssh
|
- Transfer via ssh
|
||||||
- Resume of backups (if backup target was not reachable for a while)
|
- Resume of backups (if backup target was not reachable for a while)
|
||||||
|
- Encrypted backups to non-btrfs destinations
|
||||||
|
- Transaction log
|
||||||
- Display file changes between two backups
|
- Display file changes between two backups
|
||||||
|
|
||||||
btrbk is intended to be run as a cron job.
|
btrbk is intended to be run as a cron job.
|
||||||
|
@ -63,7 +65,7 @@ Grab the digint portage overlay from:
|
||||||
|
|
||||||
### Debian Based Distros
|
### Debian Based Distros
|
||||||
|
|
||||||
btrbk is in `stretch (testing) (utils)`: https://packages.debian.org/stretch/btrbk
|
btrbk is in `sid (unstable) (utils)`: https://packages.debian.org/sid/btrbk
|
||||||
|
|
||||||
Packages are also available via NeuroDebian: http://neuro.debian.net/pkgs/btrbk.html
|
Packages are also available via NeuroDebian: http://neuro.debian.net/pkgs/btrbk.html
|
||||||
|
|
||||||
|
@ -262,6 +264,36 @@ from 192.168.0.42. The source filesystem is never altered because of
|
||||||
`snapshot_preserve_daily all`.
|
`snapshot_preserve_daily all`.
|
||||||
|
|
||||||
|
|
||||||
|
Example: backup from non-btrfs source
|
||||||
|
-------------------------------------
|
||||||
|
|
||||||
|
First create a btrfs subvolume on the backup server:
|
||||||
|
|
||||||
|
# btrfs subvolume create /mnt/btr_backup/myhost_sync
|
||||||
|
|
||||||
|
In your daily cron script, prior to running btrbk, sync your source to
|
||||||
|
`myhost_sync`, something like:
|
||||||
|
|
||||||
|
rsync -a --delete -e ssh myhost.mydomain.com://data/ /mnt/btr_backup/myhost_sync/
|
||||||
|
|
||||||
|
Then run btrbk, with myhost_sync configured *without any targets* as
|
||||||
|
follows:
|
||||||
|
|
||||||
|
volume /mnt/btr_backup
|
||||||
|
subvolume myhost_sync
|
||||||
|
snapshot_name myhost
|
||||||
|
|
||||||
|
snapshot_preserve_daily 14
|
||||||
|
snapshot_preserve_weekly 20
|
||||||
|
snapshot_preserve_monthly all
|
||||||
|
|
||||||
|
This will produce daily snapshots `/mnt/btr_backup/myhost.20150101`,
|
||||||
|
with retention as defined with the snapshot_preserve_* options.
|
||||||
|
|
||||||
|
Note that the provided script: "contrib/cron/btrbk-mail" has support
|
||||||
|
for this!
|
||||||
|
|
||||||
|
|
||||||
Example: encrypted backup to non-btrfs target
|
Example: encrypted backup to non-btrfs target
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
|
|
28
doc/FAQ.md
28
doc/FAQ.md
|
@ -1,34 +1,6 @@
|
||||||
btrbk FAQ
|
btrbk FAQ
|
||||||
=========
|
=========
|
||||||
|
|
||||||
How can I backup from non-btrfs hosts?
|
|
||||||
--------------------------------------
|
|
||||||
|
|
||||||
First create a btrfs subvolume on the backup server:
|
|
||||||
|
|
||||||
# btrfs subvolume create /mnt/btr_backup/myhost_sync
|
|
||||||
|
|
||||||
In your daily cron script, prior to running btrbk, sync your source to
|
|
||||||
`myhost_sync`, something like:
|
|
||||||
|
|
||||||
rsync -a --delete -e ssh myhost.mydomain.com://data/ /mnt/btr_backup/myhost_sync/
|
|
||||||
|
|
||||||
Then run btrbk, with myhost_sync configured *without any targets* as
|
|
||||||
follows:
|
|
||||||
|
|
||||||
volume /mnt/btr_backup
|
|
||||||
subvolume myhost_sync
|
|
||||||
snapshot_name myhost
|
|
||||||
|
|
||||||
snapshot_create always
|
|
||||||
snapshot_preserve_daily 14
|
|
||||||
snapshot_preserve_weekly 20
|
|
||||||
snapshot_preserve_monthly all
|
|
||||||
|
|
||||||
This will produce daily snapshots `/mnt/btr_backup/myhost.20150101`,
|
|
||||||
with retention as defined with the snapshot_preserve_* options.
|
|
||||||
|
|
||||||
|
|
||||||
How can I auto-mount btrfs filesystems used by btrbk?
|
How can I auto-mount btrfs filesystems used by btrbk?
|
||||||
-----------------------------------------------------
|
-----------------------------------------------------
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue