Skip to content

Feature: Subscriptions

Dominik Perpeet edited this page Jul 22, 2016 · 12 revisions


Subscribe a RHEL system to be able to receive OS updates (security and otherwise).

  • Long term goal: provide at least the functionality provided by subscription-manager GUI
  • See current subscription state
  • Modify subscriptions and registration
  • Work with pools (view+filter, attach, remove)
  • Related: Enable/disable software repositories

User stories:

  • Sarah is a developer, but got tossed the "sysadmin hat" at the 20 people IT company she works at. They are currently in the process to migrate their 3 servers from Windows 2012 to RHEL.

  • Kathy works as a sysadmin consultant for several different customers. At one of her customers she needs to set up two new machines with no connection to the internet. The machine can however talk to the local SAM server.


Sarah: Sarah has bought 3 self-service subscriptions for RHEL. She downloads RHEL Server from the customer portal and installs the machines.

After she's done with the installation of each machine, she reboots that system and fires up her web browser on her laptop and launches Cockpit via the https://IPADDRESS:9090

The system is currently not subscribed, so it alerts Sarah that she needs to subscribe the machines in order to receive updates.

She inputs her Customer Portal ID and password. The system is registered and a subscription automatically added. The system notifies her that the system is now successfully subscribed. She then goes on to install the next machines and repeats the steps there.

Kathy: Installs RHEL from a USB stick and boots the first machine up. After accessing the machine in a web browser. Kathy fires up the subscription UI and points it at the internal SAM server and attaches a self-service subscription using an activation key rather than her username and password.

When she tries to do the same on the second machine, the registration fails with an error message telling her that the server couldn't be reached. On checking the machine's network settings she quickly finds the error and corrects it. She navigates back to the subscriptions page, where the registration dialog retained her previous settings and she only has to enter her password again. The second attempt is successful.


Error handling:

Activation keys, organization:


Future Work or Out of Scope



Clone this wiki locally
You can’t perform that action at this time.