@@ -59,7 +59,7 @@ package, then the *kernel-devel* and *zfs* packages. Note that it is
5959important to make sure that the matching *kernel-devel * package is installed
6060for 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
8686from *zfs * to *zfs-kmod *. Keep in mind that the kABI-tracking kmods are
8787only 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
141141In 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+
168202Root on ZFS
169203-----------
170204.. toctree ::
0 commit comments