community.general.rhn_register – Manage Red Hat Network registration using the rhnreg_ks command
Note
This plugin is part of the community.general collection (version 3.8.1).
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
.
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 | Choices/Defaults | Comments |
---|---|---|
activationkey string | Supply an activation key for use with registration. | |
ca_cert path | Supply a custom ssl CA certificate file for use with registration. aliases: sslcacert | |
channels list / elements=string | Default: [] | Optionally specify a list of channels to subscribe to upon successful registration. |
enable_eus boolean |
| If no , extended update support will be requested. |
force boolean added in 2.0.0 of community.general |
| Force registration, even if system is already registered. |
nopackages boolean |
| If yes , the registered node will not upload its installed packages information to Satellite server. |
password string | Red Hat Network password. | |
profilename string | 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 |
| Whether to register ( present ), or unregister (absent ) a system. |
systemorgid string | 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 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: yes - 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: yes
Authors
- James Laska (@jlaska)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/rhn_register_module.html