community.general.rhn_register module – Manage Red Hat Network registration using the rhnreg_ks
command
Note
This module is part of the community.general collection (version 5.8.3).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: community.general.rhn_register
.
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 |
Comments |
---|---|
Supply an activation key for use with registration. |
|
Supply a custom ssl CA certificate file for use with registration. |
|
Optionally specify a list of channels to subscribe to upon successful registration. Default: |
|
If Choices:
|
|
Force registration, even if system is already registered. Choices:
|
|
If Choices:
|
|
Red Hat Network password. |
|
Supply an profilename for use with registration. |
|
Specify an alternative Red Hat Network server URL. The default is the current value of serverURL from |
|
Whether to register ( Choices:
|
|
Supply an organizational id for use with registration. |
|
Red Hat Network username. |
Notes
Note
This is for older Red Hat products. You probably want the community.general.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
community.general.rhn_register:
state: absent
username: joe_user
password: somepass
- name: Register as user with password and auto-subscribe to available content
community.general.rhn_register:
state: present
username: joe_user
password: somepass
- name: Register with activationkey and enable extended update support
community.general.rhn_register:
state: present
activationkey: 1-222333444
enable_eus: true
- name: Register with activationkey and set a profilename which may differ from the hostname
community.general.rhn_register:
state: present
activationkey: 1-222333444
profilename: host.example.com.custom
- name: Register as user with password against a satellite server
community.general.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
community.general.rhn_register:
state: present
username: joe_user
password: somepass
channels: rhel-x86_64-server-6-foo-1,rhel-x86_64-server-6-bar-1
- name: Force-register as user with password to ensure registration is current on server
community.general.rhn_register:
state: present
username: joe_user
password: somepass
server_url: https://xmlrpc.my.satellite/XMLRPC
force: true
Collection links
Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication