From e0784ebd8b2c76459c59ccf6d4c5924f11f5f707 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Y=C7=94ch=C4=93n=20Gu=C5=8D=20=E9=83=AD=E5=AE=87=E7=90=9B?= Date: Mon, 23 Oct 2023 20:13:40 +0200 Subject: [PATCH 1/3] Root on ZFS: disable GRUB-incompatible features on bpool MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Root on ZFS: warning againt encrypted send/recv, due to crashes Signed-off-by: Yǔchēn Guō 郭宇琛 --- .../Alpine Linux/Root on ZFS.rst | 20 ++++++++----------- .../Arch Linux/Root on ZFS.rst | 20 ++++++++----------- docs/Getting Started/Fedora/Root on ZFS.rst | 20 ++++++++----------- docs/Getting Started/NixOS/Root on ZFS.rst | 13 +++++++++--- .../RHEL-based distro/Root on ZFS.rst | 20 ++++++++----------- 5 files changed, 42 insertions(+), 51 deletions(-) diff --git a/docs/Getting Started/Alpine Linux/Root on ZFS.rst b/docs/Getting Started/Alpine Linux/Root on ZFS.rst index c393b7c45..c0538dfe0 100644 --- a/docs/Getting Started/Alpine Linux/Root on ZFS.rst +++ b/docs/Getting Started/Alpine Linux/Root on ZFS.rst @@ -28,6 +28,14 @@ Alpine Linux Root on ZFS Unless stated otherwise, it is not recommended to customize system configuration before reboot. +**No encrypted send/recv** + +Multiple kernel crashes have been reported for send/recv operation of +encrypted datasets. If you want to transfer data from encrypted +datasets, use non-ZFS based solution such as ``rsync`` instead. See +`[1] `__, `[2] +`__. + Preparation --------------------------- @@ -264,22 +272,10 @@ System Installation # shellcheck disable=SC2046 zpool create -d \ - -o feature@async_destroy=enabled \ - -o feature@bookmarks=enabled \ - -o feature@embedded_data=enabled \ - -o feature@empty_bpobj=enabled \ - -o feature@enabled_txg=enabled \ - -o feature@extensible_dataset=enabled \ - -o feature@filesystem_limits=enabled \ - -o feature@hole_birth=enabled \ - -o feature@large_blocks=enabled \ - -o feature@lz4_compress=enabled \ - -o feature@spacemap_histogram=enabled \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ -O canmount=off \ - -O compression=lz4 \ -O devices=off \ -O normalization=formD \ -O relatime=on \ diff --git a/docs/Getting Started/Arch Linux/Root on ZFS.rst b/docs/Getting Started/Arch Linux/Root on ZFS.rst index 4894e69f0..76af95f68 100644 --- a/docs/Getting Started/Arch Linux/Root on ZFS.rst +++ b/docs/Getting Started/Arch Linux/Root on ZFS.rst @@ -32,6 +32,14 @@ Arch Linux Root on ZFS Unless stated otherwise, it is not recommended to customize system configuration before reboot. +**No encrypted send/recv** + +Multiple kernel crashes have been reported for send/recv operation of +encrypted datasets. If you want to transfer data from encrypted +datasets, use non-ZFS based solution such as ``rsync`` instead. See +`[1] `__, `[2] +`__. + Preparation --------------------------- @@ -261,22 +269,10 @@ System Installation # shellcheck disable=SC2046 zpool create -d \ - -o feature@async_destroy=enabled \ - -o feature@bookmarks=enabled \ - -o feature@embedded_data=enabled \ - -o feature@empty_bpobj=enabled \ - -o feature@enabled_txg=enabled \ - -o feature@extensible_dataset=enabled \ - -o feature@filesystem_limits=enabled \ - -o feature@hole_birth=enabled \ - -o feature@large_blocks=enabled \ - -o feature@lz4_compress=enabled \ - -o feature@spacemap_histogram=enabled \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ -O canmount=off \ - -O compression=lz4 \ -O devices=off \ -O normalization=formD \ -O relatime=on \ diff --git a/docs/Getting Started/Fedora/Root on ZFS.rst b/docs/Getting Started/Fedora/Root on ZFS.rst index 178063a58..f792694c2 100644 --- a/docs/Getting Started/Fedora/Root on ZFS.rst +++ b/docs/Getting Started/Fedora/Root on ZFS.rst @@ -33,6 +33,14 @@ Fedora Root on ZFS Unless stated otherwise, it is not recommended to customize system configuration before reboot. +**No encrypted send/recv** + +Multiple kernel crashes have been reported for send/recv operation of +encrypted datasets. If you want to transfer data from encrypted +datasets, use non-ZFS based solution such as ``rsync`` instead. See +`[1] `__, `[2] +`__. + Preparation --------------------------- @@ -266,22 +274,10 @@ System Installation # shellcheck disable=SC2046 zpool create -d \ - -o feature@async_destroy=enabled \ - -o feature@bookmarks=enabled \ - -o feature@embedded_data=enabled \ - -o feature@empty_bpobj=enabled \ - -o feature@enabled_txg=enabled \ - -o feature@extensible_dataset=enabled \ - -o feature@filesystem_limits=enabled \ - -o feature@hole_birth=enabled \ - -o feature@large_blocks=enabled \ - -o feature@lz4_compress=enabled \ - -o feature@spacemap_histogram=enabled \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ -O canmount=off \ - -O compression=lz4 \ -O devices=off \ -O normalization=formD \ -O relatime=on \ diff --git a/docs/Getting Started/NixOS/Root on ZFS.rst b/docs/Getting Started/NixOS/Root on ZFS.rst index 32bbcdf94..30277ad20 100644 --- a/docs/Getting Started/NixOS/Root on ZFS.rst +++ b/docs/Getting Started/NixOS/Root on ZFS.rst @@ -29,6 +29,15 @@ Immutable root can be enabled or disabled by setting Unless stated otherwise, it is not recommended to customize system configuration before reboot. +**No encrypted send/recv** + +Multiple kernel crashes have been reported for send/recv operation of +encrypted datasets. If you want to transfer data from encrypted +datasets, use non-ZFS based solution such as ``rsync`` instead. See +`[1] `__, `[2] +`__. + + Preparation --------------------------- @@ -206,13 +215,11 @@ System Installation :: # shellcheck disable=SC2046 - zpool create \ - -o compatibility=grub2 \ + zpool create -d \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ -O canmount=off \ - -O compression=lz4 \ -O devices=off \ -O normalization=formD \ -O relatime=on \ diff --git a/docs/Getting Started/RHEL-based distro/Root on ZFS.rst b/docs/Getting Started/RHEL-based distro/Root on ZFS.rst index 1cdae7179..e42102bbe 100644 --- a/docs/Getting Started/RHEL-based distro/Root on ZFS.rst +++ b/docs/Getting Started/RHEL-based distro/Root on ZFS.rst @@ -30,6 +30,14 @@ Rocky Linux Root on ZFS Unless stated otherwise, it is not recommended to customize system configuration before reboot. +**No encrypted send/recv** + +Multiple kernel crashes have been reported for send/recv operation of +encrypted datasets. If you want to transfer data from encrypted +datasets, use non-ZFS based solution such as ``rsync`` instead. See +`[1] `__, `[2] +`__. + Preparation --------------------------- @@ -260,22 +268,10 @@ System Installation # shellcheck disable=SC2046 zpool create -d \ - -o feature@async_destroy=enabled \ - -o feature@bookmarks=enabled \ - -o feature@embedded_data=enabled \ - -o feature@empty_bpobj=enabled \ - -o feature@enabled_txg=enabled \ - -o feature@extensible_dataset=enabled \ - -o feature@filesystem_limits=enabled \ - -o feature@hole_birth=enabled \ - -o feature@large_blocks=enabled \ - -o feature@lz4_compress=enabled \ - -o feature@spacemap_histogram=enabled \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ -O canmount=off \ - -O compression=lz4 \ -O devices=off \ -O normalization=formD \ -O relatime=on \ From 17d2d6b04a01820342ef100bfd39912da34c8e7b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Y=C7=94ch=C4=93n=20Gu=C5=8D=20=E9=83=AD=E5=AE=87=E7=90=9B?= Date: Mon, 23 Oct 2023 23:31:29 +0200 Subject: [PATCH 2/3] Root on ZFS: use compatibility=legacy for bpool MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Yǔchēn Guō 郭宇琛 --- docs/Getting Started/Alpine Linux/Root on ZFS.rst | 2 +- docs/Getting Started/Arch Linux/Root on ZFS.rst | 2 +- docs/Getting Started/Fedora/Root on ZFS.rst | 2 +- docs/Getting Started/NixOS/Root on ZFS.rst | 2 +- docs/Getting Started/RHEL-based distro/Root on ZFS.rst | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/Getting Started/Alpine Linux/Root on ZFS.rst b/docs/Getting Started/Alpine Linux/Root on ZFS.rst index c0538dfe0..75fa09fe0 100644 --- a/docs/Getting Started/Alpine Linux/Root on ZFS.rst +++ b/docs/Getting Started/Alpine Linux/Root on ZFS.rst @@ -271,7 +271,7 @@ System Installation :: # shellcheck disable=SC2046 - zpool create -d \ + zpool create -o compatibility=legacy \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ diff --git a/docs/Getting Started/Arch Linux/Root on ZFS.rst b/docs/Getting Started/Arch Linux/Root on ZFS.rst index 76af95f68..1dc7dd812 100644 --- a/docs/Getting Started/Arch Linux/Root on ZFS.rst +++ b/docs/Getting Started/Arch Linux/Root on ZFS.rst @@ -268,7 +268,7 @@ System Installation :: # shellcheck disable=SC2046 - zpool create -d \ + zpool create -o compatibility=legacy \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ diff --git a/docs/Getting Started/Fedora/Root on ZFS.rst b/docs/Getting Started/Fedora/Root on ZFS.rst index f792694c2..6bed78af7 100644 --- a/docs/Getting Started/Fedora/Root on ZFS.rst +++ b/docs/Getting Started/Fedora/Root on ZFS.rst @@ -273,7 +273,7 @@ System Installation :: # shellcheck disable=SC2046 - zpool create -d \ + zpool create -o compatibility=legacy \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ diff --git a/docs/Getting Started/NixOS/Root on ZFS.rst b/docs/Getting Started/NixOS/Root on ZFS.rst index 30277ad20..a676faf8a 100644 --- a/docs/Getting Started/NixOS/Root on ZFS.rst +++ b/docs/Getting Started/NixOS/Root on ZFS.rst @@ -215,7 +215,7 @@ System Installation :: # shellcheck disable=SC2046 - zpool create -d \ + zpool create -o compatibility=legacy \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ diff --git a/docs/Getting Started/RHEL-based distro/Root on ZFS.rst b/docs/Getting Started/RHEL-based distro/Root on ZFS.rst index e42102bbe..537715b0a 100644 --- a/docs/Getting Started/RHEL-based distro/Root on ZFS.rst +++ b/docs/Getting Started/RHEL-based distro/Root on ZFS.rst @@ -267,7 +267,7 @@ System Installation :: # shellcheck disable=SC2046 - zpool create -d \ + zpool create -o compatibility=legacy \ -o ashift=12 \ -o autotrim=on \ -O acltype=posixacl \ From 6a793b8c4c2f818da37994b7d6a44cd6354ecce1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Y=C7=94ch=C4=93n=20Gu=C5=8D=20=E9=83=AD=E5=AE=87=E7=90=9B?= Date: Tue, 24 Oct 2023 11:47:31 +0200 Subject: [PATCH 3/3] Add note about native encryption being unmaintained MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Yǔchēn Guō 郭宇琛 --- docs/Getting Started/NixOS/Root on ZFS.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/Getting Started/NixOS/Root on ZFS.rst b/docs/Getting Started/NixOS/Root on ZFS.rst index a676faf8a..a78b6ea69 100644 --- a/docs/Getting Started/NixOS/Root on ZFS.rst +++ b/docs/Getting Started/NixOS/Root on ZFS.rst @@ -35,7 +35,8 @@ Multiple kernel crashes have been reported for send/recv operation of encrypted datasets. If you want to transfer data from encrypted datasets, use non-ZFS based solution such as ``rsync`` instead. See `[1] `__, `[2] -`__. +`__, `[3] +`__. Preparation