How to create an activation key for automated registration of Red Hat Enterprise Linux systems to RHN Classic or Red Hat Satellite?

Solution Verified - Updated -


  • Red Hat Network (RHN) Classic
  • Red Hat Satellite
  • Management & Provisioning Entitlement

Note: A management & provisioning entitlement is required for any system that uses an activation key to register to RHN Classic or Satellite. If there is no active management entitlement in the account, the Activation Keys option will not be visible under the Systems tab.


  • How to use the Red Hat Network (RHN) activation key feature to make it easier to register Red Hat Enterprise Linux systems to RHN Classic or Red Hat Satellite during automated system installation.
  • How to subscribe system to configuration channel at the time of registration ?
  • How to create an activation key for automated registration of Red Hat Enterprise Linux systems to RHN Classic or Red Hat Satellite?
  • How to create an Activation key ?


  • Creating an activation key is simple, and it allows you to securely register systems to RHN Classic or Red Hat Satellite via the command line.  Most commonly, this is used as part of remote kickstart installations in the %post install section.
  1. For RHN Classic Hosted : Log in to Customer Portal as a user with administrative privileges

    For Red Hat Satellite: Log in to the Satellite's Web UI as a Satellite Admininistrator or Organization Administrator.

  2. For RHN: Go to Subscriptions -> Classic Management -> Registered Systems -> Activation Keys -> Create New Key

    For Red Hat Satellite: Go to Activation Keys in the gray box on the left side of the page. Then to create new key in the top right of the page.

  3. Fill in the Description field with something meaningful (like "marketing," or "developer")

  4. Set the Usage Limit to enforce a maximum number of systems that can use this key

  5. Set Add-On Entitlements to "Provisioning" or "Monitoring" depending on the needs of this system

  6. Set Universal Default if applicable. Universal Default means that this key will be used for any system registered to this account that does not specify a key. To have key as default one, set this to "yes"; set this to "no" if you want this key to be used only when specified.

  7. Activation key can be used to have required child channels,configuration channels,install packages and add system to required group. These all things are configurable from respective tab of activation key.

  8. To change information about a key, such as the channels or groups, click its description in the key list, make your modifications in the appropriate tab, and click the Update Key button. To disassociate channels and groups from a key, deselect them in their respective menus by Ctrl key clicking their highlighted names. To remove a key entirely, click the delete key link in the top-right corner of the edit page.

Once you have created your activation key, you can use it to register any Red Hat Enterprise Linux system from the command line. To do this, copy and paste the key's ID (e.g. 1-328d86a62d1b7cfd750b99f02be7fe85) from the web interface and then pass it to the rhnreg_ks command (e.g. rhnreg_ks --activationkey 1-328d86a62d1b7cfd750b99f02be7fe85).

For more information on using activation keys with Red Hat Satellite, pease refer to Satellite documentation.

If you encounter "Error Code 91" when trying to register a system to RHN using an activation key, you are most likely out of management entitlements. For more information, refer to: When registering a system to RHN I received an error stating: 'error code 91: red hat software management exhausted' what do I do?.

What is the difference among Update, Management, Provisioning, and Monitoring Entitlements in RHN?

NOTE: Once system is registered using an Activation key, any changes made to the key will be not reflected on the existing registered Client, while the modified changes will only reflected on the new clients which are registered using this key. When system is registered using activation key Registered by field of Recently Registered Systems page of Satellite will show username who created activation key on Satellite.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.