Blocking etcd 3.3 from being installed from Satellite

Solution Verified - Updated

Environment

  • Satellite 6.x
  • OpenShift Container Platform 3.x

Issue

  • Satellite has synced etcd-3.3.11-2.el7 for rhel-7-server-extras-rpms repository
  • etcd 3.3 is not supported with OpenShift Container Platform, but Satellite shows it as an update for my cluster nodes

Resolution

Add etcd-3.3* to the /etc/yum.conf exclude list on each OpenShift master node. The following command can be used on each system:

sed -i '/^exclude=/ s/$/ etcd-3.3*/' /etc/yum.conf

This will block yum from trying to install etcd-3.3.11-2.el7 on the system.

In the future a new etcd-3.2.x package will obsolete etcd-3.3.11-2.el7, and this exclude will no longer be needed.

OR

On satellite 6

Setup content view filter to exclude the package
How do content filters work in Satellite 6?

OR

Consult wit tech support possibility of deletion of rpm from repository.

Root Cause

OpenShift 3.x has not been qualified by Red Hat to operate using either the etcd 3.3 server or a etcd 3.3 datastore. Due to a mislabelling of artifacts internal to Red Hat, etcd 3.3 was released in RPM and Container Image format for a short time, more information on the incident can be found in the following etcd Incident Response article.

Diagnostic Steps

Check if Satellite is providing the etcd-3.3.11-2.el7 package by running the following commands on an OpenShift node connected to the Satellite:

# yum clean metadata; yum list etcd
Loaded plugins: product-id, search-disabled-repos, subscription-manager
Cleaning repos: rhel-7-server-extras-rpms rhel-7-server-rh-common-rpms
              : rhel-7-server-rpms
21 metadata files removed
3 sqlite files removed
0 metadata files removed
Loaded plugins: product-id, search-disabled-repos, subscription-manager
rhel-7-server-extras-rpms                                | 2.0 kB     00:00     
rhel-7-server-rh-common-rpms                             | 2.1 kB     00:00     
rhel-7-server-rpms                                       | 2.0 kB     00:00     
(1/9): rhel-7-server-extras-rpms/x86_64/updateinfo         | 189 kB   00:00     
(2/9): rhel-7-server-extras-rpms/x86_64/group              |  130 B   00:00     
(3/9): rhel-7-server-extras-rpms/x86_64/primary            | 280 kB   00:00     
(4/9): rhel-7-server-rh-common-rpms/7Server/x86_64/group   |  130 B   00:00     
(5/9): rhel-7-server-rh-common-rpms/7Server/x86_64/updatei |  32 kB   00:00     
(6/9): rhel-7-server-rh-common-rpms/7Server/x86_64/primary |  66 kB   00:00     
(7/9): rhel-7-server-rpms/7Server/x86_64/group             | 595 kB   00:00     
(8/9): rhel-7-server-rpms/7Server/x86_64/updateinfo        | 2.9 MB   00:00     
(9/9): rhel-7-server-rpms/7Server/x86_64/primary           |  47 MB   00:01     
rhel-7-server-extras-rpms                                             1067/1067
rhel-7-server-rh-common-rpms                                            235/235
rhel-7-server-rpms                                                  23716/23716
Installed Packages
etcd.x86_64               3.2.22-1.el7                @rhel-7-server-extras-rpms
Available Packages
etcd.x86_64               3.3.11-2.el7                rhel-7-server-extras-rpms 

This shows that the etcd-3.3.11-2.el7 is available and need to be excluded.

Components
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.