zrepl/zrepl v0.5.0 on GitHub

Please check out the docs changelog for a full list of changes.

Highlights

Bandwidth limiting (Thanks, Prominic.NET, Inc.)
zrepl status: use a * to indicate which filesystem is currently replicating
fix encrypt-on-receive + placeholders use case (issue #504)
- Before this fix, plain sends to a receiver with an encrypted root_fs could be received unencrypted if zrepl needed to create placeholders on the receiver.
- Existing zrepl users should read the docs and check zfs get -r encryption,zrepl:placeholder PATH_TO_ROOTFS on the receiver.
- Thanks to @mologie and @razielgn for reporting and testing!

Breaking Changes

The RPC protocol version was bumped; all zrepl daemons in a setup must be updated and restarted before replication can resume.
Rename mis-spelled send option embbeded_data to embedded_data.

New Users

We provide quick-start guides for different usage scenarios.
Also, we recommend studying the overview section of the configuration chapter to understand how zrepl replication works.

Testing & Upgrading

Read the Changelog

Download & run the platformtest binary on a test system.

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

Deploy the binary release / install the package.

Platform Issues

The long-standing Go runtime bug on FreeBSD 12.2 has been fixed in FreeBSD 13, the patch will be part of 12.4, and there will be an ERRATA for 12.3.

Community

The chat room moved from IRC to Matrix.

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

The released binaries were produced with the following docker container:

sudo docker tag zrepl_release problame/zrepl_build:v0.5.0
sudo docker push problame/zrepl_build:v0.5.0
v0.5.0: digest: sha256:9ffbb9b6a6a579c0c9d17779b6ba1e4f3960e3b3139761b29a6e89ad1ff0aa97 size: 4101