Skip to content

Commit fa68dd0

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

1 file changed

Lines changed: 55 additions & 18 deletions

File tree

  • docs/Getting Started/RHEL-based distro

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

Lines changed: 55 additions & 18 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,68 @@ 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+
sudo dnf config-manager --disable "zfs*"
155+
sudo dnf config-manager --enable zfs-latest
156+
sudo dnf install 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 (EL8+)
163+
--------------------------
164+
165+
*zfs-legacy* repository contains the previous released version of OpenZFS which
166+
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+
sudo dnf config-manager --disable "zfs*"
174+
sudo dnf config-manager --enable zfs-legacy
175+
sudo dnf install zfs
160176

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

164194
.. note::
165-
Use *zfs-testing* for DKMS packages and *zfs-testing-kmod*
195+
Use *zfs-x.y* for DKMS packages and *zfs-x.y-kmod*
166196
for kABI-tracking kmod packages.
167197

198+
Testing Repositories (DEPRECATED)
199+
---------------------------------
200+
201+
*zfs-testing* and *zfs-testing-kmod* repositories are DEPRECATED
202+
in favor of 'zfs-latest'.
203+
204+
168205
Root on ZFS
169206
-----------
170207
.. toctree::

0 commit comments

Comments
 (0)