Repository Red Hat Satellite Tools 6.9 not visible in registered Content Host

Solution Verified - Updated

Environment

  • Red Hat Satellite 6.9
  • Red Hat Enterprise Linux (RHEL) 6, 7, 8

Issue

  • In Red Hat Satellite 6.9 the repo Satellite Tools 6.9 is synced, enabled and added to the Content View

  • After promoting and publishing, the repo is not visible in registered Content Hosts

    After doing the actions:

    yum clean all
    rm -rf /var/cache/yum/*
    subscription-manager refresh
    yum repolist
    subscription-manager repos --list
    subscription-manager repos --list-enabled
    

    The repo still don't appear in the list of repos available to the Content Hosts

Resolution

  • Since the repo is disabled by default, enabling it in the Activation Key (AK) doesn't work on already registered content hosts, because the AK only takes place when a host is registered or re-registered to Satellite, so enabling the repo in the AK will have no effect

  • The way to enable the repo and make it visible in an already registered content host can be done through:

    • The Satellite Web UI:
      Hosts -> Content Hosts -> Select Hosts -> Select Action dropdown -> Manage repository sets, and there enable the Satellite Tools 6.9.

    • Via hammer command:
      hammer host subscription content-override --host hostname_fqdn --content-label satellite-tools-6.9-for-rhel-{7|8}-x86_64-rpms --override-name enabled --value true

      In this way Candlepin override the state of the repo, for the next time a subscription-manager refresh will be launched

  • In Red Hat Enterprise Linux 7.9 and >=8.3:

    • At last, need to launch a subscription-manager refresh --force, on the Content Hosts (via Remote Execution or Ansible, the --force option regenerates the entitlement certificates even if don't find any change in the repos, without he --force will not see the repo available)
  • In Red Hat Enterprise Linux < 7.9 and < 8.3:

    • The releases of Red Hat Enterprise Linux < 7.9 doesn't have a subscription-manager refresh --force, but in this releases the susbcription-manager refresh command always launch a --force by default, so a subscription-manager refresh will be enough
  • Red Hat is aware of this issue and is working on enhancing a future version of Red Hat Satellite. This is due to a bug in Candlepin, can see the bugzilla This content is not included.BZ#1972501

Workaround:

  • Another way to view the repo is to re-register the hosts, in this way the updated information from the AK is applied to the host.

For more KB articles/solutions related to Red Hat Satellite 6.x Repository Issues, please refer to the Red Hat Satellite Consolidated Troubleshooting Article for Red Hat Satellite 6.x Repository Issues.

Diagnostic Steps

  • Verify Red Hat Satellite has not enabled Simple Content Access in the manifest, because if it's enabled this can be the following This content is not included.BZ#1924844

    That can be resolved installing the errata RHSA-2021:4702

  • Verify the repo is enabled, synced and is available in the last Content View promoted and published to the Content Hosts

  • Verify different options of subcription-manager sub-commands, and if this takes effect in the list of repos available from the content hosts

  • A subcription-manager refresh doesn't takes any effect in the list of repos available from the Content Hosts

SBR
Category

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.