@@ -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,68 @@ 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+ 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+
168205Root on ZFS
169206-----------
170207.. toctree ::
0 commit comments