Page MenuHomeFreeBSD

Handbook - ZFS rework
ClosedPublic

Authored by carlavilla on Sat, Jul 11, 5:49 PM.
Tags
None
Referenced Files
Unknown Object (File)
Sat, Jul 18, 8:24 AM
Unknown Object (File)
Sat, Jul 18, 6:56 AM
Unknown Object (File)
Sat, Jul 18, 6:03 AM
Unknown Object (File)
Sat, Jul 18, 5:41 AM
Unknown Object (File)
Sat, Jul 18, 4:00 AM
Unknown Object (File)
Fri, Jul 17, 7:15 PM
Unknown Object (File)
Thu, Jul 16, 9:43 PM
Unknown Object (File)
Thu, Jul 16, 2:50 PM
Subscribers

Details

Summary
  • Add RAID-Z expansion, dRAID, special vdevs, hot spares with zfsd, TRIM, pool checkpoints, block cloning, fast dedup, bookmarks, holds, resumable/corrective send, project quotas, direct I/O, and boot environments
  • Add Jails and ZFS crossref target, encryption key loading at boot (zfskeys), and a Pool Properties section
  • Rewrite Tuning to drop removed sysctls (scrub_delay, vdev.cache.size, arc.meta_limit, …); delete the obsolete ZFS-on-i386 section
  • Switch examples to ada device names and GPT partitions
  • Fix the inverted reservation terminology entry, zfs scrub → zpool scrub, stale checksum/compression algorithm lists, and EOL version framing

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

Amazing to read through this rewrite. It is a much needed and substantial rewrite/update of most of the chapter. I only found this small nit.
Make sure to reference Bug 287148, Bug 261212, and maybe even Bug 263321. Thank you very much!

documentation/content/en/books/handbook/zfs/_index.adoc
970

Can you use ada0 ... for the device names in this example as well for consistency?

carlavilla marked an inline comment as done.
carlavilla added inline comments.
documentation/content/en/books/handbook/zfs/_index.adoc
970

Done, thanks!

Excellent, then let's have this in the handbook. Approved!

This revision is now accepted and ready to land.Sun, Jul 12, 9:34 AM

One nit.

documentation/content/en/books/handbook/zfs/_index.adoc
106

What about NVMe? The names are different too.

This revision now requires changes to proceed.Sun, Jul 12, 10:42 AM

One nit.

NVMe is a good point for a future improvement, but I don't think it's a blocker for this change.

documentation/content/en/books/handbook/zfs/_index.adoc
106

What about NVMe? The names are different too.

NVMe is a good point for a future improvement, but I don't think it's a blocker for this change.

carlavilla marked an inline comment as done.
carlavilla marked 2 inline comments as done.
carlavilla added inline comments.
documentation/content/en/books/handbook/zfs/_index.adoc
106

Fixed. Thanks for the review.

I'll make the commit this night or tomorrow

Just finished reading this, great work! Thank you so much for working on this, @carlavilla !

This revision is now accepted and ready to land.Sat, Jul 18, 12:51 PM
This revision was automatically updated to reflect the committed changes.