Page MenuHomeFreeBSD

Handbook - ZFS rework
ClosedPublic

Authored by carlavilla on Sat, Jul 11, 5:49 PM.
Tags
None
Referenced Files
F165288364: D58175.id182174.diff
Fri, Aug 7, 10:46 AM
F165288361: D58175.id182168.diff
Fri, Aug 7, 10:46 AM
F165288360: D58175.id181823.diff
Fri, Aug 7, 10:46 AM
F165288357: D58175.id181822.diff
Fri, Aug 7, 10:46 AM
F165288355: D58175.id181785.diff
Fri, Aug 7, 10:46 AM
F165288353: D58175.id.diff
Fri, Aug 7, 10:46 AM
F165288311: D58175.diff
Fri, Aug 7, 10:45 AM
F165285825: D58175.diff
Fri, Aug 7, 10:22 AM
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 Not Applicable
Unit
Tests Not Applicable

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.