chore(kb/omv): review zfs subsection

This commit is contained in:
Michele Cereda
2025-12-30 13:59:29 +01:00
parent b2dca0da8e
commit 31bb67a0c6

View File

@@ -227,21 +227,37 @@ From the CLI, as the `root` user:
## ZFS ## ZFS
Refer [ZFS Plugin For OMV7].
1. [Install OMV-Extras][omv extras]. 1. [Install OMV-Extras][omv extras].
1. Pick one: 1. Pick one:
- \[preferred] Install the `openmediavault-kernel` plugin and use it to install the Proxmox kernel. <details style='padding: 0 0 0 1rem'>
<summary><i><b>[preferred]</b></i> Use the Proxmox kernel.</summary>
Debian does **not** build ZFS kernel modules into any of their kernels due to licensing conflicts, and doing it > [!note]
manually may result in an extensive build process during installation, which is prone to errors.<br/> > Debian does **not** build ZFS kernel modules into any of their kernels due to licensing conflicts, and doing it
The Proxmox-Debian kernel has the ZFS kernel modules preinstalled by default. As kernel upgrades become available > manually may result in an extensive build process during installation, which is prone to errors.<br/>
and are performed, the userland for the Proxmox kernel will always have the required packages to support ZFS. > The Proxmox-Debian kernel has the ZFS kernel modules preinstalled by default. As kernel upgrades become available
> and are performed, the userland for the Proxmox kernel will always have the required packages to support ZFS.
- Disable the kernel's backports APT sources and stick to the mainline one. 1. Install the `openmediavault-kernel` plugin.
1. Use the `kernel` plugin to install the Proxmox kernel.
_System_ > _Kernel_ > _Proxmox_ icon.
1. Reboot.
1. Make sure the default kernel ends with `-pve`, the suffix used for the Proxmox kernel.
1. \[optional, but recommended] Remove non-Proxmox kernels.
</details>
<details style='padding: 0 0 1rem 1rem'>
<summary>Disable APT's backports sources, and stick to Debian's <i>stable</i> kernel.</summary>
> [!warning] > [!warning]
> Linux backport kernels are released quickly enough to leave the userland incomplete at times. This happens often > Linux backport kernels are released quickly enough to leave the userland incomplete at times.<br/>
> with ZFS, resulting in broken package issues. > This happens often with ZFS, resulting in broken package issues.
```sh ```sh
mv -v \ mv -v \
@@ -249,6 +265,8 @@ From the CLI, as the `root` user:
'/etc/apt/sources.list.d/openmediavault-kernel-backports.list.disabled' '/etc/apt/sources.list.d/openmediavault-kernel-backports.list.disabled'
``` ```
</details>
1. Install the `openmediavault-zfs` plugin. 1. Install the `openmediavault-zfs` plugin.
1. Create new pools, or import existing ones. 1. Create new pools, or import existing ones.
@@ -264,6 +282,7 @@ Just enable that property in the pool or datasets.
- [Documentation] - [Documentation]
- [Debian] - [Debian]
- [Proxmox] - [Proxmox]
- [Plugins]
- [OMV-Extras] - [OMV-Extras]
- [Disks maintenance] - [Disks maintenance]
- [ZFS] - [ZFS]
@@ -271,7 +290,7 @@ Just enable that property in the pool or datasets.
### Sources ### Sources
- [How to lock or disable an user account] - [How to lock or disable an user account]
- [ZFS plugin for OMV6] - [ZFS plugin for OMV7]
- [Software & Update Management] - [Software & Update Management]
<!-- <!--
@@ -292,12 +311,13 @@ Just enable that property in the pool or datasets.
[zfs]: zfs.md [zfs]: zfs.md
<!-- Upstream --> <!-- Upstream -->
[documentation]: https://docs.openmediavault.org/en/latest/ [Documentation]: https://docs.openmediavault.org/en/latest/
[Migrate/Restore OMV Settings to Another System with omv-regen]: https://forum.openmediavault.org/index.php?thread/47589-how-to-migrate-restore-omv-settings-to-another-system-with-omv-regen/ [Migrate/Restore OMV Settings to Another System with omv-regen]: https://forum.openmediavault.org/index.php?thread/47589-how-to-migrate-restore-omv-settings-to-another-system-with-omv-regen/
[omv-extras]: https://wiki.omv-extras.org/ [OMV-Extras]: https://wiki.omv-extras.org/
[software & update management]: https://docs.openmediavault.org/en/stable/various/apt.html [Plugins]: https://docs.openmediavault.org/en/stable/plugins.html
[website]: https://www.openmediavault.org/ [Software & Update Management]: https://docs.openmediavault.org/en/stable/various/apt.html
[zfs plugin for omv6]: https://wiki.omv-extras.org/doku.php?id=docs_in_draft:zfs [Website]: https://www.openmediavault.org/
[ZFS Plugin For OMV7]: https://wiki.omv-extras.org/doku.php?id=omv7:omv7_plugins:zfs
<!-- Others --> <!-- Others -->
[hdparm]: https://linux.die.net/man/8/hdparm [hdparm]: https://linux.die.net/man/8/hdparm