From Fedora Project Wiki

Revision as of 20:55, 9 November 2016 by Adamwill (talk | contribs) (create Workstation current gnome-software upgrade test case)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


Description

This test case tests upgrading from the current release (presently Fedora Workstation 39) to the next release (presently Fedora Workstation 40) using the GNOME Software GUI.


How to test

  1. Perform an installation of Fedora Workstation 39 with default partitioning (no less than 500MB for /boot).
Idea.png
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 = "f40" | .status = "Active" | .version = "40" 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 38 to Fedora 40), the banner should be informing about the N+2 release (Fedora 40), not N+1 (Fedora 39). 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).

Expected Results

  1. An upgrade notification should appear (after upgrade to pre-release has been enabled, if necessary)
  2. The Learn More button 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
  3. A progress bar should be displayed while the upgrade download takes place
  4. Once the download is complete, clicking Install and following subsequent steps should reboot the system into the upgrade process
  5. The upgrade process should complete and reboot without user assistance
  6. The system should be upgraded to the new release without error
  7. The upgraded system should meet all relevant Fedora Release Criteria