From Fedora Project Wiki

No edit summary
(polish the test case)
Line 1: Line 1:
{{admon/warning|Data loss possible|Don't test upgrades on your production machine. Make sure all your important data is backed up. Bugs can occur and destroy all your data.}}
{{QA/Test_Case
{{QA/Test_Case
|description=This test verifies how you can upgrade your Workstation Graphically from Fedora 23 to Fedora 24 with Gnome Software
|description=This test verifies how you can upgrade your Workstation graphically from Fedora 23 to Fedora 24 using GNOME Software
|setup=
|setup=
# Make sure you are running Fedora 23 Workstation with a decent internet connection and root access.
# Make sure you are running Fedora 23 Workstation with a decent internet connection.
# Enable COPR repo  run {{command|1=dnf copr enable rhughes/f23-gnome320}}
# Install all packages run {{command|1=dnf install PackageKit libhif libgusb libappstream-glib json-glib gnome-software fwupd f24-backgrounds appstream-data}}
# Reboot and look for ''fedora.json'' which you will find {{command|1=~/.cache/gnome-software/3.20/upgrades/fedora.json}}
# Once inside search for ''f24'' change the corresponding key pair value from ''Under Development'' to ''Active'' this will create a situation for gnome-software to prompt us for the updates.
|actions=
|actions=
{{admon/warning|Data loss|During upgrade you are advised to backup all your important data as the following process might delete your important files}}
<ol>
# fully update your machine and reboot
<li> Enable COPR repo with latest gnome-software: <pre>$ sudo dnf copr enable rhughes/f23-gnome320</pre>
# Reboot and look for ''fedora.json'' which you will find {{command|1=~/.cache/gnome-software/3.20/upgrades/fedora.json}}
<li> Fully update your system: <pre>$ sudo dnf update</pre>
# Once inside search for ''f24'' change the corresponding key pair value from ''Under Development'' to ''Active''
<li> Reboot
#*  After change the section should look like this
<li> Look for {{filename|~/.cache/gnome-software/3.20/upgrades/fedora.json}} file. If you don't see it, start GNOME Software a wait a bit, it should appear. If you still don't see it, try running: <pre>$ pkcon refresh force</pre> You should see it now.
  {
<li> Edit the file and search for <code>f24</code> string - you'll find a section related to Fedora 24. Change <code>status</code> key from <code>Under Development</code> value to <code>Active</code> value. This will convince GNOME Software that Fedora 24 is now a stable release and enable upgrade prompts. After the change, the section will look similarly to this (probably not exactly, at least the timestamps can be different):
      "allow_retire": true,
<pre>
      "branchname": "f24",
"allow_retire": true,
      "date_created": "2016-02-23 22:57:55",
"branchname": "f24",
      "date_updated": "2016-02-25 20:39:53",
"date_created": "2016-02-23 22:57:55",
      "dist_tag": ".fc24",
"date_updated": "2016-02-25 20:39:53",
      "koji_name": "f24",
"dist_tag": ".fc24",
      "name": "Fedora",
"koji_name": "f24",
      "status": "Active",
"name": "Fedora",
      "version": "24"
"status": "Active",
    }
"version": "24"
 
</pre>
<li> Shortly you should see a system notification announcing available system upgrade. If you don't see it, try rebooting the computer or logging out and in again.
<li> Click the banner, it should open up GNOME Software in the ''Updates'' tab, where you should see a larger banner informing about the upgrade.
<li> Click ''Learn more'' link to see release notes.
<li> Download the upgrade files. It should be happening in the background, you should be able to close GNOME Software or go to other tabs in GNOME Software without interrupting it.
<li> Wait for a notification that the download is complete.
<li> In the ''Updates'' tab in GNOME Software, confirm performing the upgrade.
<li> Wait until your computer reboots into "offline upgrade" mode, perform the upgrade, and automatically reboots back into newly upgraded system.
<li> Verify that the system is upgraded and basic functionality works correctly.
</ol>


|results=
|results=
# gnome-software should notify you when it discovers that a newer OS version is available.
# You should be notified that a newer Fedora release is available.
# You should see a banner about it in the updates page of gnome-software.
# You should see a banner about it in the ''Updates'' tab in gnome-software.
# The "Learn more" link should work (bring you to the release notes in a web browser).
# You should be able to display the release notes.
# Downloading the upgrade should happen in the background. You should be able to close gnome-software and go to other pages in gnome-software without interrupting it.
# Downloading the upgrade should happen in the background.
# When the download is complete, you should get a notification, and the updates page in gnome-software should now offer you to install the update
# You should see a notification when the download is complete.
The following must be true to consider this a successful test run.
# Installing the update should work just like an offline update, in the "offline upgrade" mode after reboot
# The above test cases should run successfully.
# There should be warnings if you had RPMs installed before the upgrade that would be broken by the upgrade (e.g. 3rd party software).
# Installing the update should work just like an offline update
# There should be warnings if you had rpms installed before the upgrade that would be broken by the upgrade (e.g. 3rd party software).
|optional=Optionally provide hints for exploratory testing.
}}
}}

Revision as of 07:49, 12 May 2016

Warning.png
Data loss possible
Don't test upgrades on your production machine. Make sure all your important data is backed up. Bugs can occur and destroy all your data.


Description

This test verifies how you can upgrade your Workstation graphically from Fedora 23 to Fedora 24 using GNOME Software

Setup

  1. Make sure you are running Fedora 23 Workstation with a decent internet connection.

How to test

  1. Enable COPR repo with latest gnome-software:
    $ sudo dnf copr enable rhughes/f23-gnome320
  2. Fully update your system:
    $ sudo dnf update
  3. Reboot
  4. Look for ~/.cache/gnome-software/3.20/upgrades/fedora.json file. If you don't see it, start GNOME Software a wait a bit, it should appear. If you still don't see it, try running:
    $ pkcon refresh force
    You should see it now.
  5. Edit the file and search for f24 string - you'll find a section related to Fedora 24. Change status key from Under Development value to Active value. This will convince GNOME Software that Fedora 24 is now a stable release and enable upgrade prompts. After the change, the section will look similarly to this (probably not exactly, at least the timestamps can be different):
    "allow_retire": true,
    "branchname": "f24",
    "date_created": "2016-02-23 22:57:55",
    "date_updated": "2016-02-25 20:39:53",
    "dist_tag": ".fc24",
    "koji_name": "f24",
    "name": "Fedora",
    "status": "Active",
    "version": "24"
    
  6. Shortly you should see a system notification announcing available system upgrade. If you don't see it, try rebooting the computer or logging out and in again.
  7. Click the banner, it should open up GNOME Software in the Updates tab, where you should see a larger banner informing about the upgrade.
  8. Click Learn more link to see release notes.
  9. Download the upgrade files. It should be happening in the background, you should be able to close GNOME Software or go to other tabs in GNOME Software without interrupting it.
  10. Wait for a notification that the download is complete.
  11. In the Updates tab in GNOME Software, confirm performing the upgrade.
  12. Wait until your computer reboots into "offline upgrade" mode, perform the upgrade, and automatically reboots back into newly upgraded system.
  13. Verify that the system is upgraded and basic functionality works correctly.

Expected Results

  1. You should be notified that a newer Fedora release is available.
  2. You should see a banner about it in the Updates tab in gnome-software.
  3. You should be able to display the release notes.
  4. Downloading the upgrade should happen in the background.
  5. You should see a notification when the download is complete.
  6. Installing the update should work just like an offline update, in the "offline upgrade" mode after reboot
  7. There should be warnings if you had RPMs installed before the upgrade that would be broken by the upgrade (e.g. 3rd party software).