ansible.builtin.rhn_register (v2.9.27) — module

Manage Red Hat Network registration using the C(rhnreg_ks) command

| "added in version" 1.2 of ansible.builtin"

Authors: James Laska (@jlaska)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

Manage registration to the Red Hat Network.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Unregister system from RHN
  rhn_register:
    state: absent
    username: joe_user
    password: somepass
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Register as user with password and auto-subscribe to available content
  rhn_register:
    state: present
    username: joe_user
    password: somepass
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Register with activationkey and enable extended update support
  rhn_register:
    state: present
    activationkey: 1-222333444
    enable_eus: yes
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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

Inputs

    
state:
    choices:
    - absent
    - present
    default: present
    description:
    - Whether to register (C(present)), or unregister (C(absent)) a system.
    type: str

ca_cert:
    aliases:
    - sslcacert
    description:
    - Supply a custom ssl CA certificate file for use with registration.
    type: path
    version_added: '2.1'
    version_added_collection: ansible.builtin

channels:
    default: []
    description:
    - Optionally specify a list of channels to subscribe to upon successful registration.
    type: list

password:
    description:
    - Red Hat Network password.
    type: str

username:
    description:
    - Red Hat Network username.
    type: str

enable_eus:
    default: false
    description:
    - If C(no), extended update support will be requested.
    type: bool

nopackages:
    default: false
    description:
    - If C(yes), the registered node will not upload its installed packages information
      to Satellite server.
    type: bool
    version_added: '2.5'
    version_added_collection: ansible.builtin

server_url:
    description:
    - Specify an alternative Red Hat Network server URL.
    - The default is the current value of I(serverURL) from C(/etc/sysconfig/rhn/up2date).
    type: str

profilename:
    description:
    - Supply an profilename for use with registration.
    type: str
    version_added: '2.0'
    version_added_collection: ansible.builtin

systemorgid:
    description:
    - Supply an organizational id for use with registration.
    type: str
    version_added: '2.1'
    version_added_collection: ansible.builtin

activationkey:
    description:
    - Supply an activation key for use with registration.
    type: str