Procedure

1. Ensure your system has been successfully registered to the Red Hat Content Delivery Network (CDN) or Red Hat Satellite using the Red Hat Subscription Manager.

   Important

   If your system is registered to Satellite Server, ensure that Satellite meets the following conditions:

   1. Satellite is on a version in full or maintenance support. For more information, see Red Hat Satellite Product Life Cycle.
   2. Satellite has a subscription manifest with RHEL 8 repositories imported. For more information, see the Managing Subscriptions chapter in the Content Management Guide for the particular version of Red Hat Satellite, for example, for version 6.8.

   3. All required repositories are enabled and synchronized with the latest updates and published on Satellite. For example, for the Intel architecture without an Extended Update Support (EUS) subscription, enable at minimum the following repositories:

      • Red Hat Enterprise Linux 7 Server (RPMs)

        rhel-7-server-rpms

        x86_64 7Server or x86_64 7.9

      • Red Hat Enterprise Linux 7 Server - Extras (RPMs)

        rhel-7-server-extras-rpms

        x86_64

      • Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)

        rhel-8-for-x86_64-appstream-rpms

        x86_64 8.2

      • Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)

        rhel-8-for-x86_64-baseos-rpms

        x86_64 8.2

        For more information, see the Importing Red Hat Content chapter in the Content Management Guide for the particular version of Red Hat Satellite, for example, for version 6.8.

   4. The content host belongs to one of the following:

      • A Content View containing the above RHEL 7 and RHEL 8 repositories.

      • The Default Organization View Content View and the Library life cycle environment.

        For more information, see the Managing Content Views chapter in the Content Management Guide for the particular version of Red Hat Satellite, for example, for version 6.8.

2. Verify that you have the Red Hat Enterprise Linux Server subscription attached:

   # subscription-manager list --installed
   +-------------------------------------------+
       	  Installed Product Status
   +-------------------------------------------+
   Product Name:  	Red Hat Enterprise Linux Server
   Product ID:     69
   Version:        7.9
   Arch:           x86_64
   Status:         Subscribed

   You should see Server in the product name and Subscribed as the status.

3. Ensure you have appropriate repositories enabled. The following commands list repositories for the 64-bit Intel architecture; for other architectures, see RHEL 7 repositories.

   1. Enable the Base repository:

      # subscription-manager repos --enable rhel-7-server-rpms

   2. Enable the Extras repository where Leapp and its dependencies are available:

      # subscription-manager repos --enable rhel-7-server-extras-rpms

      Note

      You can also have the Optional or Supplementary repositories enabled; see their list in RHEL 7 repositories. In such a case, Leapp enables the RHEL 8 CodeReady Linux Builder or the RHEL 8 Supplementary repositories, respectively.

4. Set the Red Hat Subscription Manager to consume the latest RHEL 7 content:

   # subscription-manager release --unset

5. Optional: If you want to use custom repositories, configure them per instructions in Configuring custom repositories.

6. If you use the yum-plugin-versionlock plug-in to lock packages to a specific version, clear the lock by running:

   # yum versionlock clear

   See How to restrict yum to install or upgrade a package to a fixed specific package version? for more information.

7. Ensure you have the system locale set to en_US.UTF-8:

   $ cat /etc/locale.conf

   If the locale is different, follow instructions in How to change system locale on RHEL7?.

8. If you are upgrading using Red Hat Update Infrastructure (RHUI) on a public cloud, complete the following tasks to ensure your system is ready for upgrade.

   1. For AWS, enable the Red Hat Update Infrastructure 3 Client Configuration Server 7 repository and install required RHUI packages.

      # yum-config-manager --enable rhui-client-config-server-7
      # yum -y install rh-amazon-rhui-client leapp-rhui-aws

   2. For Microsoft Azure, enable the Microsoft Azure RPMs for Red Hat Enterprise Linux 7 repository and install required RHUI packages.

      # yum-config-manager --enable rhui-microsoft-azure-rhel7
      # yum -y install rhui-azure-rhel7 leapp-rhui-azure

      Note

      If you locked the Azure virtual machine (VM) to a minor release, remove the version lock. For more information, see Switch a RHEL 7.x VM back to non-EUS.

9. If you manage containers in Docker, recreate those containers with the appropriate container images using Podman and then attach any in-use volumes. For more information, see How do I migrate my Docker containers to Podman prior to moving from Red Hat Enterprise Linux 7 to Red Hat Enterprise Linux 8?

10. Update all packages to the latest RHEL 7 version:

    # yum update

