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:

  1. 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
    
  2. Enable the migrate repo. Answer “y” to any questions from yum.
    # yum --disablerepo=* --enablerepo=migrate update
    # yum clean all
    # yum update
    
  3. 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.

  1. Edit /etc/yum/pluginconf.d/rhnplugin.conf and make sure it is disabled (enabled=0)
  2. 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.

  1. Clean your subscription
    subscription-manager unregister
    subscription-manager clean
    
  2. Clean your yum cache
    yum clean all
    rm -rf /var/cache/yum
    
  3. Repeat the registration steps from your original instructions.

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

  1. Clean your subscription
    subscription-manager unregister
    subscription-manager clean
    
  2. Clean your yum cache
    yum clean all
    rm -rf /var/cache/yum
    
  3. 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
  1. 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.

  1. Run subscription-manager refresh This is the magic that should fix you right up.
Tags: rhel satellite
Edit me