openzfs-docs icon indicating copy to clipboard operation
openzfs-docs copied to clipboard

Part of the Fedora documentation is outdated.

Open dfgshdsfh opened this issue 2 months ago • 0 comments

Wanted to test the latest release candidate, and found there's some outdated bits of documentation for fedora 42 (technically, I use Nobara 42, but it should be interchangeable for the purposes here).

https://github.com/openzfs/openzfs-docs/blob/master/docs/Getting%20Started/Fedora/index.rst

https://openzfs.github.io/openzfs-docs/Getting%20Started/Fedora/index.html

At the bottom of the guide is this section

Testing repository, which is disabled by default, contains the latest version of OpenZFS which is under active development. These packages should not be used on production systems.

  dnf config-manager --enable zfs-testing
  dnf install zfs

Attempting that results in the following

··• dnf config-manager --enable zfs-testing
Unknown argument "--enable" for command "config-manager". Add "--help" for more information about the arguments.

After some faffing about, I think the following may be what's needed now:

sudo dnf config-manager setopt zfs-testing.enabled=1

However the next step still fails

··• sudo dnf install zfs
Updating and loading repositories:
 ZFS on Linux for Fedora 42 - Testing                                                                    100% |   2.3 KiB/s |   1.5 KiB |  00m01s
>>> Status code: 404 for http://download.zfsonlinux.org/fedora-testing/42/x86_64/repodata/repomd.xml (IP: 52.218.182.10) - http://download.zfsonl
>>> Status code: 404 for http://download.zfsonlinux.org/fedora-testing/42/x86_64/repodata/repomd.xml (IP: 52.218.182.10) - http://download.zfsonl
>>> Status code: 404 for http://download.zfsonlinux.org/fedora-testing/42/x86_64/repodata/repomd.xml (IP: 52.218.182.10) - http://download.zfsonl
>>> Status code: 404 for http://download.zfsonlinux.org/fedora-testing/42/x86_64/repodata/repomd.xml (IP: 52.218.182.10) - http://download.zfsonl
>>> Usable URL not found                                                                                                                         
Repositories loaded.
Package "zfs-2.3.4-1.fc42.x86_64" is already installed.

Nothing to do.

Looking at http://download.zfsonlinux.org/fedora-testing/, turns out there hasn't been a testing build here since Fedora 34 (8 major versions ago). I'm in no particular need for a testing build if the lack of such builds is currently intended, but someone may want to address that little bit of documentation, perhaps mark it outdated or delete it.

From what I remember, I had no problems using the other instructions setting up ZFS months ago. The bit about locking the kernel to suppoorted ZFS version was very useful works great so far. Just wanted to say thanks for making it straightforward.

dfgshdsfh avatar Oct 25 '25 07:10 dfgshdsfh