Chapter 4. Managing Subscriptions

Red Hat Satellite 6 imports content from the Red Hat Content Delivery Network (CDN). Satellite 6 requires a Subscription Manifest to find, access, and download content from the corresponding repositories. You must have a Subscription Manifest containing a subscription allocation for each organization on Satellite 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 Subscription Manifest in the Customer Portal.

To create, manage, and export a Subscription Manifest in the Customer Portal, see Using Manifests in the Using Red Hat Subscription Management guide.

Use this chapter to import a Subscription Manifest and manage the manifest within the Satellite web UI.

Subscription Allocations and Organizations

You can manage more than one organization if you have more than one subscription allocation. Satellite 6 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 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 Section 4.6, “Attaching Subscriptions to Content Hosts”.

4.1. Importing a Subscription Manifest into Satellite Server

Use the following procedure to import a Subscription Manifest into Satellite Server.

Prerequisite

You must have a Subscription Manifest file exported from the Customer Portal. For more information, see Using Manifests in the Using Red Hat Subscription Management guide.

Procedure

To import a Subscription Manifest, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. In the Red Hat Subscriptions window, click Manage Manifest.
  4. In the Manage Manifest window, click Browse.
  5. Navigate to the location that contains the Subscription Manifest file, and then click Open. If the Manage Manifest window does not close automatically, click Close to return to the Red Hat Subscriptions window.

For CLI Users

  1. Copy the Subscription Manifest file to Satellite Server:

    [user@client ~]$ scp ~/manifest_file.zip root@satellite.example.com:~/.
  2. Connect to Satellite Server as the root user, and then import the Subscription Manifest file:

    [root@satellite ~]# hammer subscription upload \
    --file ~/manifest_file.zip \
    --organization "organization_name"

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

4.2. Locating a Subscription in the Satellite Web UI

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

Prerequisite

You must have a Subscription Manifest file imported to Satellite Server. For more information, see Section 4.1, “Importing a Subscription Manifest into Satellite Server”.

Procedure

To locate a subscription, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. In the Red Hat 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.

4.3. Adding Subscriptions to Subscription Allocations in the Satellite Web UI

Use the following procedure to add subscriptions to a subscription allocation in the Satellite web UI.

Prerequisite

You must have a Subscription Manifest file imported to Satellite Server. For more information, see Section 4.1, “Importing a Subscription Manifest into Satellite Server”.

Procedure

To add subscriptions to a subscription allocation, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. In the Red Hat 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.

4.4. Removing Subscriptions from Subscription Allocations in the Satellite Web UI

Use the following procedure to remove subscriptions from a subscription allocation in the Satellite web UI.

Note

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 content hosts will be removed.

Prerequisite

You must have a Subscription Manifest file imported to Satellite Server. For more information, see Section 4.1, “Importing a Subscription Manifest into Satellite Server”.

Procedure

To remove subscriptions, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. On the row of each subscription you want to remove, select the corresponding check box.
  4. Click Delete, and then confirm deletion.

4.5. Updating and Refreshing 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 Satellite web UI. Alternatively, you can import an updated manifest that contains the changes.

Procedure

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. In the Red Hat Subscriptions window, click Manage Manifest.
  4. In the Manage Manifest window, click Refresh.

4.6. Attaching 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 Section 4.7, “Bulk Updating Content Hosts' Subscriptions”.

For more information about activation keys, see Chapter 10, Managing Activation Keys.

Smart Management Subscriptions

In Satellite 6, you must maintain a Red Hat Enterprise Linux Smart Management subscription for every Red Hat Enterprise Linux host that you want to manage.

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

Prerequisite

You must have a Subscription Manifest file imported to Satellite Server.

Procedure

To attach subscriptions to content hosts, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Hosts > Content Hosts.
  3. On the row of each content host whose subscription you want to change, select the corresponding check box.
  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 check box 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.

For CLI Users

  1. Connect to Satellite 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

4.7. Bulk Updating Content Hosts' Subscriptions

Use this procedure for post-installation changes to multiple content hosts at the same time. You can use the Satellite web UI and the filter function to select the content hosts that you want to change, or use the Hammer CLI tool’s CSV file export function, edit the configuration settings in the CSV file, and upload the changes.

Procedure

To update multiple content hosts, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Hosts > Content Hosts.
  3. On the row of each content host whose subscription you want to change, select the corresponding check box.
  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 check box 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.

For CLI Users

  1. Export the current state of content hosts to a CSV file.

    # hammer --server https://satellite.example.com csv content-hosts --export --file content_hosts.csv
  2. Make a backup of the file:

    # cp content_hosts.csv content_hosts.csv.backup
  3. Change the required values in the CSV file. You can use an editor, with a CSV plug-in, or sed to change strings in the CSV file. For example:

    # sed -i "s/1|RH1234|Red Hat Enterprise Linux Server/1|RH5678|Red Hat Enterprise Linux Server/g" content_hosts.csv
  4. Confirm only the required changes were made. For example:

    # diff content_hosts.csv content_hosts.csv.backup
  5. Upload the changed file to Satellite Server:

    # hammer --server https://satellite.example.com csv content-hosts --file content_hosts.csv