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.