SUBSCRIPTION-MANAGER LIST SUBSCRIPTION AND PRODUCT INFORMATION FOR

THE SYSTEM
COMMAND CHEAT SHEET SUBCOMMAND DESCRIPTIONS AND TASKS

for Red Hat Enterprise Linux list Lists subscription and product information for
this system
subscription-manager list --available
Lists available subscriptions not yet attached to
SUBSCRIPTION-MANAGER QUERIES the system
SUBCOMMAND DESCRIPTIONS AND TASKS
subscription-manager list --available --all
-h or --help Prints the specific help information for the given Lists all possible subscriptions that have been
command purchased, even if they do not match the system
architecture
subscription-manager attach --help
Gives the help information for the attach command subscription-manager list --available \
--match-installed
Shows only subscriptions matching products that
are currently installed
Primary Modules subscription-manager list --available \
--no-overlap
REGISTER A NEW SYSTEM TO THE SUBSCRIPTION-MANAGER Shows pools which provide products that are not
SERVICE already covered
SUBCOMMAND DESCRIPTIONS AND TASKS subscription-manager list --available \
--ondate=2016-12-25
register Registers this system to the Customer Portal or another Sets the date to use to search for active and
subscription management service available subscriptions
subscription-manager register \ subscription-manager list --consumed
[email protected] Lists all subscriptions currently attached to the
Gives the username for the account which is registering system
the system (required if not using activation key)
subscription-manager list --installed
subscription-manager register \ Lists products (subscribed or not) currently
--password=MyKul22pwd installed on the system.
Gives the user account password (required if not using
activation key)
subscription-manager register \
--serverurl=host.example.com
ATTACH OR AUTO-ATTACH A SUBSCRIPTION TO THE
Registers system with host other than SYSTEM
subscription.rhn.redhat.com SUBCOMMAND DESCRIPTIONS AND TASKS
subscription-manager register \
--baseurl=https://host:8088/sam
attach Attaches a specified subscription to the
Passes the name of the content delivery service to registered system
configure the yum service to use to pull down packages subscription-manager attach \
subscription-manager register \ --pool=8af5f9643d4ade76013123451f6e495d
--name=host.example.com Gives the ID for the subscriptions pool (collection
Sets the name of the system to register (defaults to of products) to attach to the system (required
hostname) unless using --auto)

subscription-manager register \ subscription-manager attach --quantity=1

