Documentation

rhn_register - Manage Red Hat Network registration using the rhnreg_ks command

Synopsis

  • Manage registration to the Red Hat Network.

Options

parameter required default choices comments
activationkey
no
supply an activation key for use with registration
channels
no
Optionally specify a list of comma-separated channels to subscribe to upon successful registration.
enable_eus
no
If true, extended update support will be requested.
password
no
Red Hat Network password
profilename
(added in 2.0)
no
supply an profilename for use with registration
server_url
no Current value of I(serverURL) from C(/etc/sysconfig/rhn/up2date) is the default
Specify an alternative Red Hat Network server URL
sslcacert
(added in 2.1)
no None
supply a custom ssl CA certificate file for use with registration
state
no present
  • present
  • absent
whether to register (present), or unregister (absent) a system
systemorgid
(added in 2.1)
no None
supply an organizational id for use with registration
username
no
Red Hat Network username

Examples

# Unregister system from RHN.
- rhn_register:
    state: absent
    username: joe_user
    password: somepass

# Register as user (joe_user) with password (somepass) and auto-subscribe to available content.
- rhn_register:
    state: present
    username: joe_user
    password: somepass

# Register with activationkey (1-222333444) and enable extended update support.
- rhn_register:
    state: present
    activationkey: 1-222333444
    enable_eus: true

# Register with activationkey (1-222333444) and set a profilename which may differ from the hostname.
- rhn_register:
    state: present
    activationkey: 1-222333444
    profilename: host.example.com.custom

# Register as user (joe_user) with password (somepass) against a satellite
# server specified by (server_url).
- rhn_register:
    state: present
    username: joe_user
    password: somepass'
    server_url: https://xmlrpc.my.satellite/XMLRPC

# Register as user (joe_user) with password (somepass) and enable
# channels (rhel-x86_64-server-6-foo-1) and (rhel-x86_64-server-6-bar-1).
- rhn_register:
    state: present
    username: joe_user
    password: somepass
    channels: rhel-x86_64-server-6-foo-1,rhel-x86_64-server-6-bar-1

Notes

Note

  • In order to register a system, rhnreg_ks requires either a username and password, or an activationkey.

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

This module is maintained by those with core commit privileges

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.