Chapter 7. Converting a Host to Red Hat Enterprise Linux
Chapter 7. Converting a Host to Red Hat Enterprise Linux You can convert Red Hat Enterprise Linux derivative distributions into a supportable Red Hat Enterprise Linux on a host while retaining installed applications and configurations. Satellite provides the Convert2RHEL utility to simplify the conversion process. The Convert2RHEL utility in Satellite consists of an Ansible role and Ansible playbook. You use the Ansible role to generate conversion data on Satellite Server, which includes enabling required repositories and creating products, activation keys, and host groups. Then you perform the actual conversion on the host using the Ansible playbook, which installs the Convert2RHEL CLI tool on the host and runs it. You can use the Ansible role to generate conversion data for the following conversions: CentOS Linux 7 to Red Hat Enterprise Linux 7 Oracle Linux 7 to Red Hat Enterprise Linux 7 CentOS Linux 8 to Red Hat Enterprise Linux 8 Oracle Linux 8 to Red Hat Enterprise Linux 8 These conversions are supported by Red Hat. The conversion process is similar to a minor release upgrade of Red Hat Enterprise Linux in which every RPM package on the system is replaced. Third-party packages and non-Red Hat packages that are not available in Red Hat Enterprise Linux are retained. The Convert2RHEL utility removes unnecessary packages such as logos or packages known to cause issues during the conversion. The utility replaces the CentOS-release or Oracle-release package with the rhel-release package, and all packages signed by CentOS or Oracle with their Red Hat equivalents. The utility also subscribes the host to Red Hat Subscription Management. The duration of the conversion process depends on the number of packages that have to be replaced, network speed, storage speed, and similar factors. Prerequisites Review Supported conversion paths in Converting from an RPM-based Linux distribution to RHEL . You must have completed the steps 1. - 5. of the procedure Preparing for a RHEL conversion in Converting from an RPM-based Linux distribution to RHEL . Ensure you have a subscription manifest uploaded to your Satellite and that there are sufficient Red Hat Enterprise Linux entitlements allocated for the conversions you intend. Alternatively, you can use Ansible variables to tell the role to import the manifest from disk. The manifest must be imported to the organization to which you will register hosts for conversion. You can update your allocations and download the updated manifest from the Red Hat Customer Portal . For more information, see Using manifests in Red Hat Subscription Management . Ensure that you have enabled Red Hat repositories in Satellite for the minor Red Hat Enterprise Linux version to which you convert your hosts. High-Level Conversion Steps Import the redhat.satellite.convert2rhel Ansible role and variables. For more information, see Importing Ansible Roles and Variables in Configuring Red Hat Satellite to use Ansible . Configure Ansible variables for generation of conversion data. For more information, see Section 7.1, "Ansible Variables for Conversion" . Assign the redhat.satellite.convert2rhel role to the host that represents Satellite Server. For more information, see Assigning Ansible Roles to an Existing Host in Configuring Red Hat Satellite to use Ansible . Run the Ansible role on Satellite Server. For more information, see Running Ansible Roles on a Host in Configuring Red Hat Satellite to use Ansible . The Ansible role generates data required for host conversion, that is, repositories, certificates, activation keys, and host groups. The role enables the rhel-7-server-rpms repository with the 7Server release and x86_64 architecture, or rhel-8-for-x86_64-baseos-rpms and rhel-8-for-x86_64-appstream-rpms , or both, depending on which variables you have set in the steps. Register a host for conversion using a generated host group. Use the global registration template to register and subscribe your host before the conversion. Select the host group that was generated for the conversion you intend, such as CentOS 8 converting if you convert the host from CentOS 8. For more information, see Section 3.3, "Registering Hosts by Using Global Registration" . Run the Convert2RHEL playbook on the host. Execute a remote job with the following settings: Job category : Convert 2 RHEL Job template : Convert to RHEL Activation key : convert2rhel_rhel7 or convert2rhel_rhel8 For more information, see Section 12.15, "Executing a Remote Job" . Additional resources How to perform an unsupported conversion from a RHEL-derived Linux distribution to RHEL 7.1. Ansible Variables for Conversion Before you run the Ansible role to generate conversion data, configure values of the following required Ansible variables. Satellite imports most of the required Ansible variables from the redhat.satellite.convert2rhel role. However, some variables are not imported. These variables are marked with an asterisk * in the tables below. You must create those additional variables manually and assign them to the redhat.satellite.convert2rhel role. Table 7.1. Required variables for conversion Name Type Intent and value satellite_server_url * string URL of your Satellite Server, such as https://satellite.example.com satellite_username * string Your user name satellite_password * string Your password satellite_organization * string Name of your organization satellite_content_rhel_wait_for_syncs * boolean Set to false if you do not want Satellite Server to wait until repository sync finishes before continuing with data generation. (default: true ) satellite_validate_certs * boolean Set to true if you want to enable certificate checks in Ansible. (default: true ) satellite_convert2rhel_manage_subscription boolean Set to false if you already have a manifest on your Satellite Server. If you upload a new manifest from disk, the current manifest will be overwritten. (default: true ) satellite_content_rhel_enable_rhel7 * boolean Enables Red Hat Enterprise Linux 7 repositories. Set to false if you do not intend to convert hosts to Red Hat Enterprise Linux 7. (default: true ) satellite_convert2rhel_enable_oracle7 boolean Set to true if you want to prepare conversion data for Oracle Linux 7. Otherwise, you must set the value to false . satellite_content_rhel_enable_rhel8 * boolean Enables Red Hat Enterprise Linux 8 repositories. Set to false if you do not intend to convert hosts to Red Hat Enterprise Linux 8. (default: true ) satellite_convert2rhel_enable_oracle8 boolean Set to true if you want to prepare conversion data for Oracle Linux 8. Otherwise, you must set the value to false . Table 7.2. Optional variables for conversion Name Type Intent and value satellite_manifest_path * string Path to a manifest to upload from disk, such as ~/manifest.zip . You must set this path if you upload a new manifest from disk using satellite_convert2rhel_manage_subscription . satellite_content_rhel_rhel8_releasever * string Minor release version, such as 8.5 . Set this variable if the minor release version of your system differs from the latest Red Hat Enterprise Linux release to prevent conversion issues. (default: latest)