Este conteúdo não está disponível no idioma selecionado.
Chapter 5. Performing the upgrade
After you have completed the preparatory steps and reviewed and resolved the problems found in the pre-upgrade report, you can perform the in-place upgrade on your system.
5.1. Performing the upgrade from RHEL 8.10 to RHEL 9.4 and 9.5
This procedure lists steps required to perform the upgrade by using the Leapp
utility.
Prerequisites
- The steps listed in Preparing for the upgrade have been completed, including a full system backup.
- The steps listed in Reviewing the pre-upgrade report have been completed and all reported issues resolved.
Procedure
On your RHEL 8 system, start the upgrade process:
# leapp upgrade
If you are using 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 upgrading without RHSM or using RHUI, add the
--no-rhsm
option. -
If you are upgrading by using an ISO image, add the
--no-rhsm
and--iso <file_path>
options. Replace <file_path> with the file path to the saved ISO image, for example/home/rhel9.iso
. -
If you have an Extended Upgrade Support (EUS), Advanced Update Support (AUS), or Update Services for SAP Solutions (E4S) (Red Hat Knowledgebase) subscription, add the
--channel channel
option. Replace channel with the value you used with theleapp preupgrade
command, for example,eus
,aus
, ore4s
. Note that you must use the same value with the--channel
option in both theleapp preupgrade
andleapp upgrade
commands. If you are using RHEL for Real Time or the Real Time for Network Functions Virtualization (NFV) in your Red Hat OpenStack Platform, enable the deployment by using the
--enablerepo
option. For example:# leapp upgrade --enablerepo rhel-9-for-x86_64-rt-rpms
For more information, see Configuring Real-Time Compute.
At the beginning of the upgrade process,
Leapp
performs the pre-upgrade phase described in Reviewing the pre-upgrade report.-
If the system is upgradable,
Leapp
downloads necessary data and prepares an RPM transaction for the upgrade. -
If your system does not meet the parameters for a reliable upgrade,
Leapp
terminates the upgrade process and provides a record describing the issue and a recommended solution in the/var/log/leapp/leapp-report.txt
file. For more information, see Troubleshooting.
-
If the system is upgradable,
Manually reboot the system:
# reboot
In this phase, the system boots into a RHEL 9-based initial RAM disk image, initramfs.
Leapp
upgrades all packages and automatically reboots to the RHEL 9 system.Alternatively, you can run the
leapp upgrade
command with the--reboot
option and skip this manual step.If a failure occurs, investigate logs and known issues as described in Troubleshooting.
- Log in to the RHEL 9 system and verify its state as described in Verifying the post-upgrade state.
- Perform all post-upgrade tasks described in the upgrade report and in Performing post-upgrade tasks.
5.2. Performing the upgrade from RHEL 8.8 to RHEL 9.2
This procedure lists steps required to perform the upgrade from RHEL 8.8 to RHEL 9.2 by using the Leapp
utility.
Prerequisites
- The steps listed in Preparing for the upgrade have been completed, including a full system backup.
- The steps listed in Reviewing the pre-upgrade report have been completed and all reported issues resolved.
Procedure
On your RHEL 8 system, start the upgrade process:
# leapp upgrade
If you are using 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 upgrading without RHSM or using RHUI, add the
--no-rhsm
option. -
If you are upgrading by using an ISO image, add the
--no-rhsm
and--iso <file_path>
options. Replace <file_path> with the file path to the saved ISO image, for example/home/rhel9.iso
. -
If you have an Extended Upgrade Support (EUS), Advanced Update Support (AUS), or Update Services for SAP Solutions (E4S) (Red Hat Knowledgebase) subscription, add the
--channel channel
option. Replace channel with the value you used with theleapp preupgrade
command, for example,eus
,aus
, ore4s
. Note that you must use the same value with the--channel
option in both theleapp preupgrade
andleapp upgrade
commands.
At the beginning of the upgrade process,
Leapp
performs the pre-upgrade phase described in Reviewing the pre-upgrade report.-
If the system is upgradable,
Leapp
downloads necessary data and prepares an RPM transaction for the upgrade. -
If your system does not meet the parameters for a reliable upgrade,
Leapp
terminates the upgrade process and provides a record describing the issue and a recommended solution in the/var/log/leapp/leapp-report.txt
file. For more information, see Troubleshooting.
-
If the system is upgradable,
Manually reboot the system:
# reboot
In this phase, the system boots into a RHEL 9-based initial RAM disk image, initramfs.
Leapp
upgrades all packages and automatically reboots to the RHEL 9 system.Alternatively, you can run the
leapp upgrade
command with the--reboot
option and skip this manual step.If a failure occurs, investigate logs and known issues as described in Troubleshooting.
- Log in to the RHEL 9 system and verify its state as described in Verifying the post-upgrade state.
- Perform all post-upgrade tasks described in the upgrade report and in Performing post-upgrade tasks.