From fdf29103cc212c5d61712a6ddb27590060b20226 Mon Sep 17 00:00:00 2001 From: "Scot W. Stevenson" Date: Sat, 13 Apr 2019 16:41:29 +0200 Subject: [PATCH] Further edits because of stupidity --- docs/zfs_configuration.md | 19 ++++++++++--------- docs/zfs_overview.md | 2 +- 2 files changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/zfs_configuration.md b/docs/zfs_configuration.md index d4651d3c..ffeefd39 100644 --- a/docs/zfs_configuration.md +++ b/docs/zfs_configuration.md @@ -35,8 +35,8 @@ redundancy. The actual Ubuntu system will be on a different drive and is not our concern. > [Root on ZFS](https://github.com/zfsonlinux/zfs/wiki/Ubuntu-18.04-Root-on-ZFS) -> is currently still a hassle for Ubuntu. If that changes, this document might -> be updated accordingly. Until then, don't ask us about it. +> is still a hassle for Ubuntu. If that changes, this document might be updated +> accordingly. Until then, don't ask us about it. The Ubuntu kernel is already ready for ZFS. We only need the utility package which we install with `sudo apt install zfsutils`. @@ -54,21 +54,22 @@ create our ZFS pool, we will use a command in this form: The options from simple to complex are: -****: ZFS pools traditionally take their names from characters in the [The +**NAME**: ZFS pools traditionally take their names from characters in the [The Matrix](https://www.imdb.com/title/tt0133093/fullcredits). The two most common -are `tank` and `dozer`. Whatever you use, it should be short. +are `tank` and `dozer`. Whatever you use, it should be short - think `ash`, not +`xenomorph`. -****: The Linux command `lsblk` will give you a quick overview of the +**DRIVES**: The Linux command `lsblk` will give you a quick overview of the hard drives in the system. However, we don't pass the drive specification in the format `/dev/sde` because this is not persistent. Instead, -[use](https://github.com/zfsonlinux/zfs/wiki/FAQ#selecting-dev-names-when-creating-a-pool) +[always use](https://github.com/zfsonlinux/zfs/wiki/FAQ#selecting-dev-names-when-creating-a-pool) the output of `ls /dev/disk/by-id/` to find the drives' IDs. -****: This is required to pass the [sector +**ASHIFT**: This is required to pass the [sector size](https://github.com/zfsonlinux/zfs/wiki/FAQ#advanced-format-disks) of the drive to ZFS for optimal performance. You might have to do this by hand because -some drives lie: Whereas modern drives have 4k sector sizes (or 8k in case of -many SSDs), they will report 512 bytes because Windows XP [can't handle 4k +some drives lie: Whereas modern drives have 4k sector sizes (or 8k for many +SSDs), they will report 512 bytes because Windows XP [can't handle 4k sectors](https://support.microsoft.com/en-us/help/2510009/microsoft-support-policy-for-4k-sector-hard-drives-in-windows). ZFS tries to [catch the liars](https://github.com/zfsonlinux/zfs/blob/master/cmd/zpool/zpool_vdev.c) and diff --git a/docs/zfs_overview.md b/docs/zfs_overview.md index f095520e..1d46d841 100644 --- a/docs/zfs_overview.md +++ b/docs/zfs_overview.md @@ -215,7 +215,7 @@ RAM instead. [introduction](https://pthree.org/2012/04/17/install-zfs-on-debian-gnulinux/) to ZFS on Linux. If you only read one part, make it the [explanation of the ARC](https://pthree.org/2012/12/07/zfs-administration-part-iv-the-adjustable-replacement-cache/), - ZFS read cache. + ZFS' read cache. - One of the best books on ZFS around is _FreeBSD Mastery: ZFS_ by Michael W. Lucas and Allan Jude. Though it is written for FreeBSD, the general guidelines