Satellite upgrade check command is printing "Please run 'foreman-maintain prep-6.10-upgrade' prior to upgrading."

Environment

• Red Hat Satellite 6.5
• Red Hat Satellite 6.6
• Red Hat Satellite 6.7
• Red Hat Satellite 6.8
• Red Hat Satellite 6.9 (for minor release version upgrade)

Issue

• While performing Satellite Upgrade using satellite-maintain Tool, below message is always printing:

     # satellite-maintain upgrade check --target-version 6.x
  
     Please run 'foreman-maintain prep-6.10-upgrade' prior to upgrading.
  

Resolution

• In order to prevent this problem from happening, The current workaround is a two-step approach.

  • Downgrade the version of rubygem-foreman_maintain package to 0.7.14-1..

    # yum downgrade rubygem-foreman_maintain-0.7.14-1.el7sat.noarch
    

  • Run upgrade specific commands using --disable-self-upgrade flag along with satellite-maintain tool:

    # satellite-maintain upgrade check --target-version 6.x --disable-self-upgrade
    # satellite-maintain upgrade run --target-version 6.x --disable-self-upgrade
    

    • Replace 6.x with the appropriate version. (For example 6.7 or 6.7.z or 6.8 or 6.8.z)

• This issue is being tracked under This content is not included.Bugzilla #2024269. In case of further concerns, reach out to This content is not included.Red Hat Technical Support for further assistance with the investigation.

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.

Diagnostic Steps

• Run below commands to verify rubygem-foreman_maintain version and installed date

  
     # rpm -qa --last |grep rubygem-foreman_maintain
  
  

• Even not using --disable-self-upgrade will also upgrade rubygem-foreman_maintain package:

     # satellite-maintain upgrade check --target-version 6.8
  
     Checking for new version of satellite-maintain...
     
     rubygem-foreman_maintain.noarch                                                                         1:0.8.20-1.el7sat                                                                          rhel-7-server-satellite-maintenance-6-rpms
  
     Updating satellite-maintain package.
  
     The satellite-maintain package successfully updated.
     Re-run satellite-maintain with required options!
  

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.