Chapter 8. Using Manifests

When you purchase a subscription, you receive a 16-digit subscription number. You then enter that number in the Customer Portal to redeem the subscription.

  • Specific details about a manifest including identity certificate and subscriptions allocated to it
  • Manage the subscriptions allocated to the manifest
Note

Manifests are now found in the Subscription Allocations section of RHSM.

8.1. Creating a new subscription allocation

Creating a new subscription allocation allows you to set aside subscriptions and entitlements for a system that is currently offline or air-gapped. This is necessary before you can download its manifest and upload it to a system.

Procedure

  1. From the Subscription Allocations page, click Create Manifest.
  2. Click New Subscription Allocation
  3. Enter a Name for the allocation so that you can find it later.
  4. Select the Type of subscription management application you plan to use on the system.
  5. Click Create.

8.2. Adding subscriptions to a subscription allocation

Once an allocation is created, you can add the subscriptions you need for the system to run properly once it goes online. This step is necessary before you can download the manifest and add it to the host system.

Procedure

  1. From the Subscription Allocations page, click the allocation to which you are adding subscriptions.
  2. Click the Subscriptions tab.
  3. Click Add Subscriptions.
  4. Enter the number of entitlements for each subscription you plan to add. Ensure that you are adding the correct number of entitlements for the system you are using.
  5. Click Submit.
Note
  • You can include future-dated subscriptions, or subscriptions that have a start date in the future, to an allocation.
  • You can filter out subscriptions that do not match the allocation type.

8.3. Downloading a manifest

Once an allocation is created and has the appropriate subscriptions on it, you can download the manifest from RHSM.

Procedure

  1. From the Subscription Allocations page, click the allocation to which you are adding subscriptions.
  2. Click the Subscriptions tab.
  3. Click Export Manifest.
Note

The file saves to your default downloads folder.

8.4. Uploading a manifest to a host system

A system needs a manifest to connect to RHSM. If you used a subscription allocation to create the manifest, you need to download the manifest first and then upload it to the host system. This situation is useful for systems that are offline or air-gapped.

Procedure

  1. On the local system, copy the manifest:

    # scp ~/<manifest_file>.zip subscription.rhsm.redhat.com:443/subscription
  2. Import the manifest to your system:

    # hammer subscription upload \
    --file ~/<manifest_file>.zip \
    --organization "ACME"