Chapter 8. Registering Hosts for Conversion


You have to register your hosts to Satellite before you can convert them to Red Hat Enterprise Linux. You have Satellite generate a registration command that you then execute on each host.

You can run the registration command in bulk by using a configuration management tool, such as Ansible or Puppet, to register a larger amount of hosts.

Prerequisites

  • You have configured Satellite for conversions. For more information, see Chapter 7, Configuring Satellite for Conversions.
  • Ensure that a time-synchronization tool is installed and enabled on your hosts. Satellite and all hosts must be synchronized with the same NTP server.
  • Ensure that the SSL CA file of Satellite is distributed onto your hosts. You can find the location of the SSL CA file by navigating to Administer > Settings > Authentication and locating the value of the SSL CA file setting.

Procedure

  1. Optional: Enable reporting to Red Hat Insights. The conversions toolkit disables new hosts from reporting to Insights by setting the global parameter host_registration_insights to false. For more information, see Global Parameters for Registration in Managing Hosts.
  2. In to the Satellite web UI, navigate to Hosts > Register Host.
  3. In the Host group field, select the CentOS 7 converting host group.
  4. In the Activation Keys field, ensure that the convert2rhel_centos7 activation key is present.
  5. Click Generate.
  6. Copy the generated registration command.
  7. Log in to a host by using SSH and run the registration command as root.

Verification

  • In the Satellite web UI, navigate to Hosts > All Hosts. You can find all hosts that you have registered to Satellite.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat