Product SiteDocumentation Site

19.2. Upgrading Your System

Note

fedup replaces both the preupgrade tool and the facility to upgrade using the installer. Anaconda no longer detects and upgrades existing Fedora installations.
In most cases, the simplest way to upgrade an existing Fedora installation is with the fedup tool. When a new version of Fedora is available, fedup downloads the packages necessary to upgrade your installation, and initiates the upgrade process.
  1. Install fedup with your graphical package manager, or type yum install fedup at the command line and press Enter.
  2. The command to run fedup will depend on where you choose to source packages from. Run one of the following commands as root and press Enter:
    • To upgrade using a network source:
      sudo fedup --network 18 --debuglog fedupdebug.log
    • To upgrade using a Fedora 18 ISO file you have downloaded:
      sudo fedup --iso /path/to/isofile.iso --debuglog=fedupdebug.log 
    • To upgrade using a mounted storage device such as optical or USB media:
      sudo fedup --device /path/to/mountpoint --debuglog=fedupdebug.log 
    If the system you are updating has network access, the latest updates will also be installed regardless of which package source you specify.
  3. If fedup runs successfully without errors, reboot your system.
  4. In the GRUB menu at startup, select the new entry: System Upgrade.
  5. fedup will now upgrade your system. It will again reboot the system on completion, and an option to boot Fedora 18 will then be present in the GRUB menu.
Once Fedora has been upgraded, update the GRUB bootloader. This is not mandatory, but is recommended for BIOS systems and strongly recommended for EFI systems.
On a BIOS system, run the following commands, where disk is the device or partition you want to boot from:
grub2-install disk
grub2-mkconfig -o /boot/grub2/grub.cfg
ln -sf /boot/grub2/grub.cfg /etc/grub2.cfg
To update GRUB on EFI systems, GRUB2 must be installed (GRUB Legacy is no longer used on EFI systems beginning with Fedora 18), which makes this update particularly important. Follow this procedure to install GRUB2:
  1. Install GRUB2 for EFI by running the following command:
    sudo yum install grub2-efi
  2. After the package has been installed, you will need to add a new EFI boot entry. You can base it on the command used when Fedora was first installed, which can be found in /var/log/anaconda/anaconda.program.log and should end with a command similar to:
    efibootmgr -c -w -L Fedora -d /dev/sdX -p Y -l \EFI\redhat\grub.efi
    Make a note of this command.
  3. Find the current boot number for Fedora using efibootmgr:
    efibootmgr -v
    In the output, look for a line similar to the following:
    Boot0012* Fedora  HD(1,800,34800,6733749f-b42a-4b8c-a0de-5a1d3505f8af)File(\EFI\fedora\grubx64.efi)
    In this example, the boot number is 0012.
  4. Remove the old boot entry with the following command:
    efibootmgr -b bootnumber -B
  5. You can now create a new boot entry for grub2-efi. The command is run as root or sudo and is a modification of the command generated in step 2 appended with the boot number. The path to the .efi file is edited to reflect GRUB2 and must be in quotation marks or the system will not boot:
    sudo efibootmgr -c -w -L Fedora -d /dev/sdX -p Y -l '\EFI\fedora\grubx64.efi' -b bootnumber
  6. Finally, refresh the grub.cfg file and establish a symlink to /etc/grub2-efi.cfg:
    grub2-mkconfig -o /boot/efi/EFI/fedora/grub.cfg
    After the next reboot, your system will be using grub2-efi.

fedup can only upgrade from Fedora 17

Currently, fedup can only upgrade to Fedora 18 from Fedora 17. If you are upgrading from an earlier version than Fedora 17, you will first need to upgrade to Fedora 17 using preupgrade or the Fedora 17 installer and then use fedup to upgrade to Fedora 18.
Upgrading to each version incrementally is otherwise unnecessary. For example, you can upgrade from Fedora 14 to Fedora 17 directly.

Note

If the contents of your /etc/fedora-release file have been changed from the default, your Fedora installation may not be found when attempting an upgrade to Fedora 18.
You can relax some of the checks against this file by booting with the following boot command:
linux upgradeany
Use the linux upgradeany command if your Fedora installation was not given as an option to upgrade.