- 1 What is FedUp?
- 2 What Does FedUp do?
- 3 Frequently Asked Questions
- 3.1 Can I upgrade a Fedora 16 system with FedUp?
- 3.2 How do I report issues that I find with upgrades?
- 3.3 How do I Debug Issues During Upgrade
- 3.4 Does FedUp verify the software it runs or installs during upgrade?
- 3.5 Where can I ask Questions
- 4 How Can I Upgrade My System with FedUp?
- 5 Docs TODO
What is FedUp?
FedUp (FEDora UPgrader) is the name of a new system for upgrading Fedora installs in Fedora 18 and above releases. It replaces all of the currently recommended upgrade methods (PreUpgrade and DVD) that have been used in previous Fedora releases. Anaconda, the Fedora installer does have not any in-built upgrade functionality in Fedora 18 or above releases. It has been completely delegated to Fedup.
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.
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 the fedup command-line interface is implemented but a GUI interface is expected 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. If you are upgrading from Fedora 16, use Preupgrade to upgrade to Fedora 17 first.
How do I report issues that I find with upgrades?
First see Common F18 bugs#Upgrade_issues whether the problem is not one of a very prominent issue we already know of. If it is not there, the component for reporting problems depends on the exact issue that you hit:
Issues with upgrade preparation
If you hit issues when using the FedUp client (
) before reboot, search 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 or file a bug against
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.
Does FedUp verify the software it runs or installs during upgrade?
This is a planned feature. See Bug 877623 for a status update.
Where can I ask Questions
For now, the best place to ask questions is probably test mailing list.on Freenode IRC or the
How Can I Upgrade My System with FedUp?
As alluded to above, there are three parts to upgrading with FedUp - preparation, execution and cleanup.
Before you start doing anything, be sure to have a look at Common F18 bugs#Upgrade_issues and read about the most common bugs found.
Preparing for the Upgrade
- Do a full system update running
su -c "yum clean all | yum upgrade"on Terminal and reboot to ensure that any kernel changes are running.
- After reboot, open the Terminal and run
su -c "yum install fedup"to install the latest version of FedUp.
This will install FedUp on your system and get your Fedora 17 ready for upgrade.
Executing the Upgrade
- Open Terminal and run
su -c "fedup-cli --network 18 --debuglog fedupdebug.log"".
- Reboot your system.
- Once you Reboot, you'll see the option 'System Upgrade' on the GRUB prompt. Just press Enter.
- The system will boot into a special environment to perform the upgrade. The screen will show a graphical progress screen during upgrade.
Updating GRUB2 (BIOS systems)
- After upgrade, the grub2 you're booting from will still be the F17 version; upgrading must be done manually
- Follow the steps in this grub2 page to reinstall and update grub
Updating GRUB (UEFI systems)
Cleaning Up Post Upgrade
- Write fedup troubleshooting and debug guide
- add details for secureboot/shim installation
- write commonbugs entries and link to them from this page
- add note about blob drivers if needed
- add notes about how to use other repos or link to discussion/instructions