Non Red Hat packages create issues during the upgrade for Red Hat Satellite or Capsule

Solution Verified - Updated

Environment

  • Red Hat Satellite 6.7 and above.
  • Red Hat Satellite Capsule 6.7 and above.

Issue

  • How to check if the Red Hat Satellite Server or Capsule Server has non-Red Hat packages installed?

  • While upgrading the Satellite server and the Capsule Server foreman_proxy service is failing.

        /Stage[main]/Foreman_proxy::Service/Service[foreman-proxy]/ensure: change from 'stopped' to 'running' failed: Systemd start for foreman-proxy failed!
journalctl log for foreman-proxy:
   -- Logs begin at Tue 2020-05-19 14:03:57 EDT, end at Mon 2020-07-06 17:13:17 EDT. --
   Jul XX XX:YY:ZZ satellite.example.com systemd[1]: Starting Foreman Proxy...
   Jul XX XX:YY:ZZ satellite.example.com smart-proxy[6426]: /usr/share/gems/gems/bundler_ext-0.4.1/lib/bundler_ext/output.rb:13:in `strict_err': Gem loading    error: Could not find 'rack' (~> 1.5) among 44 total gem(s) (RuntimeError)

  • Multiple third-party packages are installed on the Satellite server in which cntlm package is installed from the upstream repository. 

    ganglia-3.7.2-33.el7.x86_64 Fedora Project
nmon-16g-3.el7.x86_64 Fedora Project
libconfuse-2.7-7.el7.x86_64 Fedora Project

  • Dependency Issues during the upgrade for the Red Hat Satellite Server. 

    --> Finished Dependency Resolution
Error: Package: libpmem-devel-1.1-1.el7.x86_64 (epel)
        Requires: libpmem = 1.1-1.el7
        Installed: libpmem-1.5.1-2.1.el7.x86_64 (@rhel-7-server-rpms)
            libpmem = 1.5.1-2.1.el7
        Available: libpmem-1.1-1.el7.x86_64 (peel)

Resolution

  • Before the upgrade, run the command to check if the Satellite server has any 3rd Party (Non-Red Hat) packages present.
    [Note: To run the above command check if the Satellite has the package: rubygem-foreman_maintain-0.8.7-1.el7sat.noarch ] 

     # satellite-maintain health check --label non-rh-packages

  • With the This content is not included.RFE in place the Satellite server or the Capsule server will automatically check this step if there are any 3rd party packages or any Non-Red Hat packages are present.

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

  • Due to 3rd party packages or any upstream version or community packages on the Satellite server leads to the upgrade failure.
  • Since Red Hat Satellite and Capsule is only tested with all the Red Hat Shipped packages, it is recommended to have this check done. This check will be a part of the automatic upgrade check as well once the RFE is released.
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.