Satellite RHEL 7 Troubleshooting Guide

Satellite troubleshooting through the power of augmented Backus-Naur flatulence.

Problems migrating RHEL 7 clients to Sat 6

These instructions apply to hosts that are registered to Satellite 5 and need to be migrated to Satellite 6.

If you receive a “Cannot retrieve repository metadata (repomd.xml) for repository: realmlinux-server7-x86_64” error, try these steps:

Create /etc/yum.repos.d/migrate.repo with the following contents:

[migrate]
name=RedHat Migration Packages for $releasever
baseurl=http://install.linux.ncsu.edu/pub/yum/OIT/migrate/7/
enabled=1
gpgcheck=0

Enable the migrate repo. Answer “y” to any questions from yum.

# yum --disablerepo=* --enablerepo=migrate update
# yum clean all
# yum update

If yum is successfull, remove the migrate repo.

# rm /etc/yum.repos.d/migrate.repo
# yum clean all

Now that yum is working properly, you should be able to migrate the host to Satellite 6.

Odd yum problems

If you run into odd yum problems either before or after you register to Satellite 6, it may be because you still have remnants of Satellite 5 installed.

Edit /etc/yum/pluginconf.d/rhnplugin.conf and make sure it is disabled (enabled=0)
Make sure the rhnsd serivce is both off AND disabled

... for RHEL 6...
# service rhnsd stop
# chkconfig rhnsd off

... for RHEL 7...
# systemctl stop rhnsd
# systemctl disable rhnsd

Problems registering RHEL 7 clients to Sat 6

These instructions apply to hosts that are not registered to Satellite 6, but have been in the past. Cache can become corrupted and need to be rebuilt.

If you register but cannot receive updates. Or cannot reregister because of a host entry.

Clean your subscription

subscription-manager unregister
subscription-manager clean

Clean your yum cache
```
yum clean all
rm -rf /var/cache/yum
```
Repeat the registration steps from your original instructions.

If you see “Your identity certificate has expired” during registration

Clean your subscription

subscription-manager unregister
subscription-manager clean

Clean your yum cache
```
yum clean all
rm -rf /var/cache/yum
```
Check your Katello CA

Make sure that the hostname matches the your capsule/satellite from the Hosts Page

grep hostname /etc/rhsm/rhsm.conf

If it isn’t correct, run

rpm -Uvh http://YOUR-CAPSULE-HOSTNAME-HERE/pub/katello-ca-consumer-latest.noarch.rpm

Re-subscribe Find your activation key from the Hosts Page

# subscription-manager register --org="North_Carolina_State_University" --activationkey="YOUR-ACTIVATION-KEY-HERE"

You may get a second “Your identity certificate has expired” here.

Run subscription-manager refresh This is the magic that should fix you right up.

Tags:

Edit me