From Fedora Project Wiki

(clean up some fedup leftovers)
(update per discussion on test list https://lists.fedoraproject.org/archives/list/test@lists.fedoraproject.org/thread/OKP2DFFKV2AH6PAZV4K5OMKZXVTXNQKD/)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
# Do a full system update and reboot
<noinclude>{{tempdoc}}</noinclude>
# Install the latest version of {{package|dnf-plugin-system-upgrade}} from the stable or updates repository
<ol>
# Start the upgrade prep by executing:
<li> Install the latest stable version of {{package|dnf-plugin-system-upgrade}} package:
#* {{command|1=sudo dnf system-upgrade download --releasever=<version>}}
<pre>sudo dnf install --best --refresh dnf-plugin-system-upgrade</pre>
#* {{code|<version>}} is the version of Fedora you are upgrading to (currently {{FedoraVersion||next}})
<li> Download the updates:
# If you need to use a local mirror to test a brand new change, you can enable it as normal, e.g.:
{{#tag:pre|sudo dnf system-upgrade download --refresh --releasever={{FedoraVersionNumber|next}}}}
#* {{command|1=sudo dnf system-upgrade download --releasever=<version> --enablerepo=<name>}}
<ul>
# To aid debugging, run this command to enable a root shell on VT9 during the upgrade boot:
  <li> You can change <code>{{FedoraVersionNumber|next}}</code> to test upgrading to a different Fedora release, of course.
#* {{command|sudo systemctl add-wants system-update.target debug-shell.service}}
  <li> If you need to use a local mirror to test a brand new change, you can enable it as normal, i.e. by adding {{command|1=--enablerepo=<name>}} option to the command line.
# If {{command|dnf system-upgrade download}} has completed without error, run:
</ul>
#* {{command|sudo dnf system-upgrade reboot}}
<li> To aid debugging, run this command to enable a root shell on VT9 during the upgrade boot:
# Once the system reboots, the system should boot into the upgrade process and a fedup progress screen should be displayed
<pre>sudo systemctl add-wants system-update.target debug-shell.service</pre>
#* Pressing {{key_press|Esc}} should switch from the graphical progress screen to the text progress information display
If anything goes wrong during upgrade, you can live switch to VT9 and inspect current system state, logs, etc.
# 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> If downloading has completed without error, run:
# Log in to the upgraded system, open a terminal, file browser, or other system applications
<pre>sudo dnf system-upgrade reboot</pre>
<li> Once the system reboots, the system should boot into the upgrade process and a graphical progress screen should be displayed
* Pressing {{key_press|Esc}} should switch from the graphical progress screen to the text progress information display
<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 12:18, 12 June 2017

Template documentation [edit]

This documentation is transcluded from Template:Dnf 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. Install the latest stable version of dnf-plugin-system-upgrade package: 
    sudo dnf install --best --refresh dnf-plugin-system-upgrade
  2. Download the updates: 
    sudo dnf system-upgrade download --refresh --releasever=42
    • You can change 42 to test upgrading to a different Fedora release, of course.
    • If you need to use a local mirror to test a brand new change, you can enable it as normal, i.e. by adding --enablerepo=<name> option to the command line.
  3. To aid debugging, run this command to enable a root shell on VT9 during the upgrade boot: 
    sudo systemctl add-wants system-update.target debug-shell.service

    If anything goes wrong during upgrade, you can live switch to VT9 and inspect current system state, logs, etc.

  4. If downloading has completed without error, run: 
    sudo dnf system-upgrade reboot
  5. Once the system reboots, the system should boot into the upgrade process and a graphical progress screen should be displayed
    • Pressing Esc should switch from the graphical progress screen to the text progress information display
  6. Once the upgrade process has completed, the system should reboot and an option to boot the new release should be on the grub menu
  7. 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:Dnf_upgrade_procedure&oldid=494645"