From Fedora Project Wiki

m (adding sudo to the fedup-cli command to comply with wiki standards)
(better description)
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{admon/important|Draft Test Case for New Software|This test case is very new and may still have errors. Fedup is also new software and this procedure may change. Please ask questions if anything is not clear and let us know if there are problems}}
{{QA/Test_Case
{{QA/Test_Case
|description=This case is for upgrading using to upgrade the current release ({{FedoraVersion|long}}) to the branched release ({{FedoraVersion|long|next}}) using the [https://github.com/wgwoods/fedup Fedup] CLI.
|description=This test case tests upgrading from the current release ({{FedoraVersion|long}}) to the branched release ({{FedoraVersion|long|next}}) using the [https://github.com/wgwoods/fedup Fedup] CLI with the default desktop package set.
|actions=
|actions=
# Perform an installation of the stable release (e.g. {{FedoraVersion|long}}) with default partitioning (no less than 500MB for {{filename|/boot}}), selecting the 'GNOME Desktop' 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 default package set, or using the default live image.
# Do a full system update
{{fedup_upgrade_procedure}}
# Install {{package|fedup}}
#* Be sure to get the latest release, this may involve enabling updates-testing (put <code>--enablerepo=updates-testing</code> between {{command|yum}} and {{command|install}} on the command line)
# Find the URL of the branched TC or RC under test. This URL should be of the form
#* <pre>http://dl.fedoraproject.org/pub/alt/stage/18-Beta-<name>/Fedora/<arch>/os</pre>
# Start the upgrade prep by executing following command
#* {{command|sudo fedup-cli --network 18 --debuglog fedupdebug.log --instrepo <URL>}}
#* <URL> is the location found in the previous step
# Check the {{filename|fedupdebug.log}} file if any errors show up in the output from {{command|fedup-cli}}
# Reboot the system if {{command|fedup-cli}} has completed without error.
# Once the system reboots, there should be a new entry in the GRUB menu titled {{command|System Upgrade}}.
# Select the {{command|System Upgrade}} option from the GRUB menu
#* If you want to be able to see progress during the upgrade, append {{command|rd.upgrade.debugshell}} to the end of the kernel parameters
# The system should boot into the upgrade process and a plymouth boot screen should be displayed
#* There may not be any output behind the plymouth splash, this doesn't mean that the upgrade stopped
#* If you enabled the debug shell, it will be available on VT2. You will need to wait until the upgrade process has completely started and type {{command|exit}} in order to access the upgrade environment.
#* Upgrade progress can be seen by using {{command|journalctl -a -o cat}} and scrolling to the bottom ({{command|Control+G}} will get you to the bottom if you don't want to scroll the whole way).
# Once the upgrade process has completed, the system will reboot and an option to boot {{FedoraVersion|long|next}} will be on the grub menu
# Log in to upgraded system, open a terminal, file browser, or other system applications.
|results=
|results=
# {{command|fedup-cli}} will run to completion, without error
{{fedup_upgrade_results}}
# The upgrade process should complete and reboot without user assistance beyond selecting {{command|System Upgrade}} from the GRUB menu
# Typical desktop applications should display and work correctly
# The system should be upgraded to new version without error.
#* Running through the [[Test_Results:Current_Desktop_Test|desktop test cases]] would be good for verification.
# The opened terminal, file browser, or other system applications should display and work correctly.
#* Running through the [[Test_Results:Current_Desktop_Test|desktop test cases]] would be a good for verification.
}}
}}
[[Category:Upgrade_system]]
[[Category:Upgrade_system]]
[[Category:Package_preupgrade_test_cases]]
[[Category:Package_fedup_test_cases]]

Revision as of 00:31, 15 March 2013

Description

This test case tests upgrading from the current release (Fedora 39) to the branched release (Fedora 40) using the Fedup CLI with the default desktop package set.


How to test

  1. Perform an installation of the stable release (e.g. Fedora 39) with default partitioning (no less than 500MB for /boot), selecting the default package set, or using the default live image.
  2. Do a full system update and reboot
  3. Install the latest version of Package-x-generic-16.pngfedup 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/branched-20240328.n.0/40/(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 40)
    • 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. Typical desktop applications should display and work correctly