Chapter 4. Managing Subscriptions

Procedure

1. Open the Red Hat Customer Portal in your browser and log in to your Red Hat account.
2. Navigate to Subscriptions, which is in the upper-left corner of the Customer Portal page.
3. Click the Subscription Allocations tab.
4. Click New Subscription Allocation.
5. In the Name field, enter a descriptive name that helps identify the subscription allocation.
6. From the Type list, select the type and version that corresponds to your Satellite Server.
7. Click Create.
8. After a few minutes, the web UI reports that the allocation has been successfully created.

Procedure

1. Open the Red Hat Customer Portal in your browser and log in to your Red Hat account.
2. Navigate to Subscriptions, which is in the upper-left corner of the Customer Portal page.
3. Click the Subscription Allocations tab.
4. From the Name column, select the name of the subscription allocation you want to modify.
5. Click the Subscriptions tab, and then click Add Subscriptions.
6. On the row of each subscription you want to add, enter the quantity under the Entitlements column.
7. Click Submit.
8. If the modified subscription allocation has a corresponding subscription manifest on a Satellite Server, refresh the subscription manifest. For more information, see Section 4.2.5, “Updating and Refreshing Subscription Manifests”.

Procedure

1. Open the Red Hat Customer Portal in your browser and log in to your Red Hat account.
2. Navigate to Subscriptions, which is in the upper-left corner of the Customer Portal page.
3. Click the Subscription Allocations tab.
4. From the Name column, select the name of the subscription allocation you want to modify.
5. Click the Subscriptions tab.
6. On the row of each subscription you want to remove, select the corresponding check box.
7. Click Remove, and then confirm removal.
8. If the modified subscription allocation has a corresponding subscription manifest on a Satellite Server, refresh the subscription manifest. For more information, see Section 4.2.5, “Updating and Refreshing Subscription Manifests”.

Procedure

1. Open the Red Hat Customer Portal in your browser and log in to your Red Hat account.
2. Navigate to Subscriptions, which is in the upper-left corner of the Customer Portal page.
3. Click the Subscription Allocations tab.
4. From the Name column, select the name of the subscription allocation you want to modify.
5. Click the Subscriptions tab.
6. On the row of each subscription you want to move, select the corresponding check box.
7. Click Move to Another Allocation.

8. In the "Move entitlements from this subscription allocation to another" window, use the appropriate method to select the subscriptions you want to move:

   • If you want to select all subscriptions, select Move All Entitlements.
   • If you want to specify quantities, enter the appropriate quantity on the row of each subscription under the Quantity to Move column.
   • If you want to remove a subscription from the selection, click the delete icon on the row of that subscription, and then click OK to confirm.
9. Click Next: Select Destination Allocation.
10. From the table, select the subscription allocation you want to move the subscriptions to, and then click Submit.
11. If the modified subscription allocation has a corresponding subscription manifest on a Satellite Server, refresh the subscription manifest. For more information, see Section 4.2.5, “Updating and Refreshing Subscription Manifests”.

Procedure

1. Open https://access.redhat.com/ in your browser and log in to your Red Hat account.
2. Navigate to Subscriptions, which is in the upper-left corner of the Customer Portal page.
3. Click the Subscription Allocations tab.
4. From the Name column, select the name of the subscription allocation you want to export.
5. On the Details pane, click Export Manifest to download the subscription manifest file.

For Web UI Users

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 Red Hat Subscriptions page, click Manage Manifest.
4. In the Manage Manifest window, click Browse.
5. Navigate to the location containing the subscription manifest file, and then click Open.
6. If the Manage Manifest window does not close automatically, click Close to return to the Red Hat Subscriptions page.

1. Log in to your local client system, and then copy the subscription manifest file to your Satellite Server:

   [user@client ~]$ scp ~/manifest_file.zip root@satellite.example.com:~/.

2. In a terminal, connect to your 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"

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. On the Red Hat Subscriptions page, click the Search field to view the list search criteria for building your search query.
4. Select a search criteria to display further options.
5. When you have built your search query, click the search icon.

For Web UI Users

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. In a terminal, connect to your 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

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. On the Red Hat Subscriptions page, click Add Subscriptions.
4. On the row of each subscription you want to add, enter the quantity under the Quantity to Allocate column.
5. Click Submit.

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. On the row of each subscription you want to remove, select the corresponding check box.
4. Click Delete, and then confirm deletion.

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. On the Red Hat Subscriptions page, click Manage Manifest.
4. In the Manage Manifest window, click Refresh.

For Web UI Users

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. 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.

   1. Make a backup of the file:

      # cp content_hosts.csv content_hosts.csv.backup

   2. Edit the string you want to change. For example:

      # sed -i "s/1|RH1234|Red Hat Enterprise Linux Server/1|RH5678|Red Hat Enterprise Linux Server/g" content_hosts.csv

   3. Confirm only the required changes were made. For example:

      # diff content_hosts.csv content_hosts.csv.backup

3. Upload the changed file to Satellite Server:

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