In Red Hat Satellite 6.10, we introduced a new feature that enables the bulk conversion of multiple hosts to Red Hat Enterprise Linux (RHEL) using the Convert2RHEL utility. In this post, I will walk through the individual steps required to convert a CentOS Linux 7.9 host to Red Hat Enterprise Linux 7.9.

Background

Convert2RHEL is a Red Hat utility that enables the conversion of select operating systems that are similar or derived from RHEL, like CentOS Linux and Oracle Linux, for example. Terry Bowling wrote extensively about it in his introduction to Convert2RHEL (and a follow-up including Oracle Linux).

Red Hat Satellite provides a life cycle management solution that automates common RHEL tasks from provisioning and patching to executing remediation playbooks that fix what Red Hat Insights finds with the push of a button. 

Red Hat Satellite 6.10 improves and streamlines the process of converting Linux hosts to RHEL. Here are the high-level steps required to perform a bulk conversion:

  1. Synchronize Convert2RHEL repositories to the Red Hat Satellite server.

  2. Create an activation key.

  3. Register the CentOS Linux host(s) to the Red Hat Satellite server.

  4. Schedule a job to convert candidate hosts.

Important! Please review the supported conversion paths and ensure that your hosts are up to date before attempting a bulk conversion. Please review the official documentation as well.

Synchronize Convert2RHEL repositories to Red Hat Satellite server

The first step is to create a new product. Click on Content and select Products. Then, click on Create Product.

create product menu

In the Create Product menu, do the following:

  1. Name the product.

  2. Select a sync plan (optional). 

  3. Save the product.

create product

Then we’ll create a repository for the newly created product. Click on New Repository.

click new repo

Then, do the following:

  1. Give the repository a name. In this example, it’s Convert2RHEL.

  2. Assign it the type of yum.

  3. Specify the upstream URL of https://cdn.redhat.com/content/public/convert2rhel/7/x86_64/os/. Please note that you will need to modify the URL to https://cdn.redhat.com/content/public/convert2rhel/8/x86_64/os/ for CentOS Linux 8 hosts.

  4. If you have not installed a trusted certificate, ensure the Verify SSL checkbox is cleared.

new repo parameters

Leave the rest of the parameters and save the new repository.

Next, synchronize the repository:

  1. Select the newly created repository.

  2. Click Sync now.

sync now  Wait for the repository to synchronize.

sync wait

Next, we’ll create a content view that contains the convert2rhel repo as well as the Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server repo. Click on Content and select Content Views. Then, click on Create New View

We’ll name this content view “RHEL7.”

Perform the following steps:

  1. Check the Convert2RHEL repository we just created.

  2. Check the Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server repo 

  3. Clickd Add Repositories.

  add repos

Then, click Publish New Version.

pub new version

Make sure to promote it to the desired life cycle environment. 

Create an activation key

The activation key will associate the RHEL 7 content view created in the previous section with the CentOS Linux host so it can access the required content to convert to RHEL. We’ll be using the activation key to register CentOS Linux 7.9 hosts to Satellite in the sections provided after this. 

Click on Content and select Activation Keys. Then, click on Create Activation Key.

create activation key

Create a new activation key associated with the RHEL7 content by performing the following steps:

  1. Name your activation key.

  2. Select the appropriate environment.

  3. Select the content view containing the Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server repository as well as the Convert2RHEL repository.

activation key desc Save the Activation Key. If you do not have Simple Content Access (SCA) enabled, please consult the Simple Content Access documentation on the exact steps to complete. SCA significantly reduces the configuration steps.

Register the CentOS Linux host(s) to the Red Hat Satellite server

On the side menu, click on Hosts and select All Hosts. Then, click on Register Host.

register host Perform the following steps:

  1. Change the Setup REX dropdown to “Yes.”

  2. In the Activation Keys dropdown, select the activation key you created in the previous section.

  3. Click on General.

generate host  

Next:

  1. Check the Insecure checkbox. This step is applicable if you have not manually deployed the Satellite CA certificate to the host you are trying to register.

  2. Click on the Generate button.

insecure generate

This will generate a curl command that you must run on your CentOS Linux host to register it with your Satellite server as seen in the following image.

host curl command

Copy the curl command and run it on all the CentOS Linux hosts you wish to convert. The result should look like the truncated output shown here. 

centos output

Schedule a job to convert candidate hosts

Click on Hosts on the side menu, then perform the following steps:

  1. Select the CentOS Linux hosts to be converted to RHEL.

  2. Click on Schedule Remote Job.

schedule remote job

Next, perform the following steps in the Job invocation menu:

  1. Select the Convert2RHEL job category. 

  2. Enter the activation key you created in the previous section.

  3. Click Submit.

job category We can see the Ansible job running now.
ansible job run When the conversion is complete, the converted hosts will show up as running RHEL.

converted hosts Congratulations, you have successfully converted your CentOS Linux hosts to RHEL!

Conclusion

We’ve covered the technical details on converting large numbers of CentOS Linux or Oracle Linux hosts to RHEL. Satellite 6.10 makes it easy to run bulk Convert2RHEL operations to minimize administrative and technical overhead to ensure that your organization can take advantage of the benefits of Red Hat Enterprise Linux.


About the author

As a Senior Principal Technical Marketing Manager in the Red Hat Enterprise Linux business unit, Matthew Yee is here to help everyone understand what our products do. He joined Red Hat in 2021 and is based in Vancouver, Canada.

Read full bio