Satellite Registration Guide

How to register and reregister a host using Satellite 6.


Ensure subscription-manager is installed

Find the version of RHEL that’s installed on the host. This information will be used repeatedly through these steps.

# cat /etc/redhat-release
Red Hat Enterprise Linux Server release 6.9 (Santiago)

Ensure that you’re using subscription-manager.

# yum install subscription-manager
Loaded plugins: enabled_repos_upload, package_upload, product-id, search-disabled-repos, security
Setting up Install Process
epel/metalink                                                                                 |  17 kB     00:00     
realmlinux-base                                                                               | 3.6 kB     00:00     
realmlinux-extras                                                                             | 2.9 kB     00:00     
rhel-6-server-extras-rpms                                                                     | 1.8 kB     00:00     
rhel-6-server-optional-rpms                                                                   | 2.0 kB     00:00     
rhel-6-server-rh-common-rpms                                                                  | 2.1 kB     00:00     
rhel-6-server-rpms                                                                            | 2.0 kB     00:00     
rhel-6-server-satellite-tools-6.2-rpms                                                        | 2.1 kB     00:00     
rhel-6-server-supplementary-rpms                                                              | 2.0 kB     00:00     
Package subscription-manager-1.18.10-1.el6.x86_64 already installed and latest version
Nothing to do
Uploading Enabled Repositories Report
Loaded plugins: product-id

Run registration script

chmod u+x
./ -s -k YourKeyHere -v


  • Server (-s or –server): Specify server as the hostname of a capsule or satellite server that this host should connect to for updates.
  • Key (-k or –key): Activation key string existing on the Satellite which will allow registration.
  • Verbose (-v or –verbose): Brevity may be the soul of wit, but verbosity is the engine of troubleshooting.

Verify your repositories

Make sure all your repositories are enabled as needed

# subscription-manager repos --list
    Available Repositories in /etc/yum.repos.d/redhat.repo
Repo ID:   rhel-7-server-rpms
Repo Name: Red Hat Enterprise Linux 7 Server (RPMs)
Repo URL:  https://YOUR-CAPSULE-HOSTNAME-HERE/pulp/repos/North_Carolina_State_University/Library/content/dist/rhel/server/7/$releasever/$basearch/os
Enabled:   1

.... this list has been trimmed ....

Repo ID:   rhel-7-server-optional-rpms
Repo Name: Red Hat Enterprise Linux 7 Server - Optional (RPMs)
Repo URL:  https://YOUR-CAPSULE-HOSTNAME-HERE/pulp/repos/North_Carolina_State_University/Library/content/dist/rhel/server/7/$releasever/$basearch/optional/os
Enabled:   0

If, for example, you need to enable one or more repositories you can do it like this:

# subscription-manager repos --enable rhel-7-server-optional-rpms
Repository 'rhel-7-server-optional-rpms' is enabled for this system.

Confirm Functionality

Update or install packages to test functionality.

# yum update

Manual Process

  1. If you are currently registered with a satellite and you need to re-register, you need to unregister from your current satellite first!
    # subscription-manager unregister
    # subscription-manager clean
  2. We also need to find and remove the Katello CA rpm.
    # rpm -qa | grep katello
  3. In this case, it’s named “” so we:
    # yum remove
  4. Clear our yum cache so yum isn’t confused about the change:
    # yum clean all
    # rm -rf /var/cache/yum
  5. Make sure the subscription-manager.conf plugin is enabled and rhnplugin is disabled
      # grep enabled /etc/yum/pluginconf.d/rhnplugin.conf /etc/yum/pluginconf.d/subscription-manager.conf
      /etc/yum/pluginconf.d/rhnplugin.conf:enabled = 0
  6. Download and install a copy of the CA Certificate for the Red Hat Satellite 6 server.
      # rpm -Uvh http://HOSTNAME-OF-CAPSULE-SERVER/pub/katello-ca-consumer-latest.noarch.rpm
  7. Register your host with the capsule. Make sure you give the correct activation key (see above).
      # subscription-manager register --org=North_Carolina_State_University --activationkey="YOUR_ACTIVATION_KEY"
  8. Make sure rhel-7-server-satellite-tools-6.4-rpms is enabled - not just listed.
      # subscription-manager repos --enable rhel-7-server-satellite-tools-6.4-rpms
  9. Install the Katello agent
      # yum install katello-agent
Tags: rhel satellite
Edit me