calamares/src/modules/zfs
demmm 1b96832bf7 [zfs] adding hostid
using ZFS in combination with dracut exposed a bug on system updates hostid from the Live session does not match hostid installed, thus zpool id no longer matches id created by dracut in the kernel img
to work around this, the zfs module now uses zgenhostid to create a hostid
2022-10-16 12:22:45 +02:00
..
CMakeLists.txt CMake: apply gersemi styling 2022-02-08 16:18:47 +01:00
README.md [zfs] Fix spelling error in readme 2021-11-19 14:24:36 -06:00
zfs.conf [zfs] Update module documentation 2021-11-19 10:46:23 -06:00
zfs.schema.yaml [zfs] Fix schema 2021-11-16 17:14:12 +01:00
ZfsJob.cpp [zfs] adding hostid 2022-10-16 12:22:45 +02:00
ZfsJob.h [zfs] Cleanup code based on review feedback 2021-11-16 09:06:42 -06:00

zfs Module Notes

There are a few considerations to be aware of when enabling the zfs module

  • You must provide zfs kernel modules or kernel support on the ISO for the zfs module to function
    • The zfs kernel module must be loaded prior to the partition module running
    • One way to achieve this is by running modprobe zfs
  • Support for zfs in the partition module is conditional on the zfs module being enabled
  • The config for the default pools and datasets is configured and described in modules/zfs.conf
  • If you use grub with zfs, you must have ZPOOL_VDEV_NAME_PATH=1 in your environment when running grub-install or grub-mkconfig.
    • Calamares will ensure this happens during the bootloader module.
    • It will also add it to /etc/environment so it will be available in the installation
    • If you have an scripts or other processes that trigger grub-mkconfig during the install process, be sure to add that to the environment
  • In most cases, you will need to enable services for zfs support appropriate to your distro. For example, when testing on Arch the following services were enabled:
    • zfs.target
    • zfs-import-cache
    • zfs-mount
    • zfs-import.target