In Red Hat Satellite 6 satellite-installer failed with error "Check whether the katello-agent feature is enabled before upgrading: [FAIL]"

Solution Verified - Updated

Environment

  • Red Hat Satellite 6.14
  • Red Hat Satellite 6.15

Issue

  • While performing Red Hat Satellite upgrade from 6.14 to 6.15 got below error:

    Check whether the katello-agent feature is enabled before upgrading:  [FAIL]
The katello-agent feature is enabled on this system. As of Satellite 6.15, katello-agent is removed and will no longer function. Before proceeding with the upgrade, you should ensure that you have deployed and configured an alternative tool for remote package management and patching for content hosts, such as Remote Execution (REX) with pull-based transport. See the Managing Hosts guide in the Satellite documentation for more info. Disable katello-agent with the command `satellite-installer --foreman-proxy-content-enable-katello-agent false` before proceeding with the upgrade. Alternatively, you may skip this check and proceed by running satellite-maintain again with the `--whitelist` option, which will automatically uninstall katello-agent.

Resolution

  • The message Check whether the katello-agent feature is enabled before upgrading: [FAIL] is an expected message when katello-agent feature is still enabled on Red Hat Satellite 6.14 instance and trying to upgrade to Red Hat Satellite 6.15.

  • Katello-agent has been deprecated since Red Hat Satellite 6.13 onwards and in Red Hat Satellite 6.15 katello-agent feature is completely disabled\removed.

  • Hence simply disable the feature using the below command:

    # satellite-installer --foreman-proxy-content-enable-katello-agent false

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

  • When katello-agent feature is still enabled on Red Hat Satellite 6.14 instance and trying to upgrade to Red Hat Satellite 6.15 this error will occur.
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.