Show Table of Contents
Chapter 3. Subscription Usage
3.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. You can manage your usage from the Customer Portal from the Subscription Utilization page.
To manage subscriptions from the command line:
Table 3.1. 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. |
| sect-Red_Hat_Subscription_Management-Using_Red_Hat_Subscription_Management-Registering_and_Attaching_Subscriptions_Section_ --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
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.