11. Reboot the system:

    # reboot

12. Install the Leapp utility:

    # yum install leapp leapp-repository

    Note that currently you need version 0.12.1 or later of the leapp package and version 0.13.0 or later of the leapp-repository package.

13. Download additional required data files (RPM package changes and RPM repository mapping) attached to the Knowledgebase article Data required by the Leapp utility for an in-place upgrade from RHEL 7 to RHEL 8 and place them in the /etc/leapp/files/ directory. This is necessary for a successful upgrade. Note that currently you need data files from the leapp-data13.tar.gz archive or later.

    Note

    If you are upgrading on a public cloud using RHUI and do not have a Red Hat subscription or Red Hat Customer Portal account, create a no-cost RHEL developer subscription so that you can access the Knowledgebase article and download required data packages. For more information, see How do I get a no-cost Red Hat Enterprise Linux Developer Subscription or renew it?

14. Temporarily disable antivirus software to prevent the upgrade from failing.
15. Ensure you have any configuration management (such as Salt, Chef, Puppet, Ansible) disabled or adequately reconfigured to not attempt to restore the original RHEL 7 system.
16. Ensure your system does not use more than one Network Interface Card (NIC) with a name based on the prefix used by the kernel (eth). For instructions on how to migrate to another naming scheme before an in-place upgrade to RHEL 8, see How to perform an in-place upgrade to RHEL 8 when using kernel NIC names on RHEL 7.
17. Ensure you have a full system backup or a virtual machine snapshot. You should be able to get your system to the pre-upgrade state if you follow standard disaster recovery procedures within your environment. For example, you can use the Relax-and-Recover (ReaR) utility. For more information, see the ReaR documentation and What is Relax and Recover (ReaR) and how can I use it for disaster recovery?. Alternatively, you can use LVM snapshots, or RAID splitting. In case of upgrading a virtual machine, you can create a snapshot of the whole VM.

18. If you are upgrading with Red Hat Subscription Manager and have disabled the subscription-manager plug-in in yum or yum4, re-enable the plug-in. For more information, see Enabling, configuring, and disabling yum plug-ins.

    To determine whether the subscription-manager plug-in is enabled in yum, run the following command:

    # yum 2>&1 | grep "^Loaded plugins"

    A list of enabled plug-ins is generated. Review the list and determine whether subscription-manager is included.

1. Review the pre-upgrade report in the generated leapp-report.txt file and manually resolve reported problems using the command-line interface.
2. Use the web console to review the report, apply automated remediations where available, and fix remaining problems using the suggested remediation hints.

Procedure

1. On your RHEL 7 system, start the upgrade process:

   # leapp upgrade

   Note

   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 --no-rhsm option.

   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.

2. Manually reboot the system:

   # reboot

   In this phase, the system boots into a RHEL 8-based initial RAM disk image, initramfs. Leapp upgrades all packages and automatically reboots to the RHEL 8 system.

   Alternatively, you can run the leapp upgrade command with the --reboot option and skip this manual step.

   If a failure occurs, investigate logs as described in Troubleshooting.

3. Log in to the RHEL 8 system and verify its state as described in Verifying the post-upgrade state of the RHEL 8 system.
4. Complete post-upgrade tasks as described in Performing post-upgrade tasks. Especially, re-evaluate and re-apply your security policies.

1. Ensure your system remains supported after the in-place upgrade. With the general availability of RHEL 8.3, update your system either to RHEL 8.3 or to RHEL 8.2 Extended Update Support (EUS).

   1. Update the system to RHEL 8.3:

      1. Unset Red Hat Subscription Manager to consume the latest RHEL 8.3 content:

         # subscription-manager release --unset

      2. Update your system to the latest RHEL 8.3 version:

         # yum update

   2. Update the system to RHEL 8.2 EUS:

      1. Enable RHEL 8 EUS repositories:

         # subscription-manager repos --enable repository_id1 --enable repository_id2 …

         Replace repository_id* with IDs of EUS repositories available with your subscription. Enable at least the BaseOS and AppStream repositories. For example, on the Intel 64 architecture:

         # subscription-manager repos --enable  rhel-8-for-x86_64-baseos-eus-rpms --enable rhel-8-for-x86_64-appstream-eus-rpms

      2. Update your system to the latest RHEL 8.2.EUS version

         # yum update

2. 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

3. Re-evaluate and re-apply your security policies. Especially, change the SELinux mode to enforcing. For details, see Applying security policies.