From Fedora Project Wiki

Obsolete
As of Fedora 23, fedup has been replaced by the DNF_system_upgrade plugin. See Category:Upgrade_system.


Description

This test case tests upgrading from Fedora Workstation 41 to Fedora Workstation 42 with disk encryption enabled using the Fedup CLI.


How to test

  1. Perform an installation of Fedora Workstation 41 with default partitioning (no less than 500MB for /boot) with encryption enabled on the INSTALLATION DESTINATION page.
  2. Do a full system update and reboot
  3. Install the latest version of fedup from the stable or updates repository
  4. If you are doing pre-release testing, find the installation repository URL for the compose you are testing. If you are testing the current compose, the correct location should be https://kojipkgs.fedoraproject.org/mash/rawhide-20241205.n.1/rawhide/(arch)/os - replace (arch) with the correct arch
  5. Start the upgrade prep by executing:
    • sudo fedup --network <version> (--instrepo <URL>)
    • <version> is the version of Fedora you are upgrading to (currently 42)
    • If you are doing pre-release testing, include the --instrepo parameter, with <URL> as the location found in the previous step
  6. If you need to use a local mirror to test a brand new change, start the upgrade prep by executing the following command:
    • sudo fedup --network <version> --instrepo <URL> --disablerepo=fedora --repourl fedora-local=<URL-LOCAL>
    • <URL-LOCAL> is the location of a local fedora repo if needed for faster response speeds
  7. Check /var/log/fedup.log file to see if any errors show up in the output from fedup
  8. Reboot the system if fedup has completed without error
  9. Once the system reboots, there should be a new entry in the boot menu titled System Upgrade
  10. Select the System Upgrade option from the boot menu
  11. The system should boot into the upgrade process and a fedup progress screen should be displayed
    • Pressing Esc should switch from the graphical progress screen to the text progress information display
  12. Once the upgrade process has completed, the system should reboot and an option to boot the new release should be on the grub menu
  13. Log in to the upgraded system, open a terminal, file browser, or other system applications.

Expected Results

  1. fedup should run to completion, without error
  2. The upgrade process should complete and reboot without user assistance beyond selecting System Upgrade from the boot menu
  3. The system should be upgraded to new version without error
  4. The upgraded system should meet all relevant Fedora Release Criteria
  5. Accessing the encrypted storage volume(s) should work normally after the upgrade


Failures not related to encryption
If you encounter an issue that does not seem related to encryption, perform the test case that corresponds to this one without encryption, and verify the problem occurs in that case too. If so, consider it a failure of that test case, not this one.