Add support for RHEL Root on ZFS (#180)
* Add support for RHEL Root on ZFS Signed-off-by: Maurice Zhou <jasper@apvc.uk> * require cryptsetup.target before mounting swap Signed-off-by: Maurice Zhou <jasper@apvc.uk> * disable sshd Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fedora 34; grub workaround Signed-off-by: Maurice Zhou <jasper@apvc.uk> * add manual redirect to new page Signed-off-by: Maurice Zhou <jasper@apvc.uk> * orphan page Signed-off-by: Maurice Zhou <jasper@apvc.uk> * Remove `RHEL and CentOS` from index Co-authored-by: George Melikov <mail@gmelikov.ru>
This commit is contained in:
ne9z
160
docs/Getting Started/RHEL-based distro/index.rst
Normal file
160
docs/Getting Started/RHEL-based distro/index.rst
Normal file
@@ -0,0 +1,160 @@
|
||||
RHEL-based distro
|
||||
=======================
|
||||
|
||||
Contents
|
||||
--------
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:glob:
|
||||
|
||||
*
|
||||
|
||||
`DKMS`_ or `kABI-tracking kmod`_ style packages are provided for RHEL and
|
||||
CentOS based distributions from the OpenZFS repository. These packages are
|
||||
updated as new versions are released. Only the current repository for each
|
||||
major release is updated with new packages. Packages are available for the
|
||||
following configurations:
|
||||
|
||||
| **EL Releases:** 6, 7.9, 8.4
|
||||
| **Architectures:** x86_64
|
||||
|
||||
To simplify installation a *zfs-release* package is provided which includes
|
||||
a zfs.repo configuration file and public signing key. All official OpenZFS
|
||||
packages are signed using this key, and by default yum or dnf will verify a
|
||||
package's signature before allowing it be to installed. Users are strongly
|
||||
encouraged to verify the authenticity of the ZFS on Linux public key using
|
||||
the fingerprint listed here.
|
||||
|
||||
| **Location:** /etc/pki/rpm-gpg/RPM-GPG-KEY-zfsonlinux
|
||||
| **EL6 Package:** `zfs-release.el6.noarch.rpm`_ (zfs-0.8.x)
|
||||
| **EL7.9 Package:** `zfs-release.el7_9.noarch.rpm`_ (zfs-0.8.x)
|
||||
| **EL8.4 Package:** `zfs-release.el8_4.noarch.rpm`_ (zfs-2.0.5)
|
||||
| **Archived Repositories:** `el7_5`_, `el7_6`_, `el7_7`_, `el7_8`_, `el8_0`_, `el8_1`_, `el8_2`_, `el8_3`_
|
||||
|
||||
| **Download from:**
|
||||
`pgp.mit.edu <https://pgp.mit.edu/pks/lookup?search=0xF14AB620&op=index&fingerprint=on>`__
|
||||
| **Fingerprint:** C93A FFFD 9F3F 7B03 C310 CEB6 A9D5 A1C0 F14A B620
|
||||
|
||||
For RHEL/CentOS versions 6 and 7 run::
|
||||
|
||||
yum install https://zfsonlinux.org/epel/zfs-release$(rpm -E %distro).noarch.rpm
|
||||
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-zfsonlinux
|
||||
|
||||
And for RHEL/CentOS 8 and newer::
|
||||
|
||||
dnf install https://zfsonlinux.org/epel/zfs-release$(rpm -E %distro).noarch.rpm
|
||||
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-zfsonlinux
|
||||
|
||||
After installing the *zfs-release* package and verifying the public key
|
||||
users can opt to install either the DKMS or kABI-tracking kmod style packages.
|
||||
DKMS packages are recommended for users running a non-distribution kernel or
|
||||
for users who wish to apply local customizations to OpenZFS. For most users
|
||||
the kABI-tracking kmod packages are recommended in order to avoid needing to
|
||||
rebuild OpenZFS for every kernel update.
|
||||
|
||||
DKMS
|
||||
----
|
||||
|
||||
To install DKMS style packages issue the following commands. First add the
|
||||
`EPEL repository`_ which provides DKMS by installing the *epel-release*
|
||||
package, then the *kernel-devel* and *zfs* packages. Note that it is
|
||||
important to make sure that the matching *kernel-devel* package is installed
|
||||
for the running kernel since DKMS requires it to build OpenZFS.
|
||||
|
||||
For RHEL/CentOS versions 6 and 7 run::
|
||||
|
||||
yum install epel-release kernel-devel zfs
|
||||
|
||||
And for RHEL/CentOS 8 and newer::
|
||||
|
||||
dnf install epel-release kernel-devel zfs
|
||||
|
||||
.. note::
|
||||
When switching from DKMS to kABI-tracking kmods first uninstall the
|
||||
existing DKMS packages. This should remove the kernel modules for all
|
||||
installed kernels, then the kABI-tracking kmods can be installed as
|
||||
described in the section below.
|
||||
|
||||
kABI-tracking kmod
|
||||
------------------
|
||||
|
||||
By default the *zfs-release* package is configured to install DKMS style
|
||||
packages so they will work with a wide range of kernels. In order to
|
||||
install the kABI-tracking kmods the default repository must be switched
|
||||
from *zfs* to *zfs-kmod*. Keep in mind that the kABI-tracking kmods are
|
||||
only verified to work with the distribution provided kernel.
|
||||
|
||||
For RHEL/CentOS versions 6 and 7 run::
|
||||
|
||||
yum-config-manager --disable zfs
|
||||
yum-config-manager --enable zfs-kmod
|
||||
yum install zfs
|
||||
|
||||
And for RHEL/CentOS 8 and newer::
|
||||
|
||||
dnf config-manager --disable zfs
|
||||
dnf config-manager --enable zfs-kmod
|
||||
dnf install zfs
|
||||
|
||||
By default the OpenZFS kernel modules are automatically loaded when a ZFS
|
||||
pool is detected. If you would prefer to always load the modules at boot
|
||||
time you must create an ``/etc/modules-load.d/zfs.conf`` file::
|
||||
|
||||
echo zfs >/etc/modules-load.d/zfs.conf
|
||||
|
||||
.. note::
|
||||
When updating to a new RHEL/CentOS minor release the existing kmod
|
||||
packages may not work due to upstream kABI changes in the kernel.
|
||||
After upgrading users must uninstall OpenZFS and then reinstall it
|
||||
from the matching repository as described in this section.
|
||||
|
||||
Testing Repositories
|
||||
--------------------
|
||||
|
||||
In addition to the primary *zfs* repository a *zfs-testing* repository
|
||||
is available. This repository, which is disabled by default, contains
|
||||
the latest version of OpenZFS which is under active development. These
|
||||
packages are made available in order to get feedback from users regarding
|
||||
the functionality and stability of upcoming releases. These packages
|
||||
**should not** be used on production systems. Packages from the testing
|
||||
repository can be installed as follows.
|
||||
|
||||
For RHEL/CentOS versions 6 and 7 run::
|
||||
|
||||
yum-config-manager --enable zfs-testing
|
||||
yum install kernel-devel zfs
|
||||
|
||||
And for RHEL/CentOS 8 and newer::
|
||||
|
||||
dnf config-manager --enable zfs-testing
|
||||
dnf install kernel-devel zfs
|
||||
|
||||
.. note::
|
||||
Use *zfs-testing* for DKMS packages and *zfs-testing-kmod*
|
||||
kABI-tracking kmod packages.
|
||||
|
||||
RHEL 8-based distro Root on ZFS
|
||||
-------------------------------
|
||||
`Start here <RHEL%208-based%20distro%20Root%20on%20ZFS/0-overview.html>`__.
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:glob:
|
||||
|
||||
RHEL 8-based distro Root on ZFS/*
|
||||
|
||||
.. _kABI-tracking kmod: https://elrepoproject.blogspot.com/2016/02/kabi-tracking-kmod-packages.html
|
||||
.. _DKMS: https://en.wikipedia.org/wiki/Dynamic_Kernel_Module_Support
|
||||
.. _zfs-release.el6.noarch.rpm: https://zfsonlinux.org/epel/zfs-release.el6.noarch.rpm
|
||||
.. _zfs-release.el7_9.noarch.rpm: https://zfsonlinux.org/epel/zfs-release.el7_9.noarch.rpm
|
||||
.. _zfs-release.el8_4.noarch.rpm: https://zfsonlinux.org/epel/zfs-release.el8_4.noarch.rpm
|
||||
.. _el7_5: https://zfsonlinux.org/epel/zfs-release.el7_5.noarch.rpm
|
||||
.. _el7_6: https://zfsonlinux.org/epel/zfs-release.el7_6.noarch.rpm
|
||||
.. _el7_7: https://zfsonlinux.org/epel/zfs-release.el7_7.noarch.rpm
|
||||
.. _el7_8: https://zfsonlinux.org/epel/zfs-release.el7_8.noarch.rpm
|
||||
.. _el8_0: https://zfsonlinux.org/epel/zfs-release.el8_0.noarch.rpm
|
||||
.. _el8_1: https://zfsonlinux.org/epel/zfs-release.el8_1.noarch.rpm
|
||||
.. _el8_2: https://zfsonlinux.org/epel/zfs-release.el8_2.noarch.rpm
|
||||
.. _el8_3: https://zfsonlinux.org/epel/zfs-release.el8_3.noarch.rpm
|
||||
|
||||
.. _EPEL repository: https://fedoraproject.org/wiki/EPEL
|
||||
Reference in New Issue
Block a user