Chapter 4. Performing the upgrade from RHEL 7 to RHEL 8
Upgrade to RHEL 8 using the
On your RHEL 7 system, start the upgrade process:
# leapp upgradeNote
If you are going to use custom repositories from the
/etc/yum.repos.d/directory for the upgrade, enable the selected repositories as follows:
# leapp upgrade --enablerepo repository_id1 --enablerepo repository_id2 ...
If you are going to upgrade without RHSM or using RHUI, add the
At the beginning of the upgrade process,
Leappperforms the pre-upgrade phase described in Reviewing the pre-upgrade report
If the system is upgradable,
Leappdownloads necessary data and prepares an RPM transaction for the upgrade.
If your system does not meet the parameters for a reliable upgrade,
Leappterminates the upgrade process and provides a record describing the issue and a recommended solution in the
/var/log/leapp/leapp-report.txtfile. For more information, see Troubleshooting.
Manually reboot the system:
In this phase, the system boots into a RHEL 8-based initial RAM disk image, initramfs.
Leappupgrades all packages and automatically reboots to the RHEL 8 system.
Alternatively, you can run the
leapp upgradecommand with the
--rebootoption and skip this manual step.
If a failure occurs, investigate logs as described in Troubleshooting.
- Log in to the RHEL 8 system and verify its state as described in Verifying the post-upgrade state of the RHEL 8 system.
- Re-evaluate and re-apply your security policies. Especially, change the SELinux mode to enforcing. For details, see Applying security policies.
If you upgraded using RHUI on AWS or Microsoft Azure and your software certification is not available on a later minor release version, lock your system to a minor release version supported by your certification.
# echo '8.x' > /etc/yum/vars/releasever