Before beginning, we HIGHLY recommend that you follow system administration best practices and make sure you have backups and/or snapshots of your system before you proceed. It is recommended to do a trial run in a sandbox to verify that migration worked as expected before you attempt to migrate any production system. Please report any issues encountered to the AlmaLinux Bug Tracker and/or AlmaLinux Chat Migration Channel
The ELevate project only supports official operating systems repositories. It doesn’t support external repositories like EPEL. Please, check the ELevate Frequent Issues page for known and frequent issues.
This guide contains steps on how to upgrade your RHEL-based operating system to the next major version.
Currently, the following migration directions are available:
* - migration to CentOS Stream 9 is currently in process and will be available later.
** - migration to Oracle Linux 9 is available with the Oracle Leapp utility and will not be supported by ELevate project.
You need CentOS 7, AlmaLinux 8, EuroLinux 8 or Rocky Linux 8 system installed to use this guide.
elevate-release
package with the project repo and GPG key.Preupgrade check will fail as the default install doesn't meet all requirements for migration.
This summary report will help you get a picture of whether it is possible to continue the upgrade.
:::tip
In certain configurations, Leapp generates /var/log/leapp/answerfile with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
:::
Check the ELevate Frequent Issues page for known and frequent issues and guidance steps to solve them.
A new entry in GRUB called ELevate-Upgrade-Initramfs
will appear. The system will be automatically booted into it.
See how the update process goes in the console.
After reboot, login to the system and check how the migration went. Verify that the current OS is the one you need. Check logs and packages left from previous OS version, consider removing them or update manually.
As the Leapp tool is designed to perform one-step migrations, to migrate your CentOS 7.x machine to AlmaLinux 9.x you need to split the migration process from CentOS 7.x to AlmaLinux 8.x and AlmaLinux 8.x to AlmaLinux 9.x.
When successfully migrated to AlmaLinux 8.x OS, consider performing these steps to prepare your system for migration to AlmaLinux 9.x:
Navigate to the /etc/ directory and use an editor of your choice to edit the yum.conf file. You need to remove everything from the exclude line especially that refers to elevate or leapp.
Then navigate to the /etc/dnf/ directory and use an editor of your choice to do the same in the dnf.conf file.
Now you can remove/manually upgrade packages left from CentOS 7.x without any conflicts.
Check packages left from CentOS 7:
An example output with a list of packages:
As mentioned above, consider removing these packages or upgrading them manually to proceed with migration to AlmaLinux 9.x.
If you face difficulties while removing the packages, the following command might help you:
You can also check for the packages left from the migration process and remove them:
Check whether you have the /root/tmp_leapp_py3 directory created and if so delete it.
Clean up your machine.
You may also have to remove old RSA/SHA1 GPG keys. List the keys:
To remove them, use use the rpm -e
command:
After these preparations are completed, you can follow steps from the ELevate Quickstart Guide to migrate your AlmaLinux.x machine to AlmaLinux 9.x.
After the leapp preupgrade step fails, check the logs and apply the fixes. The most popular fixes for RHEL8-based operating systems:
You might also find the following issue in the leapp-report file that can interfere with the migration. Consider removing the file:
You might want to remove the make-devel package as it conflicts when running leapp upgrade
and thus this step fails.
After successful migration to AlmaLinux 9.x don't forget to verify you got the system you needed and if there are left-over packages you might want to remove:
Check Demo of a CentOS 7.x to AlmaLinux 8.x migration using the software and data provided by the AlmaLinux ELevate Project.