Satellite Registration Guide

How to register and reregister a host using Satellite 6.

Steps

Download subscribe_sat6.sh
Ensure subscription-manager is installed
Know your hostnames and activation key
Run script

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

wget https://doc100web.oit.ncsu.edu/var/subscribe_sat6.sh
chmod u+x subscribe_sat6.sh
./subscribe_sat6.sh -s YourCapsuleHostnameHere.unity.ncsu.edu -k YourKeyHere -v

Arguments

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

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
```

We also need to find and remove the Katello CA rpm.

# rpm -qa | grep katello
katello-ca-consumer-rhn201cap.unity.ncsu.edu-1.0-1.noarch

In this case, it’s named “katello-ca-consumer-rhn201cap.unity.ncsu.edu-1.0-1.noarch” so we:
```
# yum remove katello-ca-consumer-rhn201cap.unity.ncsu.edu-1.0-1.noarch
```
Clear our yum cache so yum isn’t confused about the change:
```
# yum clean all
# rm -rf /var/cache/yum
```

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
  /etc/yum/pluginconf.d/subscription-manager.conf:enabled=1

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

  # subscription-manager register --org=North_Carolina_State_University --activationkey="YOUR_ACTIVATION_KEY"

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

Install the Katello agent
```
  # yum install katello-agent
```

Tags:

Edit me