Managing Red Hat Subscriptions

orcharhino can import content from the Red Hat Content Delivery Network (CDN). orcharhino requires a Red Hat Subscription Manifest to find, access, and download content from the corresponding repositories. You must have a Red Hat Subscription Manifest containing a subscription allocation for each organization on orcharhino Server. All subscription information is available in your Red Hat Customer Portal account.

Before you can complete the tasks in this chapter, you must create a Red Hat Subscription Manifest in the Customer Portal.

Use this chapter to import a Red Hat Subscription Manifest and manage the manifest within the orcharhino management UI.

Subscription Allocations and Organizations

You can manage more than one organization if you have more than one subscription allocation. orcharhino requires a single allocation for each organization configured in orcharhino Server. The advantage of this is that each organization maintains separate subscriptions so that you can support multiple organizations, each with their own Red Hat accounts.

Future-Dated subscriptions

You can use future-dated subscriptions in a subscription allocation. When you add future-dated subscriptions to content hosts before the expiry date of the existing subscriptions, you can have uninterrupted access to repositories.

Manually attach the future-dated subscriptions to your content hosts before the current subscriptions expire. Do not rely on the auto-attach method because this method is designed for a different purpose and might not work. For more information, see Attaching Red Hat Subscriptions to Content Hosts.

Additional resources

Running Red Hat Enterprise Linux on managed hosts requires a subscription from Red Hat. Ensure to provide valid licenses for all used Red Hat products. Using insufficient, invalid, or otherwise inadequate licenses might violate your terms with Red Hat.

We recommend using a Manifest file from your Red Hat account to import available content to orcharhino. Navigate to Content > Subscriptions to see available and consumed Red Hat subscriptions.

Importing a Red Hat Subscription Manifest into orcharhino Server

Use the following procedure to import a Red Hat Subscription Manifest into orcharhino Server.

Prerequisites
Procedure
  1. In the orcharhino management UI, ensure the context is set to the organization you want to use.

  2. In the orcharhino management UI, navigate to Content > Subscriptions and click Manage Manifest.

  3. In the Manage Manifest window, click Browse.

  4. Navigate to the location that contains the Red Hat Subscription Manifest file, then click Open. If the Manage Manifest window does not close automatically, click Close to return to the Subscriptions window.

CLI procedure
  1. Copy the Red Hat Subscription Manifest file from your client to orcharhino Server:

    $ scp ~/manifest_file.zip root@orcharhino.example.com:~/.
  2. Log in to orcharhino Server as the root user and import the Red Hat Subscription Manifest file:

    # hammer subscription upload \
    --file ~/manifest_file.zip \
    --organization "My_Organization"

You can now enable repositories and import Red Hat content. For more information, see Importing Content in Managing Content.

If you upload a Red Hat Manifest to orcharhino, ensure that it does not enable Simple Content Access (SCA). Otherwise, all content hosts automatically consume all repositories published within their selected content view and lifecycle environment. This affects not only RHEL content, but also content for all other operating systems.

Simple Content Access for Red Hat Subscription Management

Disabling Simple Content Access

You can disable simple content access (SCA) for organizations.

Prerequisite
  • You have uploaded a Red Hat Manifest file into orcharhino and enabled SCA. The button to disable SCA is only visible if SCA is enabled.

Procedure
  1. Navigate to Administer > Organizations.

  2. Select an organization.

  3. On the Primary tab, deselect Simple Content Access.

  4. Click Submit to save your change.

Locating a Red Hat Subscription

When you import a Red Hat Subscription Manifest into orcharhino Server, the subscriptions from your manifest are listed in the Subscriptions window. If you have a high volume of subscriptions, you can filter the results to find a specific subscription.

Prerequisite
Procedure
  1. In the orcharhino management UI, ensure the context is set to the organization you want to use.

  2. In the orcharhino management UI, navigate to Content > Subscriptions.

  3. In the Subscriptions window, click the Search field to view the list of search criteria for building your search query.

  4. Select search criteria to display further options.

  5. When you have built your search query, click the search icon.

For example, if you place your cursor in the Search field and select expires, then press the space bar, another list appears with the options of placing a >, <, or = character. If you select > and press the space bar, another list of automatic options appears. You can also enter your own criteria.

Adding Red Hat Subscriptions to Subscription Allocations

Use the following procedure to add Red Hat subscriptions to a subscription allocation in the orcharhino management UI.

