Fischglas

User Tools

Site Tools

Trace:
project:rsnapshot-zfs-helper

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
project:rsnapshot-zfs-helper [2018/01/25 21:12] – [details] 88.65.214.4project: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 ...'''. 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: 
  
-<code> 
-/etc/rsnapshot-backup.d/conf.<BACKUP-CLIENT> 
-/etc/rsnapshot-backup.d/exclude.<BACKUP-CLIENT> 
-/etc/rsnapshot-backup.d/script.<BACKUP-CLIENT>    # optional 
-/etc/rsnapshot-backup.d/enabled/conf.<BACKUP-CLIENT> -> ../conf.<BACKUP-CLIENT> 
  
-/backup/hosts/<BACKUP-CLIENT>/daily.0 
-/backup/hosts/<BACKUP-CLIENT>/... 
-</code> 
- 
-Here, this all runs on Debian GNU/Linux, so the examples refer to this environment. 
- 
-==== details ==== 
- 
-rsnapshot-zfs-helper is to be configured inside rsnapshot's configuration files. i.e. '''/etc/rsnapshot-backup.d/conf.<BACKUP-CLIENT>''' 
- 
-Additionally, '''cmd_cp''' has to be set to '''/bin/true''' - so the "cp -al ..." is rendered harmless. 
- 
-<code> 
-cmd_cp        /bin/true 
-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 
-</code> 
  
-Example for creating a zpool:+==== Example for creating a zpool: ====
 <code> <code>
 ## ##
Line 73: Line 46:
 /sbin/modprobe zfs /sbin/modprobe zfs
  
 +## caveat: this example (a single disk partition) is neither redundant nor exceptionally performant
 +## and serves for illustration purpose only! 
 ## create partition for zfs: ## create partition for zfs:
 Device     Boot   Start       End   Sectors  Size Id Type Device     Boot   Start       End   Sectors  Size Id Type
Line 82: Line 57:
  
 # create prereq. datasets # create prereq. datasets
-zfs create zp-bak/backup                        -o compression=lz4 -o snapdir=visible -o xattr=sa -o acltype=posixacl -o mountpoint=/backup +zfs create zp-bak/backup                        -o compression=lz4 -o snapdir=hidden -o xattr=sa -o acltype=posixacl -o mountpoint=/backup 
-zfs create zp-bak/backup/hosts                  -o compression=lz4 -o snapdir=visible -o xattr=sa -o acltype=posixacl -o mountpoint=/backup/hosts+zfs create zp-bak/backup/hosts                  -o compression=lz4 -o snapdir=hidden -o xattr=sa -o acltype=posixacl -o mountpoint=/backup/hosts
 df   df  
 -> ->
Line 92: Line 67:
 </code> </code>
  
 +## 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: Create a zfs dataset for a single backup:
 <code> <code>
-zfs create <ZPOOL>/backup/hosts/<BACKUP-CLIENT> -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. # e.g.
-zfs create zp-bak/backup/hosts/srv42 -o compression=lz4 -o snapdir=visible -o xattr=sa -o acltype=posixacl -o mountpoint=/backup/hosts/srv42/daily.0+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> </code>
  
Line 120: 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.   * 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.   * 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/
  
  
  
project/rsnapshot-zfs-helper.1516911168.txt.gz · Last modified: 2018/01/25 21:12 by 88.65.214.4