From Fedora Project Wiki

(--debug is not needed, log is automatically created with it)
(revise and simplify to ensure we cover the correct case, for the modern day: stable fedup with upgrade.img from current TC/RC)
Line 1: Line 1:
# Do a full system update and reboot
# Do a full system update and reboot
# Install {{package|fedup}}. It is usually a good idea to install the very latest version from ''updates-testing'': {{command|su -c 'yum --enablerepo<nowiki>=</nowiki>updates-testing install fedup'}}
# Install the latest version of {{package|fedup}} from the stable or updates repository
# Find the URL of the development branch for {{FedoraVersion|long|next}}. This URL should be of the form <nowiki>http://dl.fedoraproject.org/pub/fedora/linux/development/<version>/<arch>/os/</nowiki>
# Find the repository URL for the TC or RC you are testing. This should be of the form <nowiki>https://dl.fedoraproject.org/pub/alt/stage/<milestone>/Fedora/<arch>/os/</nowiki>
#* <version> is the of fedora under test (currently {{FedoraVersion||next}})
#* <milestone> is the TC/RC you are testing - e.g. 20-RC1
#* <arch> is the name of the arch running on the install to be upgraded (i386, x86_64 ...)
#* <arch> is the name of the arch running on the install to be upgraded (i386, x86_64 ...)
#* Due to the way that branched composes are done, the fedup client is not capable of grabbing initrd and kernel from those branches. The devel branch will rebuild from whatever is in stable for every push to the devel stable branch.
# Start the upgrade prep by executing following command
# Start the upgrade prep by executing following command
#* {{command|su -c 'fedup-cli --network <version> --instrepo <URL>'}}
#* {{command|su -c 'fedup --network <version> --instrepo <URL>'}}
#* <version> is the version of Fedora you are upgrading to (currently {{FedoraVersion||next}})
#* <version> is the version of Fedora you are upgrading to (currently {{FedoraVersion||next}})
#* <URL> is the location found in the previous step
#* <URL> is the location found in the previous step
# If you need to use a local mirror to test a brand new change, start the upgrade prep by executing following command:
# If you need to use a local mirror to test a brand new change, start the upgrade prep by executing the following command:
#* {{command|1=su -c 'fedup-cli --network <version> --instrepo <URL> --disablerepo=fedora --repourl fedora-local=<URL-LOCAL>'}}
#* {{command|1=su -c '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
#* <URL-LOCAL> is the location of a local fedora repo if needed for faster response speeds
# Check {{filename|/var/log/fedup.log}} file to see if any errors show up in the output from {{command|fedup-cli}}
# Check {{filename|/var/log/fedup.log}} file to see if any errors show up in the output from {{command|fedup}}
# Reboot the system if {{command|fedup-cli}} has completed without error
# Reboot the system if {{command|fedup}} has completed without error
# Once the system reboots, there should be a new entry in the GRUB menu titled {{command|System Upgrade}}
# 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
# Select the {{command|System Upgrade}} option from the GRUB menu
# The system should boot into the upgrade process and a fedup progress screen should be displayed
# The system should boot into the upgrade process and a fedup progress screen should be displayed
#* Press the <ESC> key, will switch from the graphical progress screen to the textual progress information display
#* Pressing the <ESC> key should switch from the graphical progress screen to the text progress information display
#** Returning to the graphical progress screen by pressing the <ESC> key will return you to a screen where the progress bar is "frozen" {{bz|873144}} and {{bz|883075}}, exist for this and other previous display issues related to fedup. Remove this comment once the bugs are confirmed fixed
# Once the upgrade process has completed, the system will reboot and an option to boot {{FedoraVersion|long|next}} will be on the grub menu
# 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.
# Log in to upgraded system, open a terminal, file browser, or other system applications.

Revision as of 21:05, 18 December 2013

  1. Do a full system update and reboot
  2. Install the latest version of fedup from the stable or updates repository
  3. Find the repository URL for the TC or RC you are testing. This should be of the form https://dl.fedoraproject.org/pub/alt/stage/<milestone>/Fedora/<arch>/os/
    • <milestone> is the TC/RC you are testing - e.g. 20-RC1
    • <arch> is the name of the arch running on the install to be upgraded (i386, x86_64 ...)
  4. Start the upgrade prep by executing following command
    • su -c 'fedup --network <version> --instrepo <URL>'
    • <version> is the version of Fedora you are upgrading to (currently 42)
    • <URL> is the location found in the previous step
  5. If you need to use a local mirror to test a brand new change, start the upgrade prep by executing the following command:
    • su -c '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
  6. Check /var/log/fedup.log file to see if any errors show up in the output from fedup
  7. Reboot the system if fedup has completed without error
  8. Once the system reboots, there should be a new entry in the GRUB menu titled System Upgrade
  9. Select the System Upgrade option from the GRUB menu
  10. The system should boot into the upgrade process and a fedup progress screen should be displayed
    • Pressing the <ESC> key should switch from the graphical progress screen to the text progress information display
  11. Once the upgrade process has completed, the system will reboot and an option to boot Fedora 42 will be on the grub menu
  12. Log in to upgraded system, open a terminal, file browser, or other system applications.
Retrieved from "https://fedoraproject.org/w/index.php?title=Template:Fedup_upgrade_procedure&oldid=365163"