(easier way to see the progress) |
(→Updating GRUB (UEFI systems): adding grub2 update instructions) |
||
Line 85: | Line 85: | ||
==== Updating GRUB (UEFI systems) ==== | ==== Updating GRUB (UEFI systems) ==== | ||
{{admon/ | {{admon/note|Secure Boot| Secure Boot functionality was not completed in time for Fedora 18 beta and these instructions do not cover using {{package|shim}} or the signed kernel. Once Secure Boot functionality is available, these instructions will be updated.}} | ||
* With the migration to grub2-efi in Fedora 18, you will see no grub splash after upgrade but grub should still work for now. | * With the migration to grub2-efi in Fedora 18, you will see no grub splash after upgrade but grub should still work for now. | ||
Grub2 is not installed as part of the upgrade process, so you'll have to install it: | |||
<pre> | |||
sudo yum install grub2-efi | |||
</pre> | |||
Once the {{package|grub2-efi}} package is installed, we need to add a new EFI boot entry. The easiest way to do this is to just modify the command used when Fedora was first installed. This command can be found in <nowiki>/var/log/anaconda/anaconda.program.log</nowiki> and should end with a command similar to: | |||
<pre> | |||
efibootmgr -c -w -L Fedora -d /dev/sdX -p Y -l \EFI\redhat\grub.efi | |||
</pre> | |||
{{admon/warning|Using Quotes|Make sure you put quotes around '\EFI\fedora\grubx64.efi' or bash will interpret \E, \f and \g as control characters and your system will not boot properly}} | |||
Once you have the command that was used, you can change it to use the new grub2-efi installation: | |||
<pre> | |||
sudo efibootmgr -c -w -L Fedora -d /dev/sdX -p Y -l '\EFI\fedora\grubx64.efi' | |||
</pre> | |||
=== Cleaning Up Post Upgrade === | === Cleaning Up Post Upgrade === | ||
Some of the stuff from [http://fedorasolved.org/Members/fenris02/post_upgrade_cleanup this post upgrade cleanup guide] might be wise | Some of the stuff from [http://fedorasolved.org/Members/fenris02/post_upgrade_cleanup this post upgrade cleanup guide] might be wise |
Revision as of 00:34, 29 November 2012
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.
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
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 (
) before reboot, search for or file a bug against fedup using the version you are upgrading from.
fedup
Issues During Upgrade
If you hit issues after upgrade preparation and the initial reboot, search for or file a bug against
using the version you are upgrading to.
fedup-dracut
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?
As elluded to above, there are three parts to upgrading with FedUp - preparation, execution and cleanup.
Preparing for the Upgrade
- Do a full system update and reboot to ensure that any kernel changes are running
- Install
fedup
- Be sure to get the latest release, this may involve enabling updates-testing (put
--enablerepo=updates-testing
betweenyum
andinstall
on the command line)
- Be sure to get the latest release, this may involve enabling updates-testing (put
- Find the URL of the branched TC or RC under test. For Fedora 18 beta, this URL would be http://dl.fedoraproject.org/pub/fedora/linux/releases/test/18-Beta/Fedora/<arch>/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 ...)
- 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
- Check the
fedupdebug.log
file if any errors show up in the output fromfedup-cli
Executing the Upgrade
- Reboot the system if
fedup-cli
has completed without error. - Once the system reboots, there should be a new entry in the GRUB menu titled
System Upgrade
. - Select the
System Upgrade
option from the GRUB menu- If you want to be able to see progress during the upgrade, append
plymouth.splash=fedup
to the end of the kernel parameters (line starting withlinux
)
- If you want to be able to see progress during the upgrade, append
- The system should boot into the upgrade process and a plymouth boot screen should be displayed
- Do not press any key, otherwise the progress screen will be killed and you will have no information about the process
- Once the upgrade process has completed, the system will reboot and an option to boot Fedora 41 will be on the grub menu
GRUB Updates
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)
- With the migration to grub2-efi in Fedora 18, you will see no grub splash after upgrade but grub should still work for now.
Grub2 is not installed as part of the upgrade process, so you'll have to install it:
sudo yum install grub2-efi
Once the
package is installed, we need to add a new EFI boot entry. The easiest way to do this is to just modify the command used when Fedora was first installed. This command can be found in /var/log/anaconda/anaconda.program.log and should end with a command similar to:
grub2-efi
efibootmgr -c -w -L Fedora -d /dev/sdX -p Y -l \EFI\redhat\grub.efi
Once you have the command that was used, you can change it to use the new grub2-efi installation:
sudo efibootmgr -c -w -L Fedora -d /dev/sdX -p Y -l '\EFI\fedora\grubx64.efi'
Cleaning Up Post Upgrade
Some of the stuff from this post upgrade cleanup guide might be wise