5. Viewing Subscription Usage Information and Notifications

5.1. Viewing Available and Used Subscriptions

To manage subscriptions, administrators need to know both what subscriptions are currently attached to a system and what subscriptions are available to the system.

5.1.1. Viewing Subscriptions in the GUI

Three tabs summarize each of the subscriptions and products for the specific machine: installed products (with subscriptions), attached subscriptions, and available subscriptions.
These summaries are always displayed in the Red Hat Subscription Manager UI.
Attached Subscriptions

The My Subscriptions tab shows all of the current subscriptions attached to the system.

My Subscriptions Tab

Figure 6. My Subscriptions Tab

Available Subscriptions

The All Available Subscriptions tab shows all of the subscriptions that are available to the system. The default displays only subscriptions that are compatible with the hardware, but these can be filtered to show subscriptions corresponding to other installed programs, only subscriptions that have not been installed, and subscriptions based on date.

All Available Subscriptions Tab

Figure 7. All Available Subscriptions Tab

The filters dynamically search for available subscriptions.
Filter and Date Area

Figure 8. Filter and Date Area

By default, the displayed subscriptions are filtered so that they are compatible with the system's recognized hardware, operating system version, and installed products. These filters can be changed to filter by other criteria:
  • match my system shows only subscriptions which match the system architecture.
  • match my installed products shows subscriptions which work with currently installed products on the system.
  • have no overlap with existing subscriptions excludes subscriptions with duplicate products. If a subscription is already attached to the system for a specific product or if multiple subscriptions supply the same product, then the subscription service filters those subscriptions and shows only the best fit.
  • contain the text searches for strings, such as the product name, within the subscription or pool.
Filters

Figure 9. Filters

My Installed Products

The My Installed Products tab shows the currently installed products on the system, along with their subscription status. This does not allow administrators to install software, only to view installed software.

My Installed Products Tab

Figure 10. My Installed Products Tab

5.1.2. Listing Subscriptions with the Command Line

As with the three tabs in the UI, there are several different ways to use the list command to display different areas of the subscriptions and products on the system.

Table 5. subscription-manager list Options

Option Description
--installed (or nothing) Lists all of the installed products on the system. If no option is given with list, it is the same as using the --installed argument.
--consumed Lists all of the subscriptions attached to the system.
--available [--all] Using --available alone lists all of the compatible, active subscriptions for the system. Using --available --all lists all options, even ones not compatible with the system.
--ondate=YYYY-MM-DD Shows subscriptions which are active and available on the specified date. This is only used with the --available option. If this is not used, then the command uses the current date.
--installed Lists all of the products that are installed on the system (and whether they have a subscription) and it lists all of the product subscriptions which are attached to the system (and whether those products are installed).
The list command shows all of the subscriptions that are currently attached to the system by using the --consumed option.
[root@server1 ~]# subscription-manager list --consumed

+-------------------------------------------+
    Consumed Product Subscriptions
+-------------------------------------------+


ProductName:        	Red Hat Enterprise Linux Server
ContractNumber:     	1458961
SerialNumber:       	171286550006020205
Active:             	True
Begins:             	2009-01-01
Expires:            	2011-12-31
The list command shows all of the subscriptions that are compatible with and available to the system using the --available option. To include every subscription the account has — both the ones that are compatible with the system and for other platforms — use the --all option with the --available. The --ondate option shows only subscriptions which are active on that date, based on their activation and expiry dates.
[root@server1 ~]# subscription-manager list --available --all

+-------------------------------------------+
    Available Subscriptions
+-------------------------------------------+


ProductName:            RHEL for Physical Servers
ProductId:              MKT-rhel-server
PoolId:                 ff8080812bc382e3012bc3845ca000cb
Quantity:               10
Expires:                2011-09-20


ProductName:            RHEL Workstation
ProductId:              MKT-rhel-workstation-mkt
PoolId:                 5e09a31f95885cc4
Quantity:               10
Expires:                2011-09-20

[snip]
The --installed option correlates the products that are actually installed on the system (and their subscription status) and the products which could be installed on the system based on the attached subscriptions (and whether those products are installed).
[root@server1 ~]# subscription-manager list --installed

+-------------------------------------------+
    Installed Product Status
+-------------------------------------------+
ProductName:         Red Hat Enterprise Linux 
Status:              Not Subscribed
Expires:
Subscription:
ContractNumber:
AccountNumber:


ProductName:         Load Balancer
Status:              Subscribed
Expires:             2012-02-20
Subscription:        54129829316535230
ContractNumber:      39
AccountNumber:       12331131231

5.1.3. Viewing Subscriptions Used in Both RHN Classic and Red Hat Subscription Management

Administrators need to have a sense of all of the subscriptions attached for their account, altogether, regardless of whether the system is managed in RHN Classic or Customer Portal Subscription Management. The Customer Portal provides a way of looking at the total attached subscriptions.
In the Subscriptions Overview page, the Subscription Utilization area at the top gives the current count for every active subscription for the entire account, and a total count of every used subscription, regardless of whether it is used in RHN Classic or Customer Portal Subscription Management. These numbers are updated whenever the subscription count changes in the subscription server.
Total Counts of Subscriptions for All Subscription Services

Figure 11. Total Counts of Subscriptions for All Subscription Services

Note

RHN Classic is intended to be used with legacy systems (Red Hat Enterprise Linux 6.0 or Red Hat Enterprise Linux 5.6 and earlier releases). It is strongly recommended that Red Hat Enterprise Linux 6.1/5.7 and later systems use Customer Portal Subscription Management, Subscription Asset Manager, or other certificate-based subscription management service.