ansible.builtin.rhn_register (v2.4.4.0-1) — module

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

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

Authors: James Laska

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.4.4.0.post1

Description

Manage registration to the Red Hat Network.


Requirements

Usage examples

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

Inputs

    
state:
    choices:
    - present
    - absent
    default: present
    description:
    - whether to register (C(present)), or unregister (C(absent)) a system
    required: false

channels:
    default: []
    description:
    - Optionally specify a list of comma-separated channels to subscribe to upon successful
      registration.
    required: false

password:
    default: null
    description:
    - Red Hat Network password
    required: false

username:
    default: null
    description:
    - Red Hat Network username
    required: false

sslcacert:
    default: None
    description:
    - supply a custom ssl CA certificate file for use with registration
    required: false
    version_added: '2.1'
    version_added_collection: ansible.builtin

enable_eus:
    default: false
    description:
    - If true, extended update support will be requested.
    required: false

server_url:
    default: Current value of I(serverURL) from C(/etc/sysconfig/rhn/up2date) is the default
    description:
    - Specify an alternative Red Hat Network server URL
    required: false

profilename:
    default: null
    description:
    - supply an profilename for use with registration
    required: false
    version_added: '2.0'
    version_added_collection: ansible.builtin

systemorgid:
    default: None
    description:
    - supply an organizational id for use with registration
    required: false
    version_added: '2.1'
    version_added_collection: ansible.builtin

activationkey:
    default: null
    description:
    - supply an activation key for use with registration
    required: false