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