Differences

This shows you the differences between two versions of the page.

--- project:rsnapshot-zfs-helper [2018/01/24 19:00] – [how] 88.65.214.4
+++ project:rsnapshot-zfs-helper [2021/06/17 00:18] (current) – 37.49.32.145
@@ Line 17: / Line 17: @@
 As zfs uses copy-on-write there is no need to somehow emulate this with '''cp -al ...'''.
-===== setup using rsnapshot-backup =====
+===== example for rsnapshot ======
-==== preface ====
+[[project:rsnapshot-zfs-helper:rsnapshot-example|Example for using rsnapshot-zfs-helper with rsnapshot]]
-I'm using ''rsnapshot-backup'' which is basically a wrapper around rsnapshot.
+===== example for rsnapshot-backup ======
-It uses one setup per system to backup with one config, exclude and script file.
+[[project:rsnapshot-zfs-helper:rsnapshot-backup-example|Example for using rsnapshot-zfs-helper with rsnapshot-backup]]
-There are also individual backup and logging directories.
-There is a scheduler which parallelizes backup runs and a configuration frontend
-using template files to create the backup jobs.
-There is also an enabling mechnism using symlinks.
-A typical backup job configuration consists of:
+==== Example for creating a zpool: ====
 <code>
-/etc/rsnapshot-backup.d/conf.<BACKUP-CLIENT>
+##
-/etc/rsnapshot-backup.d/exclude.<BACKUP-CLIENT>
+## setup zfs (optional)
-/etc/rsnapshot-backup.d/script.<BACKUP-CLIENT>    # optional
+##
-/etc/rsnapshot-backup.d/enabled/conf.<BACKUP-CLIENT> -> ../conf.<BACKUP-CLIENT>
+# 'bpo' kernel won't do the trick
+apt-get install linux-image-amd64
+apt-get clean
+reboot
-/backup/hosts/<BACKUP-CLIENT>/daily.0
+- add "contrib" to the apt-sources
-/backup/hosts/<BACKUP-CLIENT>/...
+apt-get update
-</code>
+apt-get install zfs-dkms zfsutils-linux
+apt-get clean
-Here, this all runs on Debian GNU/Linux, so the examples refer to this environment.
+/sbin/modprobe zfs
-==== details ====
+## caveat: this example (a single disk partition) is neither redundant nor exceptionally performant
+## and serves for illustration purpose only!
+## create partition for zfs:
+Device     Boot   Start       End   Sectors  Size Id Type
+...
+/dev/sda3       4194304 209715199 205520896   98G bf Solaris
-rsnapshot-zfs-helper is to be configured inside rsnapshot's configuration files. i.e. '''/etc/rsnapshot-backup.d/conf.<BACKUP-CLIENT>'''
+## create zpool without mount point
+zpool create zp-bak /dev/sda3 -m none
-Additionally, '''cmd_cp''' has to be set to '''/bin/true''' - so the "cp -al ..." is rendered harmless.
+# create prereq. datasets
+zfs create zp-bak/backup                        -o compression=lz4 -o snapdir=hidden -o xattr=sa -o acltype=posixacl -o mountpoint=/backup
-<code>
+zfs create zp-bak/backup/hosts                  -o compression=lz4 -o snapdir=hidden -o xattr=sa -o acltype=posixacl -o mountpoint=/backup/hosts
-cmd_cp        /bin/true
+df
-cmd_preexec   /usr/sbin/rsnapshot-zfs-helper /etc/rsnapshot-backup.d/enabled/conf.<BACKUP-CLIENT> preexec
+->
-cmd_postexec  /usr/sbin/rsnapshot-zfs-helper /etc/rsnapshot-backup.d/enabled/conf.<BACKUP-CLIENT> postexec
+   Filesystem     1K-blocks    Used Available Use% Mounted on
+   ...
+   zp-bak/backup        99041152     128  99041024   1% /backup
+   zp-bak/backup/hosts  99041152     128  99041024   1% /backup/hosts
 </code>
-Create a zfs dataset using:
+## if you use rsnapshot you have to add the commands commands below
+## if you use rsnapshot-backups the tool rsnapshot-backup-conf will handle those for you
+Create a zfs dataset for a single backup:
 <code>
-zfs create <ZPOOL>/backup/hosts/<BACKUP-CLIENT>/daily.0 -o compression=lz4 -o snapdir=visible -o xattr=sa -o acltype=posixacl -o mountpoint=/backup/hosts/<BACKUP-CLIENT>/daily.0
+zfs create <ZPOOL>/backup/hosts/<BACKUP-CLIENT> -o compression=lz4 -o snapdir=hidden -o xattr=sa -o acltype=posixacl -o mountpoint=/backup/hosts/<BACKUP-CLIENT>/daily.0
+# e.g.
+zfs create zp-bak/backup/hosts/srv42 -o compression=lz4 -o snapdir=hidden -o xattr=sa -o acltype=posixacl -o mountpoint=/backup/hosts/srv42/daily.0
 </code>
@@ Line 82: / Line 97: @@
   * But why then use UTC? **A:** I would have preferred to use ISO-8601 with timezone notation. But zfs does not accept '+' as a character in snapshot names. So I used the format closest by - the UTC timestamp.
   * What's the deal with '''cmd_cp /bin/true'''? **A:** Think of it as NOOP.
+  * Why is the .zfs subdir hidden ('''snapdir=hidden''')? **A:** Because rsync would traverse it and all the subsequent snapshots resulting in really bad performance.
+  * Where can I download rsnapshot-zfs-helper? **A:** https://www.fischglas.de/software/rsnapshot-zfs-helper/