From Fedora Project Wiki

(create template for GNOME Software upgrade procedure (conditionalized on release version, as we can give nicer instructions for upgrades from >F24))
 
(make it clearer that some instructions are just for rawhide)
 
(5 intermediate revisions by 3 users not shown)
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)
 
# Navigate to {{code|/ org / gnome / software /}}
{{ Template:Admon/tip | Upgrade to Rawhide instructions |
# Click {{code|show-upgrade-prerelease}}, change ''Use default value'' to ''OFF'' and ''Custom value'' to ''True''|# Run {{command|gnome-software}} (''Software'' in the overview)
Skip this box when upgrading to Fedora [[Branched]].
# Wait a minute or two
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:
# 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'')
<ol>
#: You can change {{code|gedit}} to another text editor if you like
<li>Navigate to <code>~/.cache/gnome-software/fedora-pkgdb-collections</code>
# Find the line containing {{code|"version": "{{FedoraVersionNumber|next}}"}} (or the release number you want to upgrade to, if it's not {{FedoraVersionNumber|next}})
<li>Run:
# 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}}
<div>
# Reboot the system or log out and in again, then wait for a few minutes
jq '(.collections {{!}}{{=}} map(if .version {{=}}{{=}} "devel" then .koji_name {{=}} "f{{FedoraVersionNumber|next}}" {{!}} .status {{=}} "Active" {{!}} .version {{=}} "{{FedoraVersionNumber|next}}" else . end))' fedora.json > fedora_updated.json
# 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
</div>
# Check that there is a banner informing you about the new release, with ''Learn More'' and ''Download'' buttons
 
# Click ''Learn More'' and check it does something appropriate (it may link to a page that has not yet been written; this is probably OK if the URL looks sensible)
<li>Replace the original file with the updated version: <pre>mv fedora_updated.json fedora.json</pre>
# Click ''Download''
</ol>
# Once the download process completes, click the ''Install'' button that should appear
}}
# If a dialog asking for administrator authentication appears, complete it
 
# Click the ''Restart & Install'' button that should appear next
 
{{generic_upgrade_procedure}}
<ol>
<li> Enable showing pre-release Fedora versions using this command:
<pre>gsettings set org.gnome.software show-upgrade-prerelease true</pre>
<li> Reset gnome-software's counter for showing notifications:
<pre>TIMESTAMP=$(date '+%s' --date='08:00 8 days ago')
gsettings set org.gnome.software upgrade-notification-timestamp $TIMESTAMP</pre>
<li> Reboot the system or log out and in again, then wait for a few minutes.
<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.
<li> 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 {{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.
<li> 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 [[Docs_Project|documentation team]], but is not a failure of this test.
<li> Click ''Download''. A progress bar should be displayed while the upgrade download takes place.
<li> Once the download process completes, click the ''Install'' button that should appear.
* If a dialog asking for administrator authentication appears, complete it.
<li> Click the ''Restart & Install'' button that should appear next. The system should reboot immediately.
<li> Once the system reboots, the system should boot into the upgrade environment and a graphical progress screen should be displayed.
<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.
<li> Log in to the upgraded system and test basic system applications (a terminal, file browser, or other, depending on the system flavor).
</ol>

Latest revision as of 08:58, 19 March 2024

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.
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 = "f42" | .status = "Active" | .version = "42" 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 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.
  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).
Retrieved from "https://fedoraproject.org/w/index.php?title=Template:Gnome_software_upgrade_procedure&oldid=704697"