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.
- Complete post-upgrade tasks as described in Performing post-upgrade tasks. Especially, re-evaluate and re-apply your security policies.