Chapter 3. Converting to a RHEL system
This procedure describes the steps necessary to convert your system from CentOS Linux or Oracle Linux to Red Hat Enterprise Linux (RHEL).
If you are accessing RHEL packages using Red Hat CDN or Satellite through RHSM, there are two methods of registering and subscribing your system during the conversion:
- Provide the organization ID and activation key. This method is preferred when converting many systems or when automating the conversion process using scripts. You must be the organization administrator to create an activation key. You must use this method if you are accessing RHEL packages using Satellite through RHSM.
- Provide the username, password, and pool ID. Any user who is accessing RHEL packages using Red Hat CDN through RHSM can use this method.
- You have completed the steps listed in Preparing for a RHEL conversion.
- If you are providing the organization ID and activation key to register and subscribe your system, you have created an activation key in Satellite or RHSM. For more information, see Managing activation keys in Satellite documentation and Understanding activation keys in RHSM documentation.
You can use
Convert2RHELwith either RHSM or custom repositories.
With the organization ID and activation key:
# convert2rhel --org organization_ID --activationkey activation_key
Replace organization_ID and activation_key with the organization ID and the activation key from the Red Hat Customer Portal if you are using Red Hat CDN or the Satellite web UI if you are using Red Hat Satellite.Note
If you are accessing RHEL packages using Satellite, you must use the organization ID and activation key to run the
If you are accessing RHEL packages using Satellite and your system does not have internet access, add the
--keep-rhsmoption. Note that you must have the
katello-ca-consumerpackages already installed and must provide your organization ID and activation key when running the
With the username, password, and pool ID:
# convert2rhel --username username --password password --pool pool_ID
Replace username and password with your Red Hat Account credentials. Replace pool_ID with the pool ID of the subscription that you want to attach to the system. If you do not know the pool ID, omit the
--pooloption to generate a list of all subscriptions available for the account.
Using custom repositories:
# convert2rhel --no-rhsm --enablerepo RHEL_RepoID1 --enablerepo RHEL_RepoID2
Replace RHEL_RepoID with your custom repository configured in the
/etc/yum.repos.d/directory, for example,
To display all available options, use the
# convert2rhel -hNote
When converting using RHSM or custom repositories, you can enable the RHEL 7 Extras or Optional repositories manually by using the
--enablerepooption to replace additional packages with their RHEL counterparts. Note that packages in the Optional repository are unsupported. For more information, see Support policy of the optional and supplementary channels in Red Hat Enterprise Linux.
Convert2RHELstarts replacing packages from the original distribution with RHEL packages, the following warning message is displayed:
The tool allows rollback of any action until this point. By continuing, all further changes on the system will need to be reverted manually by the user, if necessary.
Changes made by
Convert2RHELup to this point can be automatically reverted. Confirm that you wish to proceed with the conversion process.
Convert2RHELinstalls the RHEL packages and finishes successfully.
- Recommended: If you used custom repositories for the conversion, register and subscribe your RHEL system. For more information, see How to register and subscribe a system offline to the Red Hat Customer Portal?.
At this point, the system still runs with the original distribution kernel loaded in RAM. Reboot the system to boot the newly installed RHEL kernel.
Remove third-party packages from the original OS that remained unchanged (typically packages that do not have a RHEL counterpart). To get a list of these packages, use:
# yum list extras --disablerepo="*" --enablerepo=RHEL_RepoID
Replace RHEL_RepoID with your repository.
- Verify that your system operates as expected. If necessary, reconfigure system services after the conversion and fix dependency errors. For more information, see Fixing dependency errors.