f40d19a2c5
* Let user know that SELinux will be re-enabled after reboot Signed-off-by: Maurice Zhou <jasper@apvc.uk> * compat with future releases: use zfs-dkms and newer repo Signed-off-by: Maurice Zhou <jasper@apvc.uk> * rm unused releasever option Signed-off-by: Maurice Zhou <jasper@apvc.uk> * let user aware of the ignorable errors Signed-off-by: Maurice Zhou <jasper@apvc.uk> * detailed explanations for errors during grub-menu generation Signed-off-by: Maurice Zhou <jasper@apvc.uk> * Build ZFS dkms module in installed system Signed-off-by: Maurice Zhou <jasper@apvc.uk> * switch to dkms package for better compatibility with kernels Signed-off-by: Maurice Zhou <jasper@apvc.uk> * add direct download links for live iso Signed-off-by: Maurice Zhou <jasper@apvc.uk> * rm zfs-fuse before install; mirrorlist Signed-off-by: Maurice Zhou <jasper@apvc.uk> * reformat notes Signed-off-by: Maurice Zhou <jasper@apvc.uk> * rm netconfig - networkmanager is enabled by default Signed-off-by: Maurice Zhou <jasper@apvc.uk> * load kernel module in live; Signed-off-by: Maurice Zhou <jasper@apvc.uk> * rm encrypted bpool: untested Signed-off-by: Maurice Zhou <jasper@apvc.uk> * use u=r,go= permission on key file Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fix typo Signed-off-by: Maurice Zhou <jasper@apvc.uk> * use bash shell Signed-off-by: Maurice Zhou <jasper@apvc.uk> * suggest clean the disks Signed-off-by: Maurice Zhou <jasper@apvc.uk> * add grub-menu auto update Signed-off-by: Maurice Zhou <jasper@apvc.uk> * monitor kernel-core pkg Signed-off-by: Maurice Zhou <jasper@apvc.uk> * copyright 2021 Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fix kernel var detection Signed-off-by: Maurice Zhou <jasper@apvc.uk> * read-only cache file Signed-off-by: Maurice Zhou <jasper@apvc.uk> * replace zfs-mount.service with zfs-mount-generator Signed-off-by: Maurice Zhou <jasper@apvc.uk> * notes for mount and POSIX-compliant Signed-off-by: Maurice Zhou <jasper@apvc.uk> * hard-code kernel version Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fix chroot variable Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fix grub cfg Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fix grub Signed-off-by: Maurice Zhou <jasper@apvc.uk> * missing comment Signed-off-by: Maurice Zhou <jasper@apvc.uk> * comments Signed-off-by: Maurice Zhou <jasper@apvc.uk>
85 lines
1.7 KiB
ReStructuredText
85 lines
1.7 KiB
ReStructuredText
Fedora
|
|
======
|
|
|
|
Contents
|
|
--------
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
:glob:
|
|
|
|
*
|
|
|
|
Installation
|
|
------------
|
|
|
|
Note: this is for installing ZFS on an existing Fedora
|
|
installation. To use ZFS as root file system,
|
|
see below.
|
|
|
|
#. If ``zfs-fuse`` from official Fedora repo is installed,
|
|
remove it first. It is not maintained and should not be used
|
|
under any circumstance::
|
|
|
|
dnf remove -y zfs-fuse
|
|
|
|
#. Add ZFS repo::
|
|
|
|
dnf install -y https://zfsonlinux.org/fedora/zfs-release$(rpm -E %dist).noarch.rpm
|
|
|
|
#. Install ZFS packages::
|
|
|
|
dnf install -y kernel-devel zfs
|
|
|
|
#. Load kernel module::
|
|
|
|
modprobe zfs
|
|
|
|
If kernel module can not be loaded, your kernel version
|
|
might be not yet supported by OpenZFS. Try install
|
|
an LTS kernel::
|
|
|
|
dnf copr enable -y kwizart/kernel-longterm-5.4
|
|
dnf install -y kernel-longterm kernel-longterm-devel
|
|
|
|
Reboot to new LTS kernel, then load kernel module::
|
|
|
|
modprobe zfs
|
|
|
|
It might be necessary to rebuild module::
|
|
|
|
ls -1 /lib/modules \
|
|
| while read kernel_version; do
|
|
dkms autoinstall -k $kernel_version
|
|
done
|
|
|
|
#. By default ZFS kernel modules are loaded upon detecting a pool.
|
|
To always load the modules at boot::
|
|
|
|
echo zfs > /etc/modules-load.d/zfs.conf
|
|
|
|
Testing Repo
|
|
--------------------
|
|
|
|
Testing repository, which is disabled by default, contains
|
|
the latest version of OpenZFS which is under active development.
|
|
These packages
|
|
**should not** be used on production systems.
|
|
|
|
::
|
|
|
|
dnf config-manager --enable zfs-testing
|
|
dnf install zfs
|
|
|
|
Root on ZFS
|
|
-----------
|
|
ZFS can be used as root file system for Fedora.
|
|
An installation guide is available.
|
|
|
|
`Start here <Root%20on%20ZFS/0-overview.html>`__.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
:glob:
|
|
|
|
Root on ZFS/*
|