From Fedora Project Wiki

Revision as of 14:59, 27 November 2012 by Tflink (talk | contribs) (Preparing for the Upgrade: changing URL for beta instead of pre-release)

New Software and Documentation
FedUp is new for Fedora 18 and as such, will be changing before Fedora 18 is released. If you find this documentation to be wrong or out of date, please fix it or let someone know
Stop (medium size).png
Draft Page
This page is still a draft and is being actively edited, it should be mostly complete but will likely change some in the next day or so

What is FedUp?

FedUp (FEDora UPgrader) is the name of a new system for upgrading Fedora installs starting with Fedora 18. It will be replacing all of the currently recommended upgrade methods (PreUpgrade and DVD) that have been used in previous Fedora releases.

Currently, FedUp is capable of upgrading Fedora 17 installs to Fedora 18 using a networked repository, similar to how PreUpgrade worked. More methods for upgrade are currently planned and this page will be updated as those features are completed.

Fedora 16 and Older
The FedUp client does not build or run on anything older than Fedora 17. If you want to upgrade an older Fedora installation, please upgrade to Fedora 17 before continuing

What Does FedUp do?

The FedUp system consistes of two parts - the client used to download packages and prepare for the upgrade and a pre-boot environment which does the actual upgrade using systemd and yum. More details are available in a blog post written by FedUp's primary author

The FedUp Client

The FedUp client runs on the system to be upgraded. It gathers the packages needed for upgrade in addition to downloading the required initramfs and kernel needed for the actual upgrade. At this time, only fedup-cli is implemented but a GUI interface is expected before Fedora 18 is released.

The Upgrade

Plymouth Theme During Upgrade
Unfortnately, the FedUp plymouth theme is not used when upgrading with the initramfs distributed with Fedora 18 beta. This is a known issue and will be fixed before Fedora 18 is released

The actual upgrade takes place when the system has been rebooted after running the FedUp client. The filesystems are mounted during boot, the already downloaded packages are installed and some upgrade-related tasks are performed. During the upgrade process, a special plymouth theme is used which has a progress bar to indicate current upgrade progress.

Frequently Asked Questions

Can I upgrade a Fedora 16 system with FedUp?

No, this is not currently possible. The FedUp client does not currently build or run on Fedora 16 and you need to be running at least Fedora 17 in order to run the client?

How do I report issues that I find with upgrades?

The answer to this depends on the exact issue that you hit.

Issues with upgrade preparation

If you hit issues when using the FedUp client (Package-x-generic-16.pngfedup) before reboot, search for or file a bug against fedup using the version you are upgrading from.

Issues During Upgrade

If you hit issues after upgrade preparation and the initial reboot, search for or file a bug against Package-x-generic-16.pngfedup-dracut using the version you are upgrading to.

Issues After Upgrade

If you hit issues after upgrade with a specific package, file a bug against the package with which you are having issues.

How do I Debug Issues During Upgrade

A troubleshooting and debug guide will be written soon and linked to from here.

Where can I ask Questions

For now, the best place to ask questions is probably #fedora-qa on Freenode IRC or the Fedora Test list.

How Can I Upgrade My System with FedUp?

Upgrading to Pre-Release
These instructions are currently written for upgrading to Fedora 18 beta. If you want to try upgrading to the final pre-release, check out the upgrade test case. However, there may be bugs in the newer process if you use it before the release of Fedora 18 - if you try it, be aware that you may run into problems

As elluded to above, there are three parts to upgrading with FedUp - preparation, execution and cleanup.

Preparing for the Upgrade

Latest fedup
Make sure that you install the latest version of the fedup client on the system to be upgraded. At the time of this writing (2012-11-26), that is fedup-0.7.1-1.fc17
  1. Do a full system update and reboot to ensure that any kernel changes are running
  2. Install Package-x-generic-16.pngfedup
    • Be sure to get the latest release, this may involve enabling updates-testing (put --enablerepo=updates-testing between yum and install on the command line)
  3. Find the URL of the branched TC or RC under test. For Fedora 18 beta, this URL would be>/os. You can also substitute the root of a local mirror instead of using the main download site.
    • <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
    • sudo fedup-cli --network 18 --debuglog fedupdebug.log --instrepo <URL>
    • <URL> is the location found in the previous step
  5. Check the fedupdebug.log file if any errors show up in the output from fedup-cli

Executing the Upgrade

Monitoring Upgrade Progress
At this time, there is no way to monitor FedUp progress during the actual upgrade unless the debug shell is enabled after preparation but before starting the actual upgrade
  1. Reboot the system if fedup-cli has completed without error.
  2. Once the system reboots, there should be a new entry in the GRUB menu titled System Upgrade.
  3. Select the System Upgrade option from the GRUB menu
    • If you want to be able to see progress during the upgrade, append rd.upgrade.debugshell to the end of the kernel parameters
  4. The system should boot into the upgrade process and a plymouth boot screen should be displayed
    • There may not be any output behind the plymouth splash, this doesn't mean that the upgrade stopped
    • If you enabled the debug shell, it will be available on VT2. You will need to wait until the upgrade process has completely started and type exit in order to access the upgrade environment.
    • Upgrade progress can be seen by using journalctl -a -o cat and scrolling to the bottom (Shift+G will get you to the bottom if you don't want to scroll the whole way).
  5. Once the upgrade process has completed, the system will reboot and an option to boot Fedora 29 will be on the grub menu

Cleaning Up Post Upgrade

Some cleanup and/or manual upgrades may be required

Updating GRUB

  • This should point to docs on what to do with the grub-efi to grub2-efi migration in F18
  • This needs to at least point to docs on how to upgrade GRUB by hand

Other cleanup

Some of the stuff from this post upgrade cleanup guide might be wise