Version information
This version is compatible with:
- Puppet Enterprise 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
- Puppet >= 4.10.0 < 8.0.0
Start using this module
Add this module to your Puppetfile:
mod 'pcfens-rhn_register', '1.6.2'
Learn more about managing modules with a PuppetfileDocumentation
puppet-rhn_register
Overview
Version 1.5 of this module is a fairly major overhaul, but should still be backwards compatible (but you should still test things first).
Registers a machine with RHN or a satellite server. If a machine is already registered then nothing happens, unless the force parameter is set to true.
Parameter names mostly match those used in the command itself, but are changed in some places to both preserve backwards compatibility, and to follow the puppet parameter naming conventions. Names will all conform to the puppet style guide when we move to 2.0 (probably the same time support for puppet 3.x will be dropped)
class rhn_register
rhn_register
can use the more classic rhnreg_ks
method of registering with a satellite server,
or the newer subscription-manager register
method. A username and password, or activation key
are required regardless of the method used. The use_classic
parameter (default is true for
backwards compatibility) selects the method used (classic uses rhnreg_ks
).
Using the classic (rhnreg_ks
) method, available parameters are
username
(string)password
(string)activationkey
(string)proxy
(string)serverurl
(string)proxyuser
(string)proxypass
(string)sslca
(string)profilename
(string)hardware
(boolean, default: true)packages
(boolean, default: true)virtinfo
(boolean, default: true)rhnsd
(boolean, default: true)force
(boolean, default: false)
Examples:
class { 'rhn_register':
sslca => '/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT',
serverurl => 'https://my-satellite-server.example.com/XMLRPC',
activationkey => '1-activationkeyiwanttouse',
}
class { 'rhn_register':
activationkey => '1-activationkeyiwanttouseforrhn',
}
The newer subscription-manager register
method accepts
system_name
(string, defaults to undefined, which RH defaults to the hostname)username
(string)password
(string)activationkey
(string)serverurl
(string)proxy
(string)proxyuser
(string)proxypass
(string)insecure
(boolean, default: false)base_url
(string)unit_type
(string, maps to type argument)org
(string)consumer_id
(string)environment
(string)release
(string)auto_attach
(boolean, default: true)auto_subscribe
(boolean, default: false)service_level
(string)
This method has not yet been fully tested for idempotency.
Supported Platforms
This class has only been tested on RHEL6.
Dependencies
- pcfens/command_args (>= 0.0.1 < 1.0.0)
- puppetlabs/stdlib (>= 4.2.0 < 9.0.0)