zrepl/zrepl v0.4.0-rc1 on GitHub

Please check https://zrepl.github.io/v0.4.0-rc1/changelog.html for a full list of changes.

Highlights

Support for zfs send / recv flags in the config (send: -wLcepbS , recv: -ox ).
Parallel replication is now configurable.
New zrepl status UI:
- Interactive job selection.
- Interactively zrepl signal jobs.
- Filter filesystems in the job view by name.
- An approximation of the old UI is still included as –mode legacy but will be removed in a future release of zrepl.

Breaking Changes

New syntax to trigger a job replication: renamed zrepl signal wakeup JOB to zrepl signal replication JOB
For users who skipped the 0.3.1 update: please make sure your pruning grid config is correct.
The grid bugfix caused unexpected snapshot deletions for some users.

New Users

We provide two quick-start guides for different usage scenarios: server-to-server continuous backup, and workstation-to-external-disk backup.

We highly recommend studying the overview section of the configuration chapter to understand how zrepl replication works.

Testing & Upgrading

There are no protocol or backwards-incompatible config format changes.
The only breaking change is the rename of the wakeup signal to replication.
Recommendations for updating:

Read the Changelog

Download & run the platformtest binary published with this release.

sudo ./platformtest-linux-amd64 \
  -imagepath /tmp/zreplplatformtest.img \
  -mountpoint /tmp/zreplplatformtest \
  -poolname zreplplatformtest

Deploy the binary release / install the package.

Note 1: There is a bug in Linux 5.8 and newer that sometimes leaves zfs recv unresponsive. A workaround is being investigated in #424 . Note that this issue also occurs with zrepl 0.3 and many Go versions - it was not introduced by the changes included in this release.

Note 2: There is a Go runtime bug on FreeBSD 12.2 and newer that manifests in Go runtime crashes and/or lock-ups of the zrepl daemon. zrepl has a tracking issue which contains the link to the Go upstream issue. A workaround is available. Note that this issue also occurs with zrepl 0.3 and many Go versions - it was not introduced by the changes included in this release.

Donations

zrepl is a spare-time project but nonetheless requires significant development and maintenance effort.
Please consider donating to support future development. Thank you!

Binary Releases

Binaries & distroy packages were produced with the following docker container:

sudo docker tag zrepl_release problame/zrepl_build:v0.4.0-rc1
sudo docker push problame/zrepl_build:v0.4.0-rc1      
v0.4.0-rc1: digest: sha256:8e57281d1e6dda28e91fbdc402ac08200fea8714b15de13d83ccb67cf139c71f size: 4100