From Fedora Project Wiki

No edit summary
(use the new template for unifying upgrade test cases)
Line 1: Line 1:
{{Testcase upgrade|workstation}}
|description=This test case tests upgrading from the current release ({{FedoraVersion|long}}) to the branched release ({{FedoraVersion|long|next}}) using the [ Fedup] CLI with the workstation package set.
# Perform an installation of the stable release (e.g. {{FedoraVersion|long}}) with default partitioning (no less than 500MB for {{filename|/boot}}), selecting the  workstation package set, or using the workstation live image.
# Typical desktop applications should display and work correctly
#* Running through the [[Test_Results:Current_Desktop_Test|desktop test cases]] would be good for verification.

Revision as of 02:01, 29 January 2015

Associated release criterion
This test case is associated with the Fedora_40_Beta_Release_Criteria#upgrade-requirements release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.


This test case tests upgrading from the current release (presently Fedora Workstation 39) to the next release (presently Fedora Workstation 40) using the dnf-plugin-system-upgrade CLI.

How to test

  1. Perform an installation of Fedora Workstation 39 with default partitioning (no less than 500MB for /boot).
  1. Install the latest stable version of Package-x-generic-16.pngdnf-plugin-system-upgrade package:
    sudo dnf install --best --refresh dnf-plugin-system-upgrade
  2. Download the updates:
    sudo dnf system-upgrade download --refresh --releasever=40
    • You can change 40 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.
  3. To aid debugging, run this command to enable a root shell on VT9 during the upgrade boot:
    sudo systemctl add-wants debug-shell.service

    If anything goes wrong during upgrade, you can live switch to VT9 and inspect current system state, logs, etc.

  4. If downloading has completed without error, run:
    sudo dnf system-upgrade reboot
  5. 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
  6. Once the upgrade process has completed, the system should reboot and an option to boot the new release should be on the grub menu
  7. 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. dnf system-upgrade should run to completion, without error
  2. The upgrade process should complete and reboot without user assistance
  3. The system should be upgraded to the new release without error
  4. The upgraded system should meet all relevant Fedora Release Criteria