How do I register a system to Red Hat Satellite 6 server?

Environment

• Client System:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • Red Hat Enterprise Linux (RHEL) 7
  • Red Hat Enterprise Linux (RHEL) 8
  • Red Hat Enterprise Linux (RHEL) 9

• Server:

  • Red Hat Satellite 6.9 and later

Issue

• How do you register an RHEL client system with the Red Hat Satellite 6 server?

Resolution

Recommended method of registration:

• At present, The recommended way to register or re-register any RHEL systems with the Red Hat Satellite 6 server is to follow the Global Registration method which allows generating a curl command and execution of just that command on the RHEL client system would be able to connect it to Red Hat Satellite server.

  • Refer to the Red Hat Satellite 6 Feature Overview: Registering Hosts using the Global Registration method to know more in detail.

  • A high-level overview would be:

    1. To have the required repository content enabled and synchronized in the satellite server properly.

    2. [Optionally] To have a set of content-views created, published, and promoted to the expected lifecycle environment with the necessary repositories included in them.

    3. To have the required activation keys created with the correct properties selected and repository sets enabled. This would help further with the registration and association of systems with expected repositories after the registration has been completed.

    4. From the WebUI of the Red Hat Satellite server, Navigate to the Hosts --> Register Host page, select and fill out the required options in the General as well as the Advanced tab, and make sure to specify the Token life time and then click on Generate button to generate the command.

    5. Copy the curl command from step 4 and execute on directly on the target RHEL host to register it with the satellite server.

Deprecated [ and soon to be removed ] way of registration:

• While users are not being encouraged to use this, The following high-level steps explain the older method of registration:

  • Set up everything on the Red Hat Satellite server side in the same way as it was mentioned above by following the first three steps so that you have the required activation keys prepared with the expected set of repositories enabled in it.

  • Note down the name and label of the organization.

    # hammer organization list
    

  • Keep the name of the activation key handy as well.

  • On the RHEL client system side, run the following commands.

    1. Download and install a copy of the CA Certificate for the Red Hat Satellite 6 server.

       # rpm -Uvh http://<Satellite_FQDN>/pub/katello-ca-consumer-latest.noarch.rpm
       

    2. Use the subscription-manager command to register to the satellite server and confirm that expected repositories are accessible.

       # subscription-manager register --activationkey="<name of the key>" --org="<name of the organization>"
       # subscription-manager status
       # yum clean all && yum repolist -v
       

RHEL Systems Registration Guide

• This document is part of a collection covering RHEL System Registration.
  • If this is not the right solution for your registration needs or;
  • If you wish to make a different registration choice;
    • then you can return to the RHEL Systems Registration Guide or try the Registration Assistant which automates the process.

Red Hat Labs Registration Assistant

We also have an online tool to assist you in selecting the most appropriate registration technology for your system. If you would prefer to use this tool, please visit This content is not included.This content is not included.https://access.redhat.com/labs/registrationassistant/.

For more KB articles/solutions related to Red Hat Satellite 6.x Client Subscription Issues, please refer to the Red Hat Satellite Consolidated Troubleshooting Article for Red Hat Satellite 6.x Client Subscription Issues

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.