From 71280de08fd69c477a5c61d1f35ec7806642a668 Mon Sep 17 00:00:00 2001 From: Stoiko Ivanov Date: Fri, 23 Nov 2018 18:24:04 +0100 Subject: [PATCH] installation: document advanced ZFS options Additionally add a note that no swap is created when ZFS is selected. Signed-off-by: Stoiko Ivanov --- pve-installation.adoc | 42 ++++++++++++++++++++++++++++++++++++++---- 1 file changed, 38 insertions(+), 4 deletions(-) diff --git a/pve-installation.adoc b/pve-installation.adoc index d27184c..0c05384 100644 --- a/pve-installation.adoc +++ b/pve-installation.adoc @@ -94,10 +94,11 @@ defaults to `ext4`. The installer uses LVM if you select `ext3`, `ext4` or `xfs` as file system, and offers additional option to restrict LVM space (see <>) -If you have more than one disk, you can also use ZFS as file system. -ZFS supports several software RAID levels, so this is specially useful -if you do not have a hardware RAID controller. The `Options` button -lets you select the ZFS RAID level, and you can choose disks there. +You can also use ZFS as file system. ZFS supports several software RAID +levels, so this is specially useful if you do not have a hardware RAID +controller. The `Options` button lets you select the ZFS RAID level, and +you can choose disks there. Additionally you can set additional options (see +<>). [thumbnail="screenshot/pve-select-location.png", float="left"] @@ -204,6 +205,39 @@ will be used. NOTE: LVM requires free space in the VG for snapshot creation (not required for lvmthin snapshots). +[[advanced_zfs_options]] +Advanced ZFS Configuration Options +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The installer creates a ZFS pool `rpool`. When selecting ZFS, no swap space is +created by default. You can leave some unpartitioned space for swap or create +a swap zvol after installation, though the latter can lead to problems +(see <>). + +`ashift`:: + +Defines the `ashift` value for the created pool. The `ashift` needs +to be set at least to the sector-size of the underlying disks (2 to +the power of `ashift` is the sector-size), or any disk, +which might be put in the pool (e.g. during replacing a defective disk). + +`compress`:: + +Defines whether compression is enabled for `rpool`. + +`checksum`:: + +Defines which checksumming algorithm should be used for `rpool`. + +`copies`:: + +Defines the `copies` parameter for `rpool`. Check the `zfs(8)` manpage for the +semantics, and why this does not replace redundancy on disk-level. + +`hdsize`:: + +Defines the total HD size to be used. This way you can save free +space on the HD for further partitioning (e.g. for creating a swap-partition). + ZFS Performance Tips ~~~~~~~~~~~~~~~~~~~~ -- 2.39.2