Chapter 9. Managing Activation Keys

1. Activation key with no subscriptions specified.

   With no subscriptions specified and auto-attach enabled, hosts using the activation key search for the best fitting subscription from the ones provided by Satellite Server. This is similar to entering the subscription-manager --auto-attach command.

2. Activation key providing a custom subscription pool for auto-attach.

   If there are subscriptions specified and auto-attach is enabled, hosts using the activation key select the best fitting subscription from the list specified in the activation key.

3. Activation key with the exact set of subscriptions.

   If there are subscriptions specified and auto-attach is disabled, hosts using the activation key are associated with all subscriptions specified in the activation key.

1. In the Satellite web UI, navigate to Content > Activation keys and click Create Activation Key.
2. In the Name field, enter the name of the activation key.
3. If you want to set a limit, clear the Unlimited hosts check box, and in the Limit field, enter the maximum number of systems you can register with the activation key. If you want unlimited hosts to register with the activation key, ensure the Unlimited Hosts check box is selected.
4. In the Description field, enter a description for the activation key.
5. From the Environment list, select the environment to use.
6. From the Content View list, select a Content View to use.
7. Click Save and when your new activation key appears in the Activation Keys window, click the name to edit.
8. To define which products to attach and repositories to enable upon registration, click the Subscriptions tab, select the subscriptions that you want to add, then click Add.
9. In the Satellite web UI, navigate to the Product Content page. For example, to enable the Red Hat Satellite Tools repository, for Red Hat Satellite Tools 6.4 (for RHEL 7 Server) (RPMs) - Enabled select Override to Yes.
10. Click Save.

For CLI Users

1. Create the activation key:

   # hammer activation-key create \
   --name "My_Activation_Key" \
   --unlimited-hosts \
   --description "Example Stack in the Development Environment" \
   --lifecycle-environment "Development" \
   --content-view "Stack" \
   --organization "My_Organization"

2. Obtain a list of your subscription IDs:

   # hammer subscription list --organization "My_Organization"

3. Attach the Red Hat Enterprise Linux subscription UUID to the activation key:

   # hammer activation-key add-subscription \
   --name "My_Activation_Key" \
   --subscription-id ff808181533518d50152354246e901aa \
   --organization "My_Organization"

4. List the product content associated with the activation key:

   # hammer activation-key product-content \
   --name "My_Activation_Key" \
   --organization "My_Organization"

5. Override the default auto-enable status for the Red Hat Satellite Tools 6.4 repository. The default status is set to disabled. To enable, enter the following command:

   # hammer activation-key content-override \
   --name "My_Activation_Key" \
   --content-label rhel-7-server-satellite-tools-6.4-rpms \
   --value 1 \
   --organization "My_Organization"

1. In the Satellite web UI, navigate to Content > Activation keys and click the name of the activation key.
2. Click the Subscriptions tab.
3. To remove subscriptions, select List/Remove, and then select the check boxes to the left of the subscriptions to be removed and then click Remove Selected.
4. To add subscriptions, select Add, and then select the check boxes to the left of the subscriptions to be added and then click Add Selected.
5. Click the Repository Sets tab and review the repositories' status settings.
6. To enable or disable a repository, select the check box for a repository and then change the status using the Select Action list.
7. Click the Details tab, select a Content View for this activation key, and then click Save.

For CLI Users

1. List the subscriptions that the activation key currently contains:

   # hammer activation-key subscriptions \
   --name My_Activation_Key \
   --organization "My_Organization"

2. Remove the required subscription from the activation key:

   # hammer activation-key remove-subscription \
   --name "My_Activation_Key" \
   --subscription-id ff808181533518d50152354246e901aa \
   --organization "My_Organization"

   For the --subscription-id option, you can use either the UUID or the ID of the subscription.

3. Attach new subscription to the activation key:

   # hammer activation-key add-subscription \
   --name "My_Activation_Key" \
   --subscription-id ff808181533518d50152354246e901aa \
   --organization "My_Organization"

   For the --subscription-id option, you can use either the UUID or the ID of the subscription.

4. List the product content associated with the activation key:

   # hammer activation-key product-content \
   --name "My_Activation_Key" \
   --organization "My_Organization"

5. Override the default auto-enable status for the required repository:

   # hammer activation-key content-override \
   --name "My_Activation_Key" \
   --content-label content_label \
   --value 1 \
   --organization "My_Organization"

   For the --value option, enter 1 for enable, 0 for disable.

1. Export the subscriptions from Satellite Server to a CSV file. For this example, a_keys.csv:

   # hammer --server https://satellite.example.com csv activation-keys \
   --export --file a_keys.csv --organization "My_Organization"

2. To view the columns of the file, enter the following command:

   # column -s, -t < a_keys.csv | less -S

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

4. Make a backup of the file.

   # cp a_keys.csv a_keys.csv.backup

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

   # sed -i "s/Automatic|RH1234|Red Hat Enterprise Linux Server/Automatic|RH4567|Red Hat Enterprise Linux Server/g" a_keys.csv

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

   # diff a_keys.csv a_keys.csv.backup

7. Upload the changed file to Satellite Server.

   # hammer --server https://satellite.example.com csv activation-keys \
   --file a_keys.csv

1. Download the consumer RPM for your Satellite Server. This is located in the pub directory on the host’s web server. For example, for a Satellite Server with the host name satellite.example.com, enter the following command on the host to register:

   # rpm -Uvh http://satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm

   This RPM installs the necessary certificates for accessing repositories on Satellite Server and configures Red Hat Subscription Manager to use the server’s URL.

2. On the host, enter the following command to register the host to Satellite using the activation key:

   # subscription-manager register --activationkey="My_Activation_Key" \
   --org="My_Organization"

3. To view a list of hosts for an organization, on Satellite Server, enter the following command:

   # hammer host list --organization "My_Organization"

4. After registering a host to Satellite Server, install the katello-agent package on the host so that it can report back to Satellite Server:

   # yum install katello-agent

   The Red Hat Satellite Tools 6.4 repository provides this package.

1. In the Satellite web UI, navigate to Content > Activation Keys.
2. Click the activation key name that you want to edit.
3. Click the Subscriptions tab.
4. Click the edit icon next to Auto-Attach.
5. Select or clear the check box to enable or disable auto-attach.
6. Click Save.

1. In the Satellite web UI, navigate to Content > Activation Keys.
2. Click the activation key name you want to edit.
3. Click the edit icon next to Service Level.
4. Select the required service level from the list. The list only contains service levels available to the activation key.
5. Click Save.