redhat_subscription - Manage Red Hat Network registration and subscriptions using the subscription-manager command

Author:James Laska

Synopsis

New in version 1.2.

Manage registration and subscription to the Red Hat Network entitlement platform.

Options

parameter	required	default	choices	comments
activationkey	no			supply an activation key for use with registration
autosubscribe	no			Upon successful registration, auto-consume available subscriptions
password	no			Red Hat Network password
pool	no	^$		Specify a subscription pool name to consume. Regular expressions accepted.
rhsm_baseurl	no	Current value from C(/etc/rhsm/rhsm.conf) is the default		Specify CDN baseurl
server_hostname	no	Current value from C(/etc/rhsm/rhsm.conf) is the default		Specify an alternative Red Hat Network server
server_insecure	no	Current value from C(/etc/rhsm/rhsm.conf) is the default		Allow traffic over insecure http
state	no	present	present absent	whether to register and subscribe (present), or unregister (absent) a system
username	no			Red Hat Network username

Note

Requires subscription-manager

Examples

# Register as user (joe_user) with password (somepass) and auto-subscribe to available content.
- redhat_subscription: action=register username=joe_user password=somepass autosubscribe=true

# Register with activationkey (1-222333444) and consume subscriptions matching
# the names (Red hat Enterprise Server) and (Red Hat Virtualization)
- redhat_subscription: action=register
                       activationkey=1-222333444
                       pool='^(Red Hat Enterprise Server|Red Hat Virtualization)$'

Note

In order to register a system, subscription-manager requires either a username and password, or an activationkey.