Upgrading Korora to 28

This document is still in development and should only be used for upgrading from Korora systems already upgraded to 27. It uses the community provided repos. While it should work reliably, however you still do so at your own risk (like any upgrade). If this fails, then you will need to perform a re-install so please make sure you've backed up important data.

Table of Contents

Korora uses Fedora's tools, so upgrading is easy! Here we'll will show you how to upgrade from one release to a new one.

This should work reliably, however you still do so at your own risk (like any upgrade). If this fails, then you will need to perform a re-install so please make sure you've backed up important data.

Contact us on Engage if you have any problems!

As Korora 28 is in development mode by the community any upgraded system should be considered a development system. This is for upgrading from the unofficial Korora 27 upgraded systems.

Upgrading to the latest release

The upgrade is performed with the help of a plugin to the system's package manager, dnf (previously there was a dedicated tool called FedUp).

When run, dnf will:

  • Download all the rpms required to upgrade your packages
  • Reboot your machine and install them
  • Boot into your upgraded system

You can also review the manpage by typing the command - man dnf.plugin.system-upgrade

First, make sure you are running the latest packages for your current version.

sudo dnf --refresh upgrade

Install the dnf system upgrade plugin, in case it's missing (it might already be installed).

sudo dnf install python3-dnf-plugin-system-upgrade

As the Korora 28 packages aren't hosted on the Korora website (yet!) the repo file needs to be updated to find the packages. Update the Korora repo file by changing the line that gives the repo url. This will usually be the line beginning with 'mirrorlist' but it may be the 'baseurl' line. It is recommended that the existing line be commentted out and a new line added immediately after it. Also as the Korora 28 packages aren't signed you need to disable the gpgcheck.

Open /etc/yum.repos.d/korora.repo in your preferred editor. You will need to open it as root or use sudo. Look for the baseurl line in the Korora section (it should be the third line in the file). If it is already commented out then the next line starting with 'mirrorlist' should be commented out. Disable it by placing a hash sign at the beginning of the line. Add a new line with the contents

baseurl=http://unitylinux.com/pub/korora/releases/28/x86_64/

Now change the line starting with 'gpgcheck=' from 1 to 0. Save and exit the editor.

Run the dnf system upgrade command (this will take a while to download all the updates, but you can continue using your machine in the meantime).

sudo dnf --refresh system-upgrade download --releasever=28

If you have an issue and need to restart the system-upgrade remove the '--refresh' option from the command to use packages already downloaded.

You'll be asked to accept and verify the signing keys. Enter `Y` for each key.

Next, tell your system to reboot and perform the upgrade.

sudo dnf system-upgrade reboot

There may be no display during this part of the process, however the system will install the upgrades and then reboot.

Finally, your system should reboot into the freshly upgraded system.

You're now ready to enjoy your upgraded system.

Optional: Upgrade the Rescue Kernel

This should be left until the upgraded system is tested and works reliably.

The rescue kernel option on the Grub boot menu isn't updated during the upgrade process. To force it to be upgraded to the new version it is necessary to rebuild the Grub configuration. To do this run
sudo grub2-mkconfig -o /boot/grub2/grub.cfg

or for EFI systems  sudo grub2-mkconfig -o /boot/efi/EFI/fedora/grub.cfg