From Fedora Project Wiki

(add a note about N+2 upgrades)
(update per discussion on test list https://lists.fedoraproject.org/archives/list/test@lists.fedoraproject.org/thread/OKP2DFFKV2AH6PAZV4K5OMKZXVTXNQKD/)
Line 1: Line 1:
# Do a full system update and reboot
<noinclude>{{tempdoc}}</noinclude>
{{#ifexpr: {{{1|0}}} > 24 |# Run {{command|dconf-editor}} (''dconf Editor'' in the overview)
<ol>
# Navigate to {{code|/ org / gnome / software /}}
<li> Enable showing pre-release Fedora versions using this command:
# Click {{code|show-upgrade-prerelease}}, change ''Use default value'' to ''OFF'' and ''Custom value'' to ''True''|# Run {{command|gnome-software}} (''Software'' in the overview)
<pre>gsettings set org.gnome.software show-upgrade-prerelease true</pre>
# Wait a minute or two
<li> Reboot the system or log out and in again, then wait for a few minutes.
# Run {{command|gedit ~/.cache/gnome-software/$(rpm -q --queryformat '%{VERSION}\n' gnome-software <nowiki>|</nowiki> cut -d '.' -f-2)/upgrades/fedora.json}}; this should open an existing file in gedit (''Text Editor'')
<li> A notification of an available upgrade should appear. If it does, click it. If not, note this as a bug, but run {{command|gnome-software}} (''Software'' in the overview), click the ''Updates'' button, and click the refresh button at top-left.
#: You can change {{code|gedit}} to another text editor if you like
<li> Check that there is a banner informing you about the new release, with ''Learn More'' and ''Download'' buttons.
# Find the line containing {{code|"version": "{{FedoraVersionNumber|next}}"}} (or the release number you want to upgrade to, if it's not {{FedoraVersionNumber|next}})
* If you're trying to perform an N+2 upgrade (i.e. going from {{FedoraVersion|long|previous}} to {{FedoraVersion|long|next}}), the banner should be informing about the N+2 release ({{FedoraVersion|long|next}}), not N+1 ({{FedoraVersion|long|current}}). The same applies to the displayed documentation ("Learn More") and downloaded updates, all of that should be related to N+2 release.
# The line above it will probably say {{code|"status": "Under Development",}}. Change {{code|"Under Development"}} to {{code|"Active"}}. If it already says {{code|"status": "Active",}}, just leave it alone}}
<li> Click ''Learn More'', it should load an appropriate document or URL.
#* If you want to perform an N+2 upgrade (for example from F{{FedoraVersionNumber|previous}} to F{{FedoraVersionNumber|next}}), you also need to find the intermediate release (e.g. F{{FedoraVersionNumber|current}}) and change its status from {{code|"Active"}} to {{code|"Under Development"}}.
* If it links to an appropriate URL but there is no content for the URL yet, this may be reported to the [[Docs_Project|documentation team]], but is not a failure of this test.
# Reboot the system or log out and in again, then wait for a few minutes
<li> Click ''Download''. A progress bar should be displayed while the upgrade download takes place.
# A notification of an available upgrade should appear. If it does, click it. If not, note this as a bug, but run {{command|gnome-software}} (''Software'' in the overview), click the ''Updates'' button, and click the refresh button at top-left
<li> Once the download process completes, click the ''Install'' button that should appear.
# Check that there is a banner informing you about the new release, with ''Learn More'' and ''Download'' buttons
* If a dialog asking for administrator authentication appears, complete it.
# Click ''Learn More'' and note the result
<li> Click the ''Restart & Install'' button that should appear next. The system should reboot immediately.
# Click ''Download''
<li> Once the system reboots, the system should boot into the upgrade environment and a graphical progress screen should be displayed.
# Once the download process completes, click the ''Install'' button that should appear
<li> Once the upgrade process has completed, the system should reboot and an option to boot the new release should be on the grub menu.
# If a dialog asking for administrator authentication appears, complete it
<li> Log in to the upgraded system and test basic system applications (a terminal, file browser, or other, depending on the system flavor).
# Click the ''Restart & Install'' button that should appear next
</ol>
{{generic_upgrade_procedure}}

Revision as of 12:21, 12 June 2017

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.
  1. Enable showing pre-release Fedora versions using this command: 
    gsettings set org.gnome.software show-upgrade-prerelease true
  2. Reboot the system or log out and in again, then wait for a few minutes.
  3. 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.
  4. 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.
  5. 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.
  6. Click Download. A progress bar should be displayed while the upgrade download takes place.
  7. Once the download process completes, click the Install button that should appear.
    • If a dialog asking for administrator authentication appears, complete it.
  8. Click the Restart & Install button that should appear next. The system should reboot immediately.
  9. Once the system reboots, the system should boot into the upgrade environment and a graphical progress screen should be displayed.
  10. Once the upgrade process has completed, the system should reboot and an option to boot the new release should be on the grub menu.
  11. 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=494648"