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 on the Red Hat Hybrid Cloud Console.

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 manifest. When you add future-dated subscriptions to your manifest before the expiry date of the existing subscriptions, you can have uninterrupted access to repositories.
Subscriptions service: The Subscriptions service on the Red Hat Hybrid Cloud Console helps you track and manage Red Hat subscription usage across connected and disconnected systems. It collects usage data, displays trends in a centralized dashboard, and supports historical analysis for planning and compliance. For more information, see Tracking subscription usage by using the subscriptions service.

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.

Tracking subscription usage by using the Subscriptions service

You can configure your orcharhino Server to report usage data to the Red Hat Hybrid Cloud Console by using the foreman_rh_cloud plugin.

Prerequisites

Enable the foreman_rh_cloud plugin:
```
$ orcharhino-installer --enable-foreman-plugin-rh-cloud
```
Connected orcharhino

In the orcharhino management UI, navigate to Insights > Inventory Upload to configure the foreman_rh_cloud plugin and share inventory information with the Red Hat Hybrid Cloud Console. Ensure that the Automatic Inventory Upload setting is enabled. The plugin enables the subscriptions service to track usage information across connected systems.

You can configure the plugin to omit data that is not needed for subscription tracking, such as host names and IP addresses.

Disconnected orcharhino
Export usage data in one of the following ways:
Use the foreman_rh_cloud plugin to generate a report locally. You can download the report from the orcharhino management UI. The report is in JSON format and is easily integrated for automated scripts or machine processing. You can generate this report by using CLI:

$ foreman-rake rh_cloud_inventory:report:generate

View product usage by running the Host - Installed Products report.

Navigate to Monitor > Reports > Report Templates. You can select the format that you want for the report. YAML, JSON, HTML, and CSV formats are supported.

Importing a Red Hat subscription manifest into orcharhino Server

Import a Red Hat subscription manifest into orcharhino Server so that you can enable and synchronize Red Hat repositories.

Importing Red Hat subscription manifest by using orcharhino management UI

Prerequisites

You can import a Red Hat subscription manifest into orcharhino Server by using orcharhino management UI.

Prerequisites

You must have a Red Hat subscription manifest file. For more information, see Importing a Red Hat Subscription Manifest into Server.

Procedure

In the orcharhino management UI, ensure the context is set to the organization you want to use.
In the orcharhino management UI, navigate to Content > Subscriptions.
Click Manage Manifest.
In the Manage Manifest window, click Choose File.
Navigate to the location that contains the Red Hat subscription manifest file, then click Open.

Next steps

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

Importing Red Hat subscription manifest by using Hammer CLI

You can import a Red Hat subscription manifest into orcharhino Server by using Hammer CLI.

Prerequisites

You must have a Red Hat subscription manifest file. For more information, see Importing a Red Hat Subscription Manifest into Server.

Procedure

Copy the Red Hat subscription manifest file from your local machine to orcharhino Server:
```
$ scp ~/manifest_file.zip root@orcharhino.example.com:~/.
```
Log in to orcharhino Server over SSH as the root user.

Import the Red Hat subscription manifest file:

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

Next steps

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

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.

Prerequisites

You must have a Red Hat subscription manifest file imported to orcharhino Server. For more information, see Importing a Red Hat Subscription Manifest into Server.

Procedure

In the orcharhino management UI, ensure the context is set to the organization you want to use.
In the orcharhino management UI, navigate to Content > Subscriptions.
In the Subscriptions window, click the Search field to view the list of search criteria for building your search query.
Select search criteria to display further options.
When you have built your search query, click the search icon.

Additional resources

Searching and bookmarking in Administering orcharhino

Adding Red Hat subscriptions to subscription manifests

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

Prerequisites

You must have a Red Hat subscription manifest file imported to orcharhino Server. For more information, see Importing a Red Hat Subscription Manifest into Server.

Procedure

In the orcharhino management UI, ensure the context is set to the organization you want to use.
In the orcharhino management UI, navigate to Content > Subscriptions.
In the Subscriptions window, click Add Subscriptions.
On the row of each subscription you want to add, enter the quantity in the Quantity to Allocate column.
Click Submit

Removing Red Hat subscriptions from subscription manifests

Use the following procedure to remove Red Hat subscriptions from a subscription manifest 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.

Prerequisites

You must have a Red Hat subscription manifest file imported to orcharhino Server. For more information, see Importing a Red Hat Subscription Manifest into Server.

Procedure

In the orcharhino management UI, ensure the context is set to the organization you want to use.
In the orcharhino management UI, navigate to Content > Subscriptions.
On the row of each subscription you want to remove, select the corresponding checkbox.
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.

The orcharhino management UI provides a notification before the subscription manifest expires.

Procedure

In the orcharhino management UI, ensure the context is set to the organization you want to use.
In the orcharhino management UI, navigate to Content > Subscriptions.
In the Subscriptions window, click Manage Manifest.
In the Manage Manifest window, click Refresh.

Content Delivery Network structure

Information in this section only applies if you consume Red Hat content by using a Red Hat manifest.

Red Hat Content Delivery Network (CDN), located at cdn.redhat.com, is a geographically distributed series of static webservers which include content and errata designed to be used by systems. This content can be accessed directly through a system registered by using Subscription Manager or through the orcharhino management UI. The accessible subset of the CDN is configured through content available to a system by using Red Hat Subscription Management or by using orcharhino Server.

Red Hat Content Delivery network is protected by X.509 certificate authentication to ensure that only valid users can access it.

Example 1. Directory structure of the Red Hat CDN

$ tree -d -L 11
└── content
    ├── beta
    │   └── rhel
    │       └── server
    │           └── 7
    │               └── x86_64
    │                   └── sat-tools
    └── dist
        └── rhel
            └── server
                └── 7
                ├── 7.2
                │   └── x86_64
                │       └── kickstart
                └── 7Server
                    └── x86_64
                        └── os

content – Root directory for the content.
beta – Directory responsible for the lifecycle of the content. Common directories include beta (for Beta code), dist (for Production) and eus (For Extended Update Support) directories.
rhel – Directory responsible for the product name. Usually rhel for Red Hat Enterprise Linux.
server – Directory responsible for the type of the product. For Red Hat Enterprise Linux this might include server, workstation, and computenode directories.
7 – Directory responsible for the release version, such as 7, 7.2 or 7Server.
x86_64 – Directory responsible for the base architecture, such as i386 or x86_64.
sat-tools – Directory responsible for the repository name, such as sat-tools, kickstart, rhscl.

Some components have additional subdirectories which might vary.

This directory structure is also used in Red Hat subscription manifests.

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