UNC Red Hat Network Satellite Server Documentation


Satellite 6 Server

Accessible at https://redhatsat.its.unc.edu with your onyen account and password.

How to register a new system

  1. Download http://redhatsat.its.unc.edu/pub/satellite-register-new.sh
  2. Edit the satellite-register-new.sh file and replace the xxxxxxxxx with your Activation Key
  3. Run the script from the command line with sudo or as root

How to Update a system

  1. yum update

How to disable the goferd service

Goferd is a legacy service that has been superceded by the yum plugins provided by the katello-host-tools rpm. We recommend that you disable the goferd service which has never been a reliable way to report information to the Satellite server or to install errata.

  • RHEL 7
    • sudo yum upgrade –disablerepo=* –enablerepo=rhel-7-server-satellite-tools-6.2-rpms
    • systemctl stop goferd.service
    • systemctl mask goferd.service
  • RHEL 6
    • yum upgrade –disablerepo=* –enablerepo=rhel-6-server-satellite-tools-6.2-rpms
    • service goferd stop
    • chkconfig goferd off

How to Install packages

  1. yum install package_name

Cloning Virtual Machines

  • Clone your VM before you register it to the Satellite server
  • If you can’t/didn’t by accident, then to fix problems created by cloning


How to get emails with errata notifications for your hosts

  1. Log in to https://redhatsat.its.unc.edu
  2. Click on your name in the upper right hand corner
  3. Click My account
  4. Click Email Preferences
  5. Set Host errata advisory to Daily, Weekly, etc.

How to enable repositories on Satellite 6 (used to be called channels)

  1. List available disabled repositories: sudo subscription-manager repos −−list−disabled (note that you can’t copy and paste this since wordpress munges double-dashes)
  2. Enable a repo: sudo subscription-manager repos ––enable rhel-server-rhscl-7-rpms (note that you can’t copy and paste this since wordpress munges double-dashes)

How to Download ISO images

  1. Server https://redhatsat.its.unc.edu/pub/RHEL6_ISOs/ or https://redhatsat.its.unc.edu/pub/RHEL7_ISOs/
  2. Workstation https://redhatsat.its.unc.edu/pub/RHEL6_Workstation_ISOs/ or https://redhatsat.its.unc.edu/pub/RHEL7_Workstation_ISOs/

How to Install Red Hat Enterprise Linux 7 over the network

You can install Red Hat Linux on your system over the network without downloading the entire set of ISO images.
  1. https://redhatsat.its.unc.edu/pub/RHEL7_ISOs/rhel-server-7.2-x86_64-boot.iso and burn it on a CD. (see the listing in https://redhatsat.its.unc.edu/pub/RHEL7_ISOs/ for the options)
  2. Boot the CD and proceed with the install.  On the Installation Summary screen select Installation Source > On the Network, http://
  3. For the kickstart URL
    1. RHEL 7: http://redhatsat.its.unc.edu/pulp/repos/ITS-Infrastructure/Library/content/dist/rhel/server/7/7Server/x86_64/kickstart/
    2. RHEL 6: http://redhatsat.its.unc.edu/pulp/repos/ITS-Infrastructure/Library/content/dist/rhel/server/6/6Server/x86_64/kickstart/
  4. The install should go as normal from here.


  • Errata is not showing up correctly for Content Hosts and/or Last Checkin date is not today
    • this issue can be resolved by following these steps
  1. sudo yum install katello-agent -y
  2. sudo service goferd restart
  3. sudo service rhsmcertd restart
  4. sudo rm /var/lib/rhsm/packages/packages.json
  5. sudo katello-package-upload
  • Test email button does not work
    • this is a known issue with no fix at the time
    • email notifications DO work fine and are sent at 7AM
  • Yum refreshes repo metadata on every command
    • edit /etc/rhsm/rhsm.conf to set ‘full_refresh_on_yum = 0’
  • Subscription information is not showing up
    • force the subscription information to update from the server immediately
    • $sudo service rhsmcertd stop
      Redirecting to /bin/systemctl stop  rhsmcertd.service.service
      $sudo rhsmcertd –now
      $sudo service rhsmcertd start
      Redirecting to /bin/systemctl start  rhsmcertd.service.service
      $sudo subscription-manager status