napcok/calamares
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ff7ceb2e2b
calamares/src/modules/zfs
History
Adriaan de Groot b1742876fd [zfs] Correct user-visible spelling of ZFS 
In Camel-cased source code, Zfs, but for user-visible strings,
ZFS (or zfs, but needs to be consistent).
2022-02-17 15:51:15 +01:00
..
CMakeLists.txt [zfs] Initial commit for zfs module 2021-11-15 18:41:34 -06: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] Correct user-visible spelling of ZFS 2022-02-17 15:51:15 +01:00
ZfsJob.h [zfs] Cleanup code based on review feedback 2021-11-16 09:06:42 -06:00

README.md

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