[Satellite 6] Unable to attach 'Red Hat Satellite Infrastructure Subscription' to Red Hat Satellite 6.x server

Solution Verified - Updated

Environment

  • Red Hat Satellite 6.3, or later.

Issue

Unable to attach Red Hat Satellite Infrastructure Subscription to Red Hat Satellite 6.3+ server, even though the Red Hat Satellite Infrastructure Subscription entitlements are visible in Satellite's web UI under Content -> Subscriptions.

Resolution

First, we need to release one of the Red Hat Satellite Infrastructure Subscription entitlements from the subscription allocation (or manifest) utilized by the Satellite server. In order to do that, here are the steps:

  1. Login to your Red Hat Customer Portal account.

  2. At the top left, click on Subscriptions.

  3. Click on Subscription Allocations.

  4. Click on name of the subscription allocation utilized by your Satellite server.

  5. Click on the Subscriptions tab.

  6. Decrease the number of Red Hat Satellite Infrastructure Subscription entitlements included in the subscription allocation by 1.

  7. Now, login to your Satellite's web UI.

  8. Navigate to Content -> Subscriptions -> Manage Manifests, and click on the Refresh Manifest button. Wait till the manifest refresh task completes successfully.

Now that the manifest refresh is complete, we can proceed with attaching the released Red Hat Satellite Infrastructure Subscription entitlement to the Satellite server, by following these steps:

  • Identify the Pool ID of the Red Hat Satellite Infrastructure Subscription by running the following command on the Satellite server:
# subscription-manager list --all --available --matches 'Red Hat Satellite Infrastructure Subscription'

  • Make a note of the subscription Pool ID.

  • Attach the Red Hat Satellite Infrastructure Subscription to the base system that your Satellite Server is running on, by running the following command:

# subscription-manager attach --pool=pool_id

where pool_id is the pool ID identified from the previous steps.

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

Root Cause

The Red Hat Satellite Infrastructure Subscription entitlements are included in the subscription allocation (or manifest) utilized by the Satellite server. Subscription entitlements included in the subscription allocation utilized by the Satellite server are no longer available for attachment to systems that need to be registered to the red Hat Customer Portal. They are only available to systems which are registered to the Satellite server. Since the Satellite server itself needs to be registered to the Red Hat Customer Portal, and cannot be registered to itself since version 6.3 of the product, one of the Red Hat Satellite Infrastructure Subscription entitlements need to be released from this subscription allocation, so that it can be attached to the Satellite server.

Diagnostic Steps

Running the following command as root on the Satellite server returns the output shown below:

# subscription-manager list --all --available --matches 'Red Hat Satellite Infrastructure Subscription'
No available subscription pools were found matching the expression "Red Hat Satellite Infrastructure Subscription".
SBR
Product(s)
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.