Skip to content

Commit 6e3e812

Browse files
committed
Update repository information on RHEL based distros
Signed-off-by: Fluoros <fluoros@fluoroserve.jp>
1 parent 7b04ba9 commit 6e3e812

1 file changed

Lines changed: 51 additions & 17 deletions

File tree

  • docs/Getting Started/RHEL-based distro

docs/Getting Started/RHEL-based distro/index.rst

Lines changed: 51 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ package, then the *kernel-devel* and *zfs* packages. Note that it is
5959
important to make sure that the matching *kernel-devel* package is installed
6060
for the running kernel since DKMS requires it to build OpenZFS.
6161

62-
For EL6 and 7, separately run::
62+
For EL7, separately run::
6363

6464
yum install -y epel-release
6565
yum install -y kernel-devel
@@ -86,7 +86,7 @@ install the kABI-tracking kmods the default repository must be switched
8686
from *zfs* to *zfs-kmod*. Keep in mind that the kABI-tracking kmods are
8787
only verified to work with the distribution-provided, non-Stream kernel.
8888

89-
For EL6 and 7 run::
89+
For EL7 run::
9090

9191
yum-config-manager --disable zfs
9292
yum-config-manager --enable zfs-kmod
@@ -140,31 +140,65 @@ will be aliased to the current minor version (e.g. `8.7`), but you can specify
140140

141141
In the above example, the former packages were built for EL8.7, and the latter for EL8.6.
142142

143-
Testing Repositories
144-
--------------------
143+
Latest Repositories (EL8+)
144+
--------------------------
145145

146-
In addition to the primary *zfs* repository a *zfs-testing* repository
147-
is available. This repository, which is disabled by default, contains
148-
the latest version of OpenZFS which is under active development. These
149-
packages are made available in order to get feedback from users regarding
150-
the functionality and stability of upcoming releases. These packages
151-
**should not** be used on production systems. Packages from the testing
152-
repository can be installed as follows.
146+
*zfs-latest* repository contains the latest released version of OpenZFS which
147+
is under active development. It will contain the newest features, and is
148+
considered stable, but will have less real-world testing use than
149+
*zfs-legacy*. *zfs-latest* is equivalent to the default *zfs* repo on Fedora.
150+
Packages from the latest repository can be installed as follows.
153151

154-
For EL6 and 7 run::
152+
For EL8 and newer run::
155153

156-
yum-config-manager --enable zfs-testing
157-
yum install kernel-devel zfs
154+
dnf config-manager --enable zfs-latest
155+
dnf install kernel-devel zfs
158156

159-
And for EL8 and newer::
157+
.. note::
158+
Use *zfs-latest* for DKMS packages and *zfs-latest-kmod*
159+
for kABI-tracking kmod packages.
160+
161+
Legacy Repositories (EL8+)
162+
--------------------------
163+
164+
*zfs-legacy* repository contains the previous released version of OpenZFS which
165+
is still being actively updated.
166+
Typically, this repository provides same packages as primary *zfs* repository
167+
for RHEL- and CentOS-based distribution.
168+
Packages from the legacy repository can be installed as follows.
169+
170+
For EL8 and newer run::
171+
172+
dnf config-manager --enable zfs-legacy
173+
dnf install kernel-devel zfs
174+
175+
.. note::
176+
Use *zfs-legacy* for DKMS packages and *zfs-legacy-kmod*
177+
for kABI-tracking kmod packages.
178+
179+
Version Specific Repositories (EL8+)
180+
------------------------------------
160181

161-
dnf config-manager --enable zfs-testing
182+
Version specific repositories are provided for users who wants to run a specific
183+
branch (e.g. `2.3.x`) of ZFS.
184+
Packages from the version specific repository can be installed as follows.
185+
186+
For EL8 and newer, to enable version specific repository for ZFS branch x.y, run::
187+
188+
dnf config-manager --enable zfs-x.y
162189
dnf install kernel-devel zfs
163190

164191
.. note::
165-
Use *zfs-testing* for DKMS packages and *zfs-testing-kmod*
192+
Use *zfs-x.y* for DKMS packages and *zfs-x.y-kmod*
166193
for kABI-tracking kmod packages.
167194

195+
Testing Repositories (DEPRECATED)
196+
---------------------------------
197+
198+
*zfs-testing* and *zfs-testing-kmod* repositories are DEPRECATED
199+
in favor of 'zfs-latest'.
200+
201+
168202
Root on ZFS
169203
-----------
170204
.. toctree::

0 commit comments

Comments
 (0)