Prerequisite
Procedure
  1. In the orcharhino management UI, ensure the context is set to the organization you want to use.

  2. In the orcharhino management UI, navigate to Content > Subscriptions.

  3. In the Subscriptions window, click Add Subscriptions.

  4. On the row of each subscription you want to add, enter the quantity in the Quantity to Allocate column.

  5. Click Submit

Removing Red Hat Subscriptions from Subscription Allocations

Use the following procedure to remove Red Hat subscriptions from a subscription allocation in the orcharhino management UI.

Manifests must not be deleted. If you delete the manifest from the Red Hat Customer Portal or in the orcharhino management UI, all of the entitlements for all of your content hosts will be removed.

Prerequisite
Procedure
  1. In the orcharhino management UI, ensure the context is set to the organization you want to use.

  2. In the orcharhino management UI, navigate to Content > Subscriptions.

  3. On the row of each subscription you want to remove, select the corresponding checkbox.

  4. Click Delete, and then confirm deletion.

Updating and Refreshing Red Hat Subscription Manifests

Every time that you change a subscription allocation, you must refresh the manifest to reflect these changes. For example, you must refresh the manifest if you take any of the following actions:

  • Renewing a subscription

  • Adjusting subscription quantities

  • Purchasing additional subscriptions

You can refresh the manifest directly in the orcharhino management UI. Alternatively, you can import an updated manifest that contains the changes.

Procedure
  1. In the orcharhino management UI, ensure the context is set to the organization you want to use.

  2. In the orcharhino management UI, navigate to Content > Subscriptions.

  3. In the Subscriptions window, click Manage Manifest.

  4. In the Manage Manifest window, click Refresh.

Attaching Red Hat Subscriptions to Content Hosts

Using activation keys is the main method to attach subscriptions to content hosts during the provisioning process. However, an activation key cannot update an existing host. If you need to attach new or additional subscriptions, such as future-dated subscriptions, to one host, use the following procedure.

For more information about updating multiple hosts, see Updating Red Hat Subscriptions on Multiple Hosts. For more information about activation keys, see Managing Activation Keys.

orcharhino Subscriptions

In orcharhino, you must maintain a Red Hat Enterprise Linux orcharhino subscription, formerly known as Red Hat Enterprise Linux Smart Management, for every Red Hat Enterprise Linux host that you want to manage.

However, you are not required to attach orcharhino subscriptions to each content host. orcharhino subscriptions cannot attach automatically to content hosts in orcharhino because they are not associated with any product certificates. Adding a orcharhino subscription to a content host does not provide any content or repository access. If you want, you can add a orcharhino subscription to a manifest for your own recording or tracking purposes.

Prerequisite
  • You must have a Red Hat Subscription Manifest file imported to orcharhino Server.

Procedure
  1. In the orcharhino management UI, ensure the context is set to the organization you want to use.

  2. In the orcharhino management UI, navigate to Hosts > Content Hosts.

  3. On the row of each content host whose subscription you want to change, select the corresponding checkbox.

  4. From the Select Action list, select Manage Subscriptions.

  5. Optionally, enter a key and value in the Search field to filter the subscriptions displayed.

  6. Select the checkbox to the left of the subscriptions that you want to add or remove and click Add Selected or Remove Selected as required.

  7. Click Done to save the changes.

CLI procedure
  1. Connect to orcharhino Server as the root user, and then list the available subscriptions:

    # hammer subscription list \
    --organization-id 1
  2. Attach a subscription to the host:

    # hammer host subscription attach \
    --host host_name \
    --subscription-id subscription_id

Updating Red Hat Subscriptions on Multiple Hosts

Use this procedure for post-installation changes to multiple content hosts at the same time.

Procedure
  1. In the orcharhino management UI, ensure the context is set to the organization you want to use.

  2. In the orcharhino management UI, navigate to Hosts > Content Hosts.

  3. On the row of each content host whose subscription you want to change, select the corresponding checkbox.

  4. From the Select Action list, select Manage Subscriptions.

  5. Optionally, enter a key and value in the Search field to filter the subscriptions displayed.

  6. Select the checkbox to the left of the subscriptions to be added or removed and click Add Selected or Remove Selected as required.

  7. Click Done to save the changes.

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution–Share Alike 3.0 Unported ("CC-BY-SA") license. This page also contains text from the official Foreman documentation which uses the same license ("CC-BY-SA").