Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
Chapter 2. Managing Red Hat subscriptions
You can import content from the Red Hat Content Delivery Network (CDN) into Red Hat Satellite by using a Red Hat subscription manifest. Manage your subscription allocations to ensure each organization can access and download Red Hat repositories.
A Red Hat subscription manifest contains the information about the subscriptions purchased from Red Hat. Satellite uses the information in the manifest to access the Red Hat CDN and find what repositories are available for the associated subscription.
You must have a Red Hat subscription manifest containing a subscription allocation for each organization in Satellite. All subscription information is available on the Red Hat Hybrid Cloud Console.
- Subscription allocations and organizations
- You can manage more than one organization if you have more than one subscription allocation. Satellite requires a single allocation for each organization configured in Satellite 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.
Additional resources
2.1. Tracking subscription usage by using the Subscriptions service Link kopierenLink in die Zwischenablage kopiert!
You can configure your Satellite Server to report usage data to the Red Hat Hybrid Cloud Console. Track and manage your subscription usage to analyze historical trends for planning and compliance.
- Connected Satellite
In the Satellite web UI, navigate to Red Hat Lightspeed > Inventory Upload to configure the
foreman_rh_cloudplugin 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 Satellite
Export usage data in one of the following ways:
Use the
foreman_rh_cloudplugin to generate a report locally. You can download the report from the Satellite web 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:generateView 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.
2.2. Importing Red Hat subscription manifests into Satellite Link kopierenLink in die Zwischenablage kopiert!
You can import a Red Hat subscription manifest into Satellite to provide subscription allocation to your organization in Satellite.
Simple Content Access (SCA) is set on the organization, not the manifest. Importing a manifest does not change your organization’s Simple Content Access status.
Simple Content Access simplifies the subscription experience for administrators.
Additional resources
2.2.1. Obtaining a Red Hat subscription manifest Link kopierenLink in die Zwischenablage kopiert!
You can create and export a Red Hat subscription manifest to prepare subscriptions for import into Satellite.
Procedure
If your Satellite is connected, use the Red Hat Hybrid Cloud Console to create and export the manifest. For more information, see Creating and managing manifests for a connected Satellite Server in Subscription Central.
This manifest does not yet contain any subscriptions. After you import the manifest into Satellite, add subscriptions to the manifest in Satellite.
If your Satellite is disconnected, use the Red Hat Customer Portal to create and export the manifest. For more information, see Creating and managing manifests for a disconnected Satellite Server in Subscription Central.
This manifest already contains subscriptions.
2.2.2. Importing a Red Hat subscription manifest by using Satellite web UI Link kopierenLink in die Zwischenablage kopiert!
You can import a Red Hat subscription manifest into Satellite Server by using Satellite web UI. Import the manifest so that you can enable and synchronize Red Hat repositories in your organization.
Prerequisites
- You have a Red Hat subscription manifest file. For more information, see Section 2.2.1, “Obtaining a Red Hat subscription manifest”.
Procedure
- In the Satellite web UI, ensure the context is set to the organization you want to use.
- 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
- If you use the manifest from the Red Hat Hybrid Cloud Console, add subscriptions to the manifest. For more information, see Section 2.4, “Adding Red Hat subscriptions to subscription manifests”.
2.2.3. Importing a Red Hat subscription manifest by using Hammer CLI Link kopierenLink in die Zwischenablage kopiert!
You can import a Red Hat subscription manifest into Satellite Server by using Hammer CLI. Import the manifest so that you can enable and synchronize Red Hat repositories in your organization.
Prerequisites
- You have a Red Hat subscription manifest file. For more information, see Section 2.2.1, “Obtaining a Red Hat subscription manifest”.
Procedure
Copy the Red Hat subscription manifest file from your local machine to Satellite Server:
$ scp ~/manifest_file.zip root@satellite.example.com:~/.-
Log in to Satellite Server over SSH as the
rootuser. Import the Red Hat subscription manifest file:
$ hammer subscription upload \ --file ~/manifest_file.zip \ --organization "My_Organization"
Next steps
- If you use the manifest from the Red Hat Hybrid Cloud Console, add subscriptions to the manifest. For more information, see Section 2.4, “Adding Red Hat subscriptions to subscription manifests”.
2.3. Locating a Red Hat subscription Link kopierenLink in die Zwischenablage kopiert!
You can locate specific Red Hat subscriptions in your Satellite by filtering the results on the Subscriptions page to navigate a high volume of subscriptions.
Prerequisites
- A Red Hat subscription manifest is imported to Satellite. For more information, see Section 2.2, “Importing Red Hat subscription manifests into Satellite”.
Procedure
- In the Satellite web UI, ensure the context is set to the organization you want to use.
- In the Satellite web 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
2.4. Adding Red Hat subscriptions to subscription manifests Link kopierenLink in die Zwischenablage kopiert!
You can add Red Hat subscriptions to your subscription manifest in Satellite to allocate entitlements to Red Hat content in your organization.
If you have exported a new subscription manifest from the Red Hat Hybrid Cloud Console, you have to populate the manifest with subscriptions. Such a manifest does not initially contain any subscriptions.
Prerequisites
- A Red Hat subscription manifest is imported to Satellite. For more information, see Section 2.2, “Importing Red Hat subscription manifests into Satellite”.
Procedure
- In the Satellite web UI, ensure the context is set to the organization you want to use.
- Navigate to Content > Subscriptions.
- On the Subscriptions page, click Add Subscriptions.
- On the row of each subscription you want to add, enter the quantity in the Quantity to Allocate column.
- Click Submit.
2.5. Removing Red Hat subscriptions from subscription manifests Link kopierenLink in die Zwischenablage kopiert!
You can remove Red Hat subscriptions from manifests to adjust entitlement allocations or decommission Red Hat products from your organization.
Manifests must not be deleted. If you delete the manifest from the Red Hat Customer Portal or in the Satellite web UI, all of the entitlements for all of your hosts will be removed.
Prerequisites
- A Red Hat subscription manifest is imported to Satellite. For more information, see Section 2.2, “Importing Red Hat subscription manifests into Satellite”.
Procedure
- In the Satellite web UI, ensure the context is set to the organization you want to use.
- Navigate to Content > Subscriptions.
- On the row of each subscription you want to remove, select the corresponding checkbox.
- Click Delete, and then confirm deletion.
2.6. Updating and refreshing Red Hat subscription manifests Link kopierenLink in die Zwischenablage kopiert!
You can refresh your Red Hat subscription manifests to keep your subscription allocations up to date. Refresh your manifests after renewing, adjusting, or purchasing subscriptions to ensure accurate entitlements in your Satellite.
Every time 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 Satellite web UI. Alternatively, you can import an updated manifest that contains the changes.
The Satellite web UI provides a notification before the subscription manifest expires.
Prerequisites
- A Red Hat subscription manifest is imported to Satellite. For more information, see Section 2.2, “Importing Red Hat subscription manifests into Satellite”.
Procedure
- In the Satellite web UI, ensure the context is set to the organization you want to use.
- Navigate to Content > Subscriptions.
- On the Subscriptions page, click Manage Manifest.
- In the Manage Manifest window, click Refresh.
Additional resources
2.7. Red Hat CDN structure Link kopierenLink in die Zwischenablage kopiert!
The Red Hat Content Delivery Network (CDN) is a geographically distributed series of static web servers providing Red Hat software. You can access this content directly through Subscription Manager or Satellite Server.
The Red Hat CDN is located at cdn.redhat.com. Satellite and Subscription Manager configure which content is accessible to your hosts based on your subscription entitlements. Satellite must authenticate to the Red Hat CDN by using X.509 certificate authentication. The certificate is part of a subscription manifest.
Example 2.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 includebeta(for Beta code),dist(for Production) andeus(For Extended Update Support) directories. -
rhel– Directory responsible for the product name. Usuallyrhelfor Red Hat Enterprise Linux. -
server– Directory responsible for the type of the product. For Red Hat Enterprise Linux this might includeserver,workstation, andcomputenodedirectories. -
7– Directory responsible for the release version, such as7,7.2or7Server. -
x86_64– Directory responsible for the base architecture, such asi386orx86_64. -
sat-tools– Directory responsible for the repository name, such assat-tools,kickstart,rhscl.
Some components have additional subdirectories which might vary.
This directory structure is also used in Red Hat subscription manifests.