From Fedora Project Wiki

Template documentation [edit]

This documentation is transcluded from Template:Gnome software 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.
Upgrade to Rawhide instructions
Skip this box when upgrading to Fedora Branched.

But if you need to perform this test case when testing an upgrade to Rawhide, use the following edits to trick the system into being able to upgrade to it:

  1. Navigate to ~/.cache/gnome-software/fedora-pkgdb-collections
  2. Run: 
    jq '(.collections |= map(if .version == "devel" then .koji_name = "f42" | .status = "Active" | .version = "42" else . end))' fedora.json > fedora_updated.json
  3. Replace the original file with the updated version: 
    mv fedora_updated.json fedora.json


  1. Enable showing pre-release Fedora versions using this command: 
    gsettings set org.gnome.software show-upgrade-prerelease true
  2. Reset gnome-software's counter for showing notifications: 
    TIMESTAMP=$(date '+%s' --date='08:00 8 days ago')
gsettings set org.gnome.software upgrade-notification-timestamp $TIMESTAMP
  3. Reboot the system or log out and in again, then wait for a few minutes.
  4. A notification of an available upgrade should appear. If it does, click it. If not, note this as a bug, but run gnome-software (Software in the overview), click the Updates button, and click the refresh button at top-left.
  5. Check that there is a banner informing you about the new release, with Learn More and Download buttons.
    • If you're trying to perform an N+2 upgrade (i.e. going from Fedora 40 to Fedora 42), the banner should be informing about the N+2 release (Fedora 42), not N+1 (Fedora 41). The same applies to the displayed documentation ("Learn More") and downloaded updates, all of that should be related to N+2 release.
  6. Click Learn More, it should load an appropriate document or URL.
    • If it links to an appropriate URL but there is no content for the URL yet, this may be reported to the documentation team, but is not a failure of this test.
  7. Click Download. A progress bar should be displayed while the upgrade download takes place.
  8. Once the download process completes, click the Install button that should appear.
    • If a dialog asking for administrator authentication appears, complete it.
  9. Click the Restart & Install button that should appear next. The system should reboot immediately.
  10. Once the system reboots, the system should boot into the upgrade environment and a graphical progress screen should be displayed.
  11. Once the upgrade process has completed, the system should reboot and an option to boot the new release should be on the grub menu.
  12. Log in to the upgraded system and test basic system applications (a terminal, file browser, or other, depending on the system flavor).
Retrieved from "https://fedoraproject.org/w/index.php?title=Template:Gnome_software_upgrade_procedure&oldid=704697"