Skip to content

Commit d85b16c

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

1 file changed

Lines changed: 50 additions & 15 deletions

File tree

  • docs/Getting Started/RHEL-based distro

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

Lines changed: 50 additions & 15 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,66 @@ 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
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
146+
*zfs-latest* repository, which is disabled by default, contains the latest released
147+
version of OpenZFS which is under active development.
148+
These packages are made available in order to get feedback from users regarding
150149
the functionality and stability of upcoming releases. These packages
151-
**should not** be used on production systems. Packages from the testing
150+
**should not** be used on production systems. Packages from the latest
152151
repository can be installed as follows.
153152

154-
For EL6 and 7 run::
153+
For EL8 and newer run::
155154

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

159-
And for EL8 and newer::
158+
.. note::
159+
Use *zfs-latest* for DKMS packages and *zfs-latest-kmod*
160+
for kABI-tracking kmod packages.
161+
162+
Legacy Repositories
163+
-------------------
164+
165+
*zfs-legacy* repository, which is disabled by default, contains the previous
166+
ZFS major version that is still being actively updated.
167+
Typically, this repository provides same packages as primary *zfs* repository
168+
for RHEL- and CentOS-based distribution.
169+
Packages from the legacy repository can be installed as follows.
170+
171+
For EL8 and newer run::
172+
173+
dnf config-manager --enable zfs-legacy
174+
dnf install kernel-devel zfs
160175

161-
dnf config-manager --enable zfs-testing
176+
.. note::
177+
Use *zfs-legacy* for DKMS packages and *zfs-legacy-kmod*
178+
for kABI-tracking kmod packages.
179+
180+
Version Specific Repositories
181+
-----------------------------
182+
183+
Version specific repositories are provided for users who wants to run a specific
184+
branch (e.g. `2.3.x`) of ZFS.
185+
Packages from the version specific repository can be installed as follows.
186+
187+
For EL8 and newer, to enable version specific repository for ZFS branch x.y, run::
188+
189+
dnf config-manager --enable zfs-x.y
162190
dnf install kernel-devel zfs
163191

164192
.. note::
165-
Use *zfs-testing* for DKMS packages and *zfs-testing-kmod*
193+
Use *zfs-x.y* for DKMS packages and *zfs-x.y-kmod*
166194
for kABI-tracking kmod packages.
167195

196+
Testing Repositories (DEPRECATED)
197+
---------------------------------
198+
199+
*zfs-testing* and *zfs-testing-kmod* repositories are DEPRECATED
200+
in favor of 'zfs-latest'.
201+
202+
168203
Root on ZFS
169204
-----------
170205
.. toctree::

0 commit comments

Comments
 (0)