Revisiting Server installation media naming convention #126
Labels
No labels
Ansible
basic support
Ansible
NFS server
Ansible/pxe
Ansible/Wildfly
distribution
bug
distribution
release test
documentation
improvement
documentation
new
documentation
review request
documentation
update
meeting
need info
project
backup&restore
project
home server spin-off
project
LocalKDC
project
strengthening updates
status
in progress
status
on hold
status
pending activity
No milestone
No project
No assignees
6 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
server/tickets#126
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Our main installation media is still named 'Fedora-Server-dvd-x86_64'. Probably a lot of younger users are wondering, what DVD means.
Some time ago we agreed to std (standard) instead, but the acronym has an unwanted connotation. We need an alternative.
Proposals so far:
full /* net*
local / net
add your proposal!
Additionally, the naming convention is inconsistent. The order ot the various naming elements varies:
Fedora-Server-dvd-x86_64-Rawhide-xxx.iso
Fedora-Server-dvd-x86_64-40_Beta-1.10.iso
Fedora-Server-KVM-40_Beta-1.10.x86_64.qcow2
Fedora-Server-39-1.5-aarch64
Fedora-Server-40_Beta-1.10.aarch64.raw.xz
Fedora-Server-40-20240328.n.0.aarch64.raw.xz
etc.
We had a releng ticket which (partly) resolved this
https://pagure.io/releng/issue/11089
Metadata Update from @pboy:
For a better overview:
The current situation is:
Released
Fedora-Server-39-1.5-x86_64-CHECKSUM
Fedora-Server-dvd-x86_64-39-1.5.iso
Fedora-Server-netinst-x86_64-39-1.5.iso
Fedora-Server-39-1.5-x86_64-CHECKSUM
Fedora-Server-KVM-39-1.5.x86_64.qcow2
Fedora-Server-39-1.5-aarch64-CHECKSUM
Fedora-Server-dvd-aarch64-39-1.5.iso
Fedora-Server-netinst-aarch64-39-1.5.iso
Fedora-Server-39-1.5-aarch64-CHECKSUM
Fedora-Server-39-1.5.aarch64.raw.xz
Fedora-Server-KVM-39-1.5.aarch64.qcow2
Branched
Fedora-Server-dvd-x86_64-40-20240408.n.0.iso
Fedora-Server-netinst-x86_64-40-20240408.n.0.iso
Fedora-Server-iso-40-x86_64-20240408.n.0-CHECKSUM
Fedora-Server-KVM-40-20240408.n.0.x86_64.qcow2
Fedora-Server-images-40-x86_64-20240408.n.0-CHECKSUM
Fedora-Server-dvd-aarch64-40-20240408.n.0.iso
Fedora-Server-iso-40-aarch64-20240408.n.0-CHECKSUM
Fedora-Server-netinst-aarch64-40-20240408.n.0.iso
Fedora-Server-40-20240408.n.0.aarch64.raw.xz
Fedora-Server-KVM-40-20240408.n.0.aarch64.qcow2
Fedora-Server-images-40-aarch64-20240408.n.0-CHECKSUM
Fedora-Server-dvd-ppc64le-40-20240408.n.0.iso
Fedora-Server-iso-40-ppc64le-20240408.n.0-CHECKSUM
Fedora-Server-netinst-ppc64le-40-20240408.n.0.iso.manifest
Fedora-Server-KVM-40-20240408.n.0.ppc64le.qcow2
Fedora-Server-images-40-ppc64le-20240408.n.0-CHECKSUM
Fedora-Server-dvd-s390x-40-20240408.n.0.iso
Fedora-Server-iso-40-s390x-20240408.n.0-CHECKSUM
Fedora-Server-netinst-s390x-40-20240408.n.0.iso
Fedora-Server-KVM-40-20240408.n.0.s390x.qcow2
Fedora-Server-images-40-s390x-20240408.n.0-CHECKSUM
Beta
Fedora-Server-dvd-x86_64-40_Beta-1.10.iso
Fedora-Server-iso-40_Beta-1.10-x86_64-CHECKSUM
Fedora-Server-netinst-x86_64-40_Beta-1.10.iso
Fedora-Server-KVM-40_Beta-1.10.x86_64.qcow2
Fedora-Server-images-40_Beta-1.10-x86_64-CHECKSUM
Fedora-Server-dvd-aarch64-40_Beta-1.10.iso
Fedora-Server-iso-40_Beta-1.10-aarch64-CHECKSUM
Fedora-Server-netinst-aarch64-40_Beta-1.10.iso
Fedora-Server-40_Beta-1.10.aarch64.raw.xz
Fedora-Server-KVM-40_Beta-1.10.aarch64.qcow2
Fedora-Server-images-40_Beta-1.10-aarch64-CHECKSUM
Rawhide
Fedora-Server-dvd-x86_64-Rawhide-20240403.n.0.iso
Fedora-Server-netinst-x86_64-Rawhide-20240403.n.0.iso
Fedora-Server-iso-Rawhide-x86_64-20240403.n.0-CHECKSUM
Fedora-Server-KVM-Rawhide-20240403.n.0.x86_64.qcow2
Fedora-Server-images-Rawhide-x86_64-20240403.n.0-CHECKSUM
Fedora-Server-dvd-aarch64-Rawhide-20240403.n.0.iso
Fedora-Server-iso-Rawhide-aarch64-20240403.n.0-CHECKSUM
Fedora-Server-netinst-aarch64-Rawhide-20240403.n.0.iso
Fedora-Server-KVM-Rawhide-20240403.n.0.aarch64.qcow2
Fedora-Server-Rawhide-20240403.n.0.aarch64.raw.xz
Fedora-Server-images-Rawhide-aarch64-20240403.n.0-CHECKSUM
In future we should aim at:
Naming convention
Fedora-Server----.
Released
Fedora-Server-39-img-x86_64-1.5.CHECKSUM
Fedora-Server-39-iso-x86_64-1.5.CHECKSUM
Fedora-Server-39-offline-x86_64-1.5.iso
Fedora-Server-39-online-x86_64-1.5.iso
Fedora-Server-39-virt-x86_64-1.5.qcow2
Fedora-Server-39-img-aarch64-1.5.CHECKSUM
Fedora-Server-39-iso-aarch64-1.5.CHECKSUM
Fedora-Server-39-offline-aarch64-1.5.iso
Fedora-Server-39-online-aarch64-1.5.iso
Fedora-Server-39-rawsbc-aarch64-1.5.raw.xz
Fedora-Server-39-virt-aarch64-1.5.qcow2
Or in alphabetical order / directory listing:
Released:
Fedora-Server-41-img-aarch64-1.5.CHECKSUM
Fedora-Server-41-img-x86_64-1.5.CHECKSUM
Fedora-Server-41-iso-aarch64-1.5.CHECKSUM
Fedora-Server-41-iso-x86_64-1.5.CHECKSUM
Fedora-Server-41-offline-aarch64-1.5.iso
Fedora-Server-41-offline-x86_64-1.5.iso
Fedora-Server-41-online-aarch64-1.5.iso
Fedora-Server-41-online-x86_64-1.5.iso
Fedora-Server-41-rawsbc-aarch64-1.5.raw.xz
Fedora-Server-41-virt-aarch64-1.5.qcow2
Fedora-Server-41-virt-x86_64-1.5.qcow2
And e.g. branched would just replace the version part:
Fedora-Server-41-img-aarch64-20240408.n.0.CHECKSUM
Fedora-Server-41-img-x86_64-20240408.n.0.CHECKSUM
Fedora-Server-41-iso-aarch64-20240408.n.0.CHECKSUM
Fedora-Server-41-iso-x86_64-20240408.n.0.CHECKSUM
Fedora-Server-41-offline-aarch64-20240408.n.0.iso
Fedora-Server-41-offline-x86_64-20240408.n.0.iso
Fedora-Server-41-online-aarch64-20240408.n.0.iso
Fedora-Server-41-online-x86_64-20240408.n.0.iso
Fedora-Server-41-rawsbc-aarch64-20240408.n.0.raw.xz
Fedora-Server-41-virt-aarch64-20240408.n.0.qcow2
Fedora-Server-41-virt-x86_64-20240408.n.0.qcow2
The same with beta and rawhide respectively.
Fedora-Server-41-offline-aarch64-Beta-1.10.iso
Fedora-Server-41-offline-aarch64-Rawhide-20240403.n.0.iso
Online / Offline sound as the best to me (but it's missing in the proposal section in the original post).
Hello folks, have we reached an agreement as to what the new naming convention should look like, Yes? Can someone with more information add that as a comment in the releng ticket, so we can take that as a single source of truth when we start working on it?
Metadata Update from @pboy:
trying to get filenames perfectly consistent (in terms of where the arch, version and 'payload' strings appear, and how exactly the string is constructed) is a bit of a fool's errand - I did it years ago, but more or less gave up (see https://fedoraproject.org/wiki/User:Adamwill/Draft_fedora_image_naming_policy ). it's less important than it used to be since we have compose metadata, e.g. https://dl.fedoraproject.org/pub/alt/stage/41_Beta-1.2/metadata/images.json . If you want to find a given Fedora image in a random compose, get the image metadata and look for a subvariant + type + format + arch match; for Fedora images, the combination of those properties per image should be unique and remain consistent between composes. The metadata gives you the path to the image with those properties within the compose.
The exact contents of the filename depends a lot on the tool being used to build it, and can be hard to get perfectly consistent between different tools, but it's somewhat easier to get the metadata straight.
Changing the name of the 'dvd' image should be fine as the Server DVD is the only one we ship any more, but changing 'netinst' to 'offline' is a more significant change as we also have an Everything netinst, and I'm not sure whether we can change Server without changing that (and it might be confusing to do so even if we could).
Metadata Update from @pboy:
I think it is time now to at least minimally adjust the file naming.
For Fedora Server we have currently:
Fedora-Server-44-1.7-aarch64-CHECKSUM
Fedora-Server-44-1.7-x86_64-CHECKSUM (for images)
Fedora-Server-44-1.7-x86_64-CHECKSUM. (for iso)
Fedora-Server-dvd-aarch64-44-1.7.iso
Fedora-Server-dvd-x86_64-44-1.7.iso
Fedora-Server-Guest-Generic-44-1.7.aarch64.qcow2
Fedora-Server-Guest-Generic-44-1.7.x86_64.qcow2
Fedora-Server-Host-Generic-44-1.7.aarch64.raw.xz
Fedora-Server-Host-Generic-Rawhide-20260429.n.0.aarch64.raw.xz
Fedora-Server-netinst-aarch64-44-1.7.iso
Fedora-Server-netinst-x86_64-44-1.7.iso
At bare minimum we should
Of course, it would be better to have a general naming convention as spezified above.
The problem with checksums is that all the downloads are on the same page. If you download them one after the other, the ISO checksum file overwrites the other one without you realizing. This then leads to unexpected errors during the verification process if you simply follow the instructions.
We should also urgently get fixed the download page
It currently reads:
We should rearrange it according to relevanz
@pboy wrote in #126 (comment):
I happened to notice your above comment and went ahead and made the change over the weekend. Let me know if anything still needs reordering.
Many many Thanks! Looks much better so, strucktured, systematic.
Status as of meeting May 13, 2026
We start voting about the naming "offline-install" / "online-install"
+1
Have you co-ordinated this with release engineering? The names are not just strings that it is easy to change. They are built into the image generation tools. They are also names that are shared with RHEL and which have been used for years, so automation may assume them. For netinst, Server is not the only 'netinst' image, there is also the Everything netinst. It would seem confusing to have different names for Server and Everything netinst images.
The webpage uses the 'old' file names, so there shouldn't be a problem. But the presentation is an improvement in terms of structure.
Regarding the file naming, Kevin joined the discussion, and I'm sure he has an eye on it. The agreement is what we would like to have. We had a lot of variations over the time. Now we have to look what is possible and how to do it. That's the next step. And there is no need to rush, I think.
And regarding 'Everything', we have no DVD Everything, so there is no need to distinguish between installation methods. That makes it easier.
"offline-install" / "online-install"
+1