From Fedora Project Wiki
Description
This tests upgrading from the current Server release (presently Fedora 41) to the next release (presently Fedora 42) with the Server package set using the DNF system upgrade.
Setup
- Perform an installation of Fedora Server 41 with default partitioning.
- Select the Server package set .
- 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.