ZFS: auto-snapshots and Windows shadow copies with Samba

ZFS: auto-snapshots and Windows shadow copies with Samba

With ZFS snapshots and Samba’s shadow_copy2 module, you can expose snapshots to Windows clients as shadow copies.

First, install zfs-auto-snapshot on Debian:

apt-get install zfs-auto-snapshot

Default configuration for zfs-auto-snapshot uses specific labels like daily, weekly etc. This is incompatible to samba’s expected snapshot format. As a good workaround, instead of using text labels, I’ve changed the labels to numbers:

31: for daily snapshots
05: for 5 minute interval snapshots
24: for hourly snapshots
12: for monthly snapshots
52: for weekly snapshots

This generates snapshot names like:


Now it is possible to use the label as input for the shadow copy timestamp:

shadow: format = zfs-auto-snap_%S-%Y-%m-%d-%H%M

The “label” which is always an integer, is now used as second (%S) part which is (mostly) negligible for shadow copies.

The required changes for smb.conf are:

    vfs objects = shadow_copy2
    shadow: snapdir = .zfs/snapshot
    shadow: sort = desc
    shadow: format = zfs-auto-snap_%S-%Y-%m-%d-%H%M
    shadow:localtime = no

I’ve modified the installed cronjob files for numeric labels:

# tail -vn +1 /etc/cron.*/zfs-auto-snapshot
==> /etc/cron.daily/zfs-auto-snapshot <==
exec zfs-auto-snapshot --quiet --syslog --label=31 --keep=7 //

==> /etc/cron.d/zfs-auto-snapshot <==

*/5 7-21 * * * root zfs-auto-snapshot -q -g --label=05 --keep=12  //

==> /etc/cron.hourly/zfs-auto-snapshot <==
exec zfs-auto-snapshot --quiet --syslog --label=24 --keep=24 //

==> /etc/cron.monthly/zfs-auto-snapshot <==
exec zfs-auto-snapshot --quiet --syslog --label=12 --keep=3 //

==> /etc/cron.weekly/zfs-auto-snapshot <==
exec zfs-auto-snapshot --quiet --syslog --label=52 --keep=4 //


Daniel Vogelbacher's Picture

About Daniel Vogelbacher

Hi, I'm Daniel, a software developer, Linux administrator and landscape photographer.

Germany https://chaospixel.com