From Fedora Project Wiki
Description
This tests upgrading from the current Workstation release (presently Fedora 41) to the next release (presently Fedora 42) with the Workstation package set or a Live image using the DNF system upgrade.
Setup
- Perform an installation of Fedora Workstation 41 with default partitioning.
- Select the Workstation package set or use the Workstation Live image.
- Apply all system updates and reboot.
How to test
- Install the latest stable version of
dnf-plugin-system-upgrade
package:sudo dnf install --best --refresh dnf-plugin-system-upgrade
- Download the updates:
sudo dnf system-upgrade download --refresh --releasever=42
- You can change
42
to test upgrading to a different Fedora release, of course. - If you need to use a local mirror to test a brand new change, you can enable it as normal, i.e. by adding
--enablerepo=<name>
option to the command line.
- You can change
- To aid debugging, run this command to enable a root shell on VT9 during the upgrade boot:
sudo systemctl add-wants system-update.target debug-shell.service
If anything goes wrong during upgrade, you can live switch to VT9 and inspect current system state, logs, etc.
- If downloading has completed without error, run:
sudo dnf system-upgrade reboot
- Once the system reboots, the system should boot into the upgrade process and a graphical progress screen should be displayed
- Pressing Esc should switch from the graphical progress screen to the text progress information display
- Once the upgrade process has completed, the system should reboot and an option to boot the new release should be on the grub menu
- Log in to the upgraded system and test basic system applications (a terminal, file browser, or other, depending on the system flavor)
Expected Results
- The upgrade tool should run to completion without an error.
- The upgrade process should complete and reboot without user assistance.
- The system should be upgraded to the new release without error.
- If the original system had an encrypted storage, there should be no problem accessing encrypted storage in the upgraded system as well.
- The upgraded system should meet all relevant Fedora Release Criteria.