UNC Red Hat Network Satellite Server Documentation

This article provides directions for the Satellite 6 service

This article provides directions for the Satellite 6 service

Instructions

To view your registered systems, log in to Red Hat Satellite with your Onyen and password.

How to Register a New System

1. Download
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

RHEL 8/9:

dnf upgrade

How to Resolve rpm Dependency Errors

Remove the no longer needed katello packages:

yum remove katello-agent gofer python-gofer python-gofer-proton qpid-proton-c python-qpid-proton yum install katello-host-tools -y

How to Disable the goferd Service

Goferd is a legacy service that has been superseded 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.9-rpms

systemctl stop goferd.service

systemctl mask goferd.service

How to Install Packages

RHEL7:

yum install

RHEL8/9:

dnf install

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

subscription-manager clean rm -rf /var/run/rhsm/

run satellite-register-new.sh

How to Get Emails with errata Notifications for Your Hosts

1. Log in to the Satellite Server
2. Click on your name in the upper right corner
3. Click My Account
4. Click Email Preferences
5. Set Host errata advisory to Daily, Weekly, etc.

How to Enable Repositories

1. List available disabled repositories: sudo subscription-manager repos --list−disabled
2. Enable a repo: sudo subscription-manager repos --enable rhel-server-rhscl-7-rpms

How to Download ISO Images

1. RHEL 9
2. RHEL 8

How to Install Red Hat Enterprise Linux Over the Network

You can install Red Hat Linux on your system over the network without downloading the entire set of ISO images.

1. Download and burn the boot iso on a CD.
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 9
   2. RHEL 8
4. The install should go as normal from here

Application Stream Versions

Beginning with RHEL 8, many RHEL 'application' RPMs are part of Application Streams. While Application Streams provide flexability, the many of default versions are no longer updated after a year or two.

See this article for end of life dates for different versions. Unless an override is used, the default stream versions are enabled and the version set silently when associated RPMs are installed.

You can very quickly see the stream versions installed on a RHEL 8+ system with the command 'grep stream /etc/dnf/modules.d/*' or a bit more slowly with the 'dnf module list --enabled' command.

We recommend checking your systems for 'Retired' streams and switching to newer versions (Full Life versions if possible).

The Red Hat supported procedure to switch to a later stream is here Please note that the 'yum distro-sync' command may upgrade all of the RPMs on the system, not just those related to the stream. Yum Distro-Sync Command "As necessary upgrades, downgrades or keeps selected installed packages to match the latest version available from any enabled repository".

Unless Red Hat changes the default php module version from 7.2, one could override this un-updated default version by adding a file /etc/dnf/modules.defaults.d/php.module with the content:

--- document: modulemd-defaults version: 1 data: module: php stream: "7.4" profiles: 7.4: [common] 8.0: [common]

ITS Repositories Available

You can now use the following repos to install/update splunkforwarder and xagt. Note that since the vendors don't sign these RPMs, we are signing them and you will need to install our key during the first use of the repo.

[rhel9_64_its]

name=rhel9_64_its

enabled=1

baseurl=https://redhatsat.its.unc.edu/pulp/content/ITS-Infrastructure/Library/custom/rhel9_64_its/rhel9_64_its/

gpgkey=https://redhatsat.its.unc.edu/pub/gpg-keys/RPM-GPG-KEY-ITS-Systems-Admin

gpgcheck=1

repo_gpgcheck=0

 

[rhel8_64_its]

name=rhel8_64_its

enabled=1

baseurl=https://redhatsat.its.unc.edu/pulp/content/ITS-Infrastructure/Library/custom/rhel8_64_its/rhel8_64_its/

gpgkey=https://redhatsat.its.unc.edu/pub/gpg-keys/RPM-GPG-KEY-ITS-Systems-Admin

gpgcheck=1

repo_gpgcheck=0

 

[rhel7_64_its]

name=rhel7_64_its

enabled=1

baseurl=https://redhatsat.its.unc.edu/pulp/content/ITS-Infrastructure/Library/custom/rhel7_64_its/rhel7_64_its/

gpgkey=https://redhatsat.its.unc.edu/pub/gpg-keys/RPM-GPG-KEY-ITS-Systems-Admin

gpgcheck=1

repo_gpgcheck=0

Troubleshooting

Error: Yum refreshes repo metadata on every command.

Solution: edit /etc/rhsm/rhsm.conf to set ‘full_refresh_on_yum = 0’

Error: 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 NOTE ABOUT THE OPTION
Redirecting to /bin/systemctl start rhsmcertd.service.service
$ sudo subscription-manager status

Error: ‘This system is not registered with RHN Classic or Red Hat Satellite. You can use rhn_register to register. Red Hat Satellite or RHN Classic support will be disabled.‘

Solution: sudo sed -i ‘s/enabled=1/enabled=0/g’ /etc/yum/pluginconf.d/rhnplugin.conf

• See Red Hat solution article for details.

Error: Subscription manager, yum or related packages haven’t been upgraded for a long time and no longer work with the Satellite server.

• Example errors:
  • curl#35 – “Peer reports incompatible or unsupported protocol version.”
  • Plugin “search-disabled-repos” requires API 2.7. Supported API is 2.6.
  • [Errno 14] problem making ssl connection

Solution:

• Mount the latest RHEL ISO as a yum repo and yum upgrade everything with that.
• How to mount ISO as a yum repo: Red Hat solution article
• >See ISO download path above
• after you get the really old packages updated, communication should work fine with sat server

Error:

Unable to verify server's identity: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:618)
Loaded plugins: enabled_repos_upload, langpacks, package_upload, product-id, search-disabled-repos, subscription-manager
Error loading certificate: [Errno 2] No such file or directory: '/etc/pki/consumer/cert.pem'
Nothing to do
Uploading Enabled Repositories Report
Loaded plugins: langpacks, product-id, subscription-manager Error loading certificate: [Errno 2] No such file or directory: '/etc/pki/consumer/cert.pem'
Cannot upload enabled repos report, is this client registered?

Solution:

yum remove 'katello-ca-consumer*' -y
yum localinstall http://redhatsat.its.unc.edu/pub/katello-ca-consumer-latest.noarch.rpm -y

Error: Running the registration script (or the commands therein) produces this error:

HTTP error (400 - Bad Request): Organization ITS-Infrastructure does not exist.
Loaded plugins: enabled_repos_upload, package_upload, product-id, search-disabled-repos, subscription-manager
This system is not registered with an entitlement server. You can use subscription-manager to register.
Nothing to do
Uploading Enabled Repositories Report
Cannot upload enabled repos report, is this client registered?

Solution:

sudo yum remove katello-ca-consumer-redhatsat.its.unc.edu -y
sudo ./satellite-register-new.sh

Latest errata from Red Hat

RHEL 8 Errata