Running "foreman-maintain upgrade list-versions" does not list version on Satellite 6

Solution Verified - Updated

Environment

  • Red Hat Satellite 6
  • Red Hat Capsule 6

Issue

  • After updating rubygem-foreman_maintain to the latest version, foreman-maintain upgrade list-versions not showing any version to upgrade.

    # satellite-maintain upgrade list-versions
Checking for new version of rubygem-foreman_maintain...
Loaded plugins: product-id, subscription-manager
Nothing to update, can't find new version of rubygem-foreman_maintain.

    # satellite-maintain upgrade list-versions
ERROR: No such sub-command 'list-versions'

See: 'satellite-maintain upgrade --help'

Resolution

Below steps will solve an issue facing while upgrading the Satellite/Capsule server and not printing the version list.

  • Enable the set of repositories in the original version of your Satellite

  • Downgrade the package rubygem-foreman_maintain for the version based on your Satellite version. Please, check the table in Diagnostic Steps to be sure what version you should be downgrading to

    # foreman-maintain packages unlock
# yum downgrade <COPY/PASTE THE PACKAGE WITH VERSION HERE>

    The step above should be enough to fix your issue, and you can confirm with the command below. Assuming that you are seeing the current version, you are good to go and move on with the upgrade steps in our documentation.

    # foreman-maintain upgrade list-versions

    In case you are still facing issues, please, proceed with the next steps.

  • Update the rubygem-foreman_maintain package.

    # satellite-maintain packages update rubygem-foreman_maintain

  • Install the satellite package on the Satellite server:

    # satellite-maintain packages install satellite -y

  • Enable old version repositories and install the capsule package on the capsule server:

       # subscription-manager repos --disable "*"

   # subscription-manager repos --enable=rhel-7-server-rpms \
   --enable=rhel-7-server-satellite-capsule-6.7-rpms \
   --enable=rhel-7-server-satellite-maintenance-6-rpms \
   --enable=rhel-7-server-satellite-tools-6.7-rpms \
   --enable=rhel-server-rhscl-7-rpms \
   --enable=rhel-7-server-ansible-2.8-rpms

   # yum install satellite-capsule -y

  • Verify upgrade version list on Satellite/Capsule server:

    # foreman-maintain upgrade list-versions

  • If the above steps does not work, also see Foreman-maintain upgrade list-versions does not show next upgradable version in Red Hat Satellite 6 server

  • Also, Foreman-maintain upgrade list-versions does not show next upgradable version in Red Hat Satellite 6 server

  • Unset the release if set any.

     # subscription-manager release --unset

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

Root Cause

  • The installed package rubygem-foreman_maintain is too new for that specific version.

    • For example: when upgrading from 6.11 to 6.12, we expect to see the package in the version rubygem-foreman_maintain-1.1.14-1.el8sat.noarch.rpm, anything higher than that, tells us that the wrong repository was enabled, and the wrong version of the package was installed.

  • The package satellite-6.x.z.n-v.el7sat.noarch was missing on the Satellite server.

    • For example: satellite-6.3.5.2-1.el7sat.noarch on Satellite 6.3, satellite-6.4.4.2-1.el7sat.noarch on Satellite 6.4, satellite-6.5.3-1.el7sat.noarchon Satellite 6.5,satellite-6.6.0-7.el7sat.noarch` on Satellite 6.5.

  • The package satellite-capsule-6.x.z.n-v.el7sat.noarch was missing on the Capsule server.

    • For example: satellite-capsule-6.7.5-1.el7sat.noarch.

This issue is tracked in the bugzilla This content is not included.RFE: 1886031 - Satellite maintain should verify the presence of "satellite" or "satellite-capsule" package installed on the server as a pre-upgrade check

Diagnostic Steps

  • Here, you can see the version of the package rubygem-foreman_maintain for each Satellite version

    • Satellite 6.9 rubygem-foreman_maintain-0.8.31-1.el7sat.noarch.rpm
    • Satellite 6.10 rubygem-foreman_maintain-0.8.31-1.el7sat.noarch.rpm
    • Satellite 6.11 rubygem-foreman_maintain-1.0.19-1.el7sat.noarch.rpm or rubygem-foreman_maintain-1.0.19-1.el8sat.noarch.rpm
    • Satellite 6.12 rubygem-foreman_maintain-1.1.14-1.el8sat.noarch.rpm
    • Satellite 6.13 rubygem-foreman_maintain-1.2.12-1.el8sat.noarch.rpm
    • Satellite 6.14 rubygem-foreman_maintain-1.3.5-1.el8sat.noarch.rpm
    • Satellite 6.15 rubygem-foreman_maintain-1.4.5-1.el8sat.noarch.rpm
    • Satellite 6.16 rubygem-foreman_maintain-1.7.5-1.el8sat.noarch.rpm or rubygem-foreman_maintain-1.7.5-1.el9sat.noarch.rpm
    • Satellite 6.17 rubygem-foreman_maintain-1.10.3-1.el9sat.noarch.rpm
    • Satellite 6.18 rubygem-foreman_maintain-1.13.6-1.el9sat.noarch.rpm

  • Running rpm -qa |grep rubygem-foreman_maintain will show a version too ahead of the current and next version of your Satellite implementation

  • Running rpm -qa |grep satellite will not show the satellite package on the Satellite server

    # rpm -qa |grep satellite
satellite-common-6.7.5-1.el7sat.noarch
satellite-cli-6.7.5-1.el7sat.noarch 
satellite-installer-6.7.0.8-1.el7sat.noarch

  • And running rpm -qa |grep capsule will not show the capsule package on the Capsule server.

    # rpm -qa |grep capsule

  • Check if the release is set or not.:

    # subscription-manager release --show
SBR
Product(s)
Components
Category
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.