These are policy-driven snapshot management and replication tools which use OpenZFS for underlying next-gen storage. (Btrfs support plans are shelved unless and until btrfs becomes reliable.)
Go to file
Jim Salter 5bad8ec6a7 updated to 1.0.20, updated CHANGELIST 2015-04-01 16:39:28 -04:00
CHANGELIST updated to 1.0.20, updated CHANGELIST 2015-04-01 16:39:28 -04:00
LICENSE Initial commit 2014-11-17 09:34:31 -05:00
README.md more raw HTML for the Pyrrhic win 2014-11-20 12:04:29 -05:00
VERSION updated to 1.0.20, updated CHANGELIST 2015-04-01 16:39:28 -04:00
sanoid updated version number in sanoid 2015-04-01 16:34:22 -04:00
sanoid.conf expanded debug output, fixed and greatly cleaned up config parsing in sanoid 2015-04-01 16:33:46 -04:00
sanoid.defaults.conf expanded debug output, fixed and greatly cleaned up config parsing in sanoid 2015-04-01 16:33:46 -04:00
sleepymutex tested new mutex checking in sanoid snapshot thinning. added sleepymutex tool for future dev use in testing. 2014-11-17 10:33:51 -05:00
syncoid 1.0.19 - working recursive sync in syncoid! 2015-03-30 18:48:00 -04:00
test.pl 1.0.18 - syncoid: broke sync routine out of main() and into syncdataset(), so we can add recursive synchronization in 1.0.19 =) 2015-03-30 18:10:11 -04:00

README.md

sanoid logo

======

Sanoid is a policy-driven snapshot management tool for ZFS filesystems.

You can use Sanoid to create, automatically thin, and monitor snapshots and pool health from a single eminently human-readable TOML config file at /etc/sanoid/sanoid.conf. A typical Sanoid system would have a single cron job:

* * * * * /usr/local/bin/sanoid --cron

And its /etc/sanoid/sanoid.conf might look something like this:

[data/home]
	use_template = production
[data/images/win2012]
	use_template = production
[data/images/win7-spice]
	use_template = production
	hourly = 4

#############################
# templates below this line #
#############################

[template_production]
        hourly = 36
        daily = 30
        monthly = 3
        yearly = 0
        autosnap = yes
        autoprune = yes

Which would be enough to tell sanoid to take and keep 36 hourly snapshots, 30 dailies, 3 monthlies, and no yearlies. Except in the case of data/images/win7-spice, which only keeps 4 hourlies for whatever reason.

Sanoid also includes a replication tool, syncoid, which facilitates the asynchronous incremental replication of ZFS filesystems. A typical syncoid command might look like this:

syncoid data/images/vm backup/images/vm

Which would replicate the specified ZFS filesystem (aka dataset) from the data pool to the backup pool on the local system, or

syncoid data/images/vm root@remotehost:backup/images/vm

Which would push-replicate the specified ZFS filesystem from the local host to remotehost over an SSH tunnel, or

syncoid root@remotehost:data/images/vm backup/images/vm

Which would pull-replicate the filesystem from the remote host to the local system over an SSH tunnel.

Syncoid supports and uses mbuffer buffering, lzop compression, and pv progress bars if the utilities are available on the systems used.