Dnf upgrade procedure

Template documentation [edit]

This documentation is transcluded from Template:Dnf upgrade procedure/doc. It will not be transcluded on pages that use this template.

This template is used to produce multiple upgrade test cases for release validation testing, found at Template:Installation_test_matrix#Upgrade.

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.
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)