From Fedora Project Wiki
Description
This test case tests upgrading from the current release (presently Fedora Server 41) to the next release (presently Fedora Server 42) using the dnf-plugin-system-upgrade CLI.
How to test
- Perform an installation of Fedora Server 41 with default partitioning (no less than 500MB for
/boot
).
- 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
dnf system-upgrade
should run to completion, without error- The upgrade process should complete and reboot without user assistance
- The system should be upgraded to the new release without error
- The upgraded system should meet all relevant Fedora Release Criteria