Katello 2.4 Documentation

Activation Keys

Activation Keys provide a mechanism to define properties that may be applied to Content Hosts during registration. This includes properties such as:

  • Lifecycle Environment
  • Content View
  • Subscriptions
  • Repository Enablement
  • Host Collections

Definitions

  • Content Host
  • Host Collection - A statically defined group of Content Hosts.
  • Subscription - The right to receive the associated content from Katello.

General Features

The following is a high-level summary of the Activation Key features:

Create an Activation Key

To create a new key,

  • navigate to: Content > Activation Keys
  • click New Activation Key

Creating a Host Collection

  • Name: This required option is used to identify the activation key to command line tools, such as subscription-manager.

  • Content Host Limit: This option will control how many Content Hosts may be registered using the key. An “unlimited” value will not place any limits on usage. Specifying a quantity will limit the number of registered content hosts. Registering with an activation key consumes one of the available limit quantity, while unregistering makes it available again. (i.e. this quantity is not a usage counter but a limit of actively registered content hosts)

  • Description: A free form text field that can be used to store a description of the key for later reference or for pseudo-tagging that can be used to search.

  • Environment and Content View: Although optional, at least one activation key used during registration must specify a content view. Activation keys are used in the order specified to subscription-manager meaning the last activation key with a content view takes precedence.

The following example would use CV_B’s content view:

subscription-manager register --org Default_Organization --activationkey NO_CV --activationkey CV_A --activationkey CV_B

Or equivalently:

subscription-manager register --org Default_Organization --activationkey NO_CV,CV_A,CV_B

For registration to succeed, at least one activation key must be successfully applied. For an activation key to succeed, at least one of the listed subscriptions must be successfully attached to the registering content host.

Add Subscriptions to an Activation Key

To add subscriptions to a key:

  • navigate to: Content > Activation Keys
  • select the desired key from the list
  • click Subscriptions
  • click Add
  • select the Subscriptions you would like to add
  • click Add Selected

The Auto-Attach setting controls how the group of subscriptions are processed during registration.

When ‘Auto-Attach’ is enabled but no subscriptions are added to the activation key, subscriptions will be automatically added to cover the installed products. This is equivalent to passing the ‘–auto-attach’ flag to the subscription-manager command:

subscription-manager register --org=Default_Organization --auto-attach

When ‘Auto-Attach’ is enabled and subscriptions are listed for the activation key, two things will happen. First all subscriptions for custom products will be attached to the registering content host. Second, the group of Red Hat subscriptions will be attached as needed to cover the content host’s installed Red Hat products. This is most commonly used when there is a group of similar subscriptions (eg. several Red Hat Enterprise Linux from different contracts, or guest subscriptions from different hypervisors) and which one used is not important. Katello’s subscription tooling, Candlepin, will automatically choose the minimal proper subscriptions from the group.

Finally, when ‘Auto-Attach’ is disabled, all subscriptions on the activation key will attached to the registering content host, regardless of whether needed to cover an installed product or not. For example, adding an OpenStack Platform subscription would then allow that product to be installed after registration.

Adding subscriptions to an Activation Key

Change Repository Enablement for an Activation Key

To change repository enablement settings using a key:

  • navigate to: Content > Activation Keys
  • select the desired key from the list
  • click Product Content
  • click the edit icon for the repository content set that you would like to modify
  • select the desired value (e.g. ‘Override to Yes’, ‘Override to No’, ‘Defaults to Yes’, ‘Defaults to No’)
  • click Save

View current settings: Activation key product content

Change current settings: Activation key product content update

Add Host Collections to an Activation Key

To add Host Collections to a key:

  • navigate to: Content > Activation Keys
  • select the desired key from the list
  • click Host Collections
  • click Add
  • select the Host Collections you would like to add
  • click Add Selected

Adding Host Collections to an Activation Key

Register a Content Host using an Activation Key

The simplest form of registering a content host with an activation key is this:

subscription-manager register --org=Default_Organization --activationkey=$KEY_NAME

Click here for more information

Note that modifying an activation key does not change anything on content hosts previously registered with the key.



The Foreman Community Survey is now live, and has prizes! Fill it out here!

A new bug fix release for Foreman 1.14 is available. See the Foreman 1.14.1 release notes for more details.

Foreman 1.14.0 is now available, featuring new automatic IPv6 support, LDAP and template enhancements, and easier email configuration. Read about all of the changes in the release notes, and follow the quick start to install it.