--consumerid=12345d6d-83ed-44f8-99bf-14f605bbeXXX Sets the number of subscriptions attached to the
References an existing system inventory ID to system (default 1)
re-register a system subscription-manager attach --auto
subscription-manager register \ Automatically attaches the best-matched
--activationkey=Example_Key1 compatible subscriptions to the system
Gives a comma-separated list of product keys to use to subscription-manager attach \
redeem or apply specific subscriptions to the system --servicelevel=standard
subscription-manager register --auto-attach Sets the service level (standard, premium, or self-
Automatically attaches the best-matched, compatible support) for subscriptions attached to the system
subscriptions to this system
auto-attach Sets whether the ability to check, attach, and
subscription-manager register --auto-attach \ update subscriptions occurs automatically on the
--servicelevel=standard system every four hours
Sets the service level (standard, premium, or self-
support) to use with subscriptions subscription-manager auto-attach --enable
Enables the auto-attach option for the system
subscription-manager register --force
Registers the system even if it is already registered subscription-manager auto-attach --show
Shows whether auto-attach is enabled on the
subscription-manager register --org=Example_Org1 systems
Assigns the system to an organization
subscription-manager auto-attach --disable
subscription-manager register \ Disables the auto-attach option for the system
--environment=Example_Env
Registers the system to an environment within an
organization PULL LATEST SUBSCRIPTION DATA FROM SERVER
subscription-manager register --proxy=host:3128 \ SUBCOMMAND DESCRIPTIONS AND TASKS
--proxyuser=jo --proxypass=MyKul22pwd
Registers system via a proxy server refresh Pulls the latest subscription data from the server
Primary Modules (cont.) import Imports and applies an externally generated
subscription certificate (useful for subscribing
SHOW STATUS INFORMATION FOR THIS SYSTEM’S disconnected systems)
SUBSCRIPTIONS AND PRODUCTS subscription-manager import \
--certificate=/path/to/cert.pem
SUBCOMMAND DESCRIPTIONS AND TASKS
Points to a certificate PEM file containing the
status Shows the current status of the products and subscription certificate
attached subscriptions for the system
identity Lists the system identity, name, organization name
and organization ID
subscription-manager identity \
UNREGISTER AND REMOVE SUBSCRIPTIONS FROM THE
--regenerate
SYSTEM Requests that the subscription management service
SUBCOMMAND DESCRIPTIONS AND TASKS issue a new identity certificate for the system, using
an existing UUID in the original identity certificate
unregister Unregister this system from the Customer Portal or subscription-manager identity \
another subscription management service --regenerate --force
Regenerates the identity certificate for the system
remove Removes a subscription from the system, but does using username/password authentication
not uninstall the associated products
subscription-manager remove \ orgs Lists all the organizations associated with an account
--serial=5282836853581912345
subscription-manager orgs \
Gives the serial number of the subscription certificate --serverurl=host.example.com
for the specific product to remove from the system Passes the name of the subscription service to use to
subscription-manager remove --all list all available organizations
Removes all of the subscriptions attached to a system
plugins Lists the available subscription-manager plugins
clean Removes all local system and subscription data subscription-manager plugins --list
without affecting the server (effectively doing an Lists the available subscription-manager plugins
unregister and remove)
subscription-manager plugins --listslots
Lists the available plugin slots
subscription-manager plugins --listhooks
Other Modules Lists the available plugin slots and the hooks that
handle them
SUBCOMMAND DESCRIPTIONS AND TASKS subscription-manager plugins --verbose
Shows other plugins data, such as plugin
config Changes settings in the rhsm.conf configuration file configuration values
subscription-manager config --list
Prints the current configuration for Subscription redeem For systems purchased from third-party vendors that
Manager include a subscription, the redemption process
auto-attaches the pre-selected subscription that the
subscription-manager config \ vendor supplied to the system.
--remove=server.proxy_port
Deletes the current value for the proxy_port without subscription-manager redeem \
supplying a new parameter (server can be rhsm or [email protected]
rhsmcertd instead) Gives the email account to send the redemption
notification message to
subscription-manager config \
--server.proxy_port=999 subscription-manager redeem --locale=en-us
Sets proxy_port value in [server] section to 999 Sets the local language to use for email notification
subscription-manager redeem \
environments Lists all the environments configured for an --org=Example_Org1
organization with a locally-hosted subscription or Identifies the organization which issued the
content service, such as Subscription Asset Manager subscription being redeemed
subscription-manager environments \
[email protected] release Sets a sticky OS version to use when installing or
Gives the username for the account to use to connect updating packages
to the organization account. subscription-manager release --list
subscription-manager environments \ Lists the available OS versions
--password=MyKul22pwd subscription-manager release --set=6.3
Gives the user account password Sets the minor (Y-stream) release version to use (6.3)
subscription-manager environments \ subscription-manager release --unset
--org=Example_Org1 Removes any previously set release version
Identifies the organization for which to list the preference
configured environments

facts Lists the system information, such as release version,

number of CPUs, and other architecture information
subscription-manager facts --list
Lists the system information
subscription-manager facts --update
Updates the system information
Other Modules (cont.) MORE SUBSCRIPTION-MANAGER RELATED COMMANDS
SUBCOMMAND DESCRIPTIONS AND TASKS SUBCOMMAND DESCRIPTIONS AND TASKS

repo-override Manage custom content repository settings rct Displays contents of a certificate or manifest
subscription-manager repo-override \ rct cat-cert /etc/pki/tls/cert.pem
--repo=rhel-7-workstation-htb-rpms Displays contents of cert.pem file
Selects the repository to modify (can be specified
more than once) rhsm-debug Lists information about subscribed system
subscription-manager repo-override \ rhsm-debug system
--add=enabled:1 Lists subscription information for local system
Adds a named override with the provided value,
separated by a colon, to repos specified (used with
the --repo option)
subscription-manager repo-override \
--remove=enabled
Removes a named override from the repos specified
with the --repo option
subscription-manager repo-override \
--remove-all
Removes all overrides from repos specified with the
--repo option
subscription-manager repo-override --list
Lists all overrides from repos specified with the
--repo option

repos Lists all the repositories available to a system (for

organizations with a locally-hosted content service,
such as Subscription Asset Manager
subscription-manager repos --list
Lists all repositories provided by the content service
that the system uses
subscription-manager repos \
--enable=rhel-7-server-supplementary-rpms
Enables the specified repository, made available by
the content sources identified in the system
subscriptions
subscription-manager repos \
--disable=rhel-7-server-supplementary-rpms
Disables the specified repository, made available by
the content sources identified in the system
subscriptions

service-level Displays the current configured service level

preference (standard, premium, or self-support) for
products installed on the system
subscription-manager service-level --list
Lists the available service levels
subscription-manager service-level --show
Shows the system’s current service-level preference
subscription-manager service-level --unset
Removes any previously set service level preference

version Displays version information about the subscription

management service and packages

12/14

Copyright © 2014 Red Hat, Inc. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, and JBoss are trademarks of Red Hat, Inc.,
registered in the U.S. and other countries. Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.