rhn_register – Manage Red Hat Network registration using the rhnreg_ks command

From Get docs
Ansible/docs/2.8/modules/rhn register module


rhn_register – Manage Red Hat Network registration using the rhnreg_ks command

Synopsis

  • Manage registration to the Red Hat Network.

Requirements

The below requirements are needed on the host that executes this module.

  • rhnreg_ks
  • either libxml2 or lxml

Parameters

Parameter Choices/Defaults Comments

activationkey

string

Supply an activation key for use with registration.

ca_cert

path

added in 2.1

Supply a custom ssl CA certificate file for use with registration.


aliases: sslcacert

channels

list

Default:

[]

Optionally specify a list of channels to subscribe to upon successful registration.

enable_eus

boolean

  • no

  • yes

If no, extended update support will be requested.

nopackages

boolean

added in 2.5

  • no

  • yes

If yes, the registered node will not upload its installed packages information to Satellite server.

password

string

Red Hat Network password.

profilename

string

added in 2.0

Supply an profilename for use with registration.

server_url

string

Specify an alternative Red Hat Network server URL.

The default is the current value of serverURL from /etc/sysconfig/rhn/up2date.

state

string

  • absent
  • present

Whether to register (present), or unregister (absent) a system.

systemorgid

string

added in 2.1

Supply an organizational id for use with registration.

username

string

Red Hat Network username.



Notes

Note

  • This is for older Red Hat products. You probably want the redhat_subscription module instead.
  • In order to register a system, rhnreg_ks requires either a username and password, or an activationkey.


Examples

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

- name: Register as user with password and auto-subscribe to available content
  rhn_register:
    state: present
    username: joe_user
    password: somepass

- name: Register with activationkey and enable extended update support
  rhn_register:
    state: present
    activationkey: 1-222333444
    enable_eus: yes

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

- name: Register as user with password against a satellite server
  rhn_register:
    state: present
    username: joe_user
    password: somepass
    server_url: https://xmlrpc.my.satellite/XMLRPC

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

Status

Authors

  • James Laska (@jlaska)

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/rhn_register_module.html