Chapter 2. Preparing for a RHEL conversion

This procedure describes the steps that are necessary before performing the conversion from CentOS Linux to Red Hat Enterprise Linux (RHEL).


  • You have verified that your system is supported for conversion to RHEL. See Supported conversion paths for more information.
  • You have stopped important applications, database services, and any other services that store data to reduce the risk of data integrity issues.
  • You have temporarily disabled antivirus software to prevent the conversion from failing.
  • You have disabled or adequately reconfigured any configuration management system (such as Salt, Chef, Puppet, Ansible) to not attempt to restore the original system.


  1. Back up your system and verify that you can restore your system.
  2. Check Known issues and limitations and verify that your system is supported for conversion. Apply workarounds where applicable.
  3. Install Convert2RHEL:

    1. Download the Red Hat GPG key:

      # curl -o /etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
    2. Install the Convert2RHEL repository:

      # curl -o /etc/yum.repos.d/convert2rhel.repo

      Replace version_number with the appropriate major version of the OS, for example 7 or 8.

    3. Install the Convert2RHEL utility:

      # yum -y install convert2rhel
  4. Ensure you have access to RHEL packages through one of the following methods:

    1. Red Hat Content Delivery Network (CDN) through Red Hat Subscription Manager (RHSM). You must have a Red Hat account and an appropriate RHEL subscription to access RHSM. Note that the OS will be converted to the latest minor version of RHEL for the appropriate major version.
    2. Red Hat Satellite in a version that has Full or Maintenance support. For more information, see Red Hat Satellite Product Life Cycle.


      Ensure that the Satellite server meets the following conditions:

      • Satellite has a subscription manifest with RHEL 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.
      • All required repositories are enabled and synchronized with the latest updates and published on Satellite. Enable at minimum the following repositories for the appropriate major version of the OS:

        • Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
        • Red Hat Enterprise Linux 8 for x86_64 - AppStream RPMs 8
        • Red Hat Enterprise Linux 8 for x86_64 - BaseOS RPMs 8
    3. Custom repositories configured in the /etc/yum.repos.d/ directory and pointing to a mirror of the latest RHEL minor version repositories. Use custom repositories for systems that can connect to only local networks and cannot therefore access Red Hat CDN through RHSM. Make sure that the repositories contain the latest content available for that RHEL minor version to prevent downgrading and potential conversion failures. For more information, see Creating a Local Repository and Sharing With Disconnected/Offline/Air-gapped Systems.


      RHEL 8 content is distributed through two default repositories, BaseOS and AppStream. If you are accessing RHEL packages through custom repositories, you must configure both default repositories for a successful conversion. When running the Convert2RHEL utility, make sure to enable both repositories using the --enablerepo option. For more information about RHEL 8 repositories, see Considerations in adopting RHEL 8.

  5. If you are accessing RHEL packages through a Red Hat Satellite server, download the consumer RPM to the /usr/share/convert2rhel/subscription-manager/ directory:

    # curl --insecure --output /usr/share/convert2rhel/subscription-manager/katello-ca-consumer-latest.noarch.rpm

    Replace with the hostname of your Satellite server.

  6. Update packages from the original OS to the latest version that is available in the repositories accessible from the system and reboot the system:

    # yum update -y
    # reboot

    You must perform the conversion from the latest version of the OS to use the rollback feature in case the conversion fails. For more information, see Rollback.