Chapter 8. Managing Activation Keys

For Web UI Users

1. Navigate to Content → Activation keys and click Create Activation Key. Provide the activation key with the following information:

   • Name - The name of the activation key. We use this name during the system registration process. In the Name field, type development-stack.
   • Limit - Defines the maximum number of systems you can register with the activation key. Select the Unlimited Hosts check box.
   • Description - A plain text description for the activation key. In the Description field, type Exampleware Stack in the Development Environment.
   • Environment - The environment to use. In the Environment area, select Development.
   • Content View - The Content View (and, by extension, the repository) in the environment to use. From the Content View list, select Stack.

   Click Save. The activation key details screen displays.

2. To define which products to attach and repositories to enable upon registration, navigate to the Subscriptions tab. Click Add, select both the Red Hat Enterprise Linux subscription and the PostgreSQL product, and click Add Selected.

   Note

   The Auto-Attach option is enabled. This automatically attaches these products to the system upon registration and enables the required repositories. If Auto-Attach is disabled for the activation key, the system only registers to Satellite Server without attaching any subscriptions or content.

3. Navigate to the Product Content page. As default, Satellite Server only enables:

   • The repository that best matches the system requirements. In this case, it is only the Red Hat Enterprise Linux 7 Server RPMs.
   • Any custom content.

   Our scenario must have the following defaults set:

   PostgreSQL:

   • PostgreSQL 9.5 - Enabled: Yes (Default)
   • PostgreSQL Puppet Modules - Enabled: Yes (Default)

   Red Hat Enterprise Linux Server:

   • Red Hat Enterprise Linux 7 Server (Kickstart) - Enabled: No (Default)
   • Red Hat Satellite Tools 6.3 (for RHEL 7 Server) (RPMs) - Enabled: No (Default)
   • Red Hat Enterprise Linux 7 Server (RPMs) - Enabled: Yes (Default)

   However, we want to enable the Red Hat Satellite Tools repository because that contains our configuration tools (such as katello-agent and puppet). Change it to the following:

   • Red Hat Satellite Tools 6.3 (for RHEL 7 Server) (RPMs) - Enabled: Override to Yes
4. Click Save

For CLI Users

1. Create the activation key:

   # hammer activation-key create \
   --name "development-stack" \
   --unlimited-hosts true \
   --description "Exampleware Stack in the Development Environment" \
   --lifecycle-environment "Development" \
   --content-view "Stack"  \
   --organization "ACME"

2. Obtain a list of your subscription IDs:

   # hammer subscription list --organization "ACME"

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

   # hammer activation-key add-subscription \
   --name "development-stack" \
   --subscription-id ff808181533518d50152354246e901aa \
   --organization "ACME"

4. Attach the PostgreSQL product to the activation key:

   # hammer activation-key add-subscription \
   --name "development-stack" \
   --subscription-id ff8081815239acdc015238fefaa10002 \
   --organization "ACME"

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

   # hammer activation-key product-content \
   --name "development-stack" \
   --organization "ACME"

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

   # hammer activation-key content-override \
   --name "development-stack" \
   --content-label rhel-7-server-satellite-tools-6.3-rpms \
   --value 1 \
   --organization "ACME"

For Web UI Users

1. Navigate to Content > Activation keys and click the name of the Activation Key.
2. Select the Subscriptions tab.
3. To remove subscriptions, select List/Remove, select the check boxes to the left of the subscriptions to be removed and then click Remove Selected.
4. To add subscriptions, select Add, select the check boxes to the left of the subscriptions to be added and then click Add Selected.
5. Select Repository Sets 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. Select the Details tab, select a Content View for this Activation Key, and then click Save.

For CLI Users

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 "Default Organization"

2. You can view the columns of the file as follows:

   # column -s, -t < a_keys.csv | less -S
   Name  Organization  Description  Limit  Environment  Content View  Host Collections  Auto-Attach  Service Level  Release Version  Subscriptions

   The last column has the subscription information. Note that it is one field in the CSV file and can include a comma in quoted text. Examples of the Subscriptions field include:

   • '"""Automatic|RH1234|Red Hat Enterprise Linux Server, Standard (Physical or Virtual Nodes)|11223344|55667788"""'

   • '1|MCT0369|Red Hat Satellite Capsule Server|11223344|55667788'

     The Subscriptions field has the following format:

     • Number of subscriptions allocated (can be set to Automatic).
     • The subscription’s identification number.
     • The subscription’s name.
     • The contract number.
     • The account number.

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.

   1. Make a backup of the file.

      # cp a_keys.csv a_keys.csv.backup

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

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

      # diff a_keys.csv a_keys.csv.backup
      2c2
      < """Automatic|RH4567|Red Hat Enterprise Linux Server, Standard (Physical or Virtual Nodes)|11223344|55667788"""
      ---
      > """Automatic|RH1234|Red Hat Enterprise Linux Server, Standard (Physical or Virtual Nodes)|11223344|55667788"""

4. Upload the changed file to Satellite Server.

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

For Web UI Users

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

For Web UI Users

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