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
- Puppet >= 6.0.0 < 8.0.0
- , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'treydock-conman', '1.0.1'
Learn more about managing modules with a PuppetfileDocumentation
puppet-module-conman
####Table of Contents
- Setup - The basics of getting started with conman
- Usage - Configuration options and additional functionality
- Reference - Module reference
Setup
What conman affects
This module will install and configure ConMan: The Console Manager.
Usage
Install and configure conman and define a console
include conman
conman::console { 'compute01':
device => 'ipmi:bmc-compute01',
ipmiopts => 'U:admin,P:bmcpassword',
}
To configure a system as a conman client:
class { 'conman':
server => false,
conman_server => 'conman.example.com',
}
This is an example of exporting console configurations for all physical servers:
if $facts['virtual'] == 'physical' {
@@conman::console { $facts['networking']['hostname']:
device => "ipmi:bmc-${facts['networking']['hostname']}",
}
}
Then collect all the exported consoles:
Conman::Console <<| |>>
Reference
Reference
Table of Contents
Classes
conman
: Manage conman
Defined types
conman::console
: Define a conman console
Classes
conman
Manage conman
Examples
include ::conman
Parameters
The following parameters are available in the conman
class:
server
ensure
conman_server
conman_port
cfgfile
consoles
manage_repo
coredump
coredumpdir
execpath
keepalive
logdir
logfile
loopback
pidfile
resetcmd
syslog
tcpwrappers
timestamp
log
logopts
seropts
ipmiopts
server
Data type: Boolean
Boolean that sets host to act as conman server
Default value: true
ensure
Data type: Enum['present', 'absent']
Module ensure property
Default value: 'present'
conman_server
Data type: Stdlib::Host
Hostname of conman server
Default value: $facts['networking']['fqdn']
conman_port
Data type: Stdlib::Port
The port for conman server
Default value: 7890
cfgfile
Data type: String
The conman configuration file
Default value: '/etc/conman.conf'
consoles
Data type: Hash
Hash of conman::console
resources
Default value: {}
manage_repo
Data type: Boolean
Manage repo to install conman, only used on EL8
Default value: true
coredump
Data type: Boolean
See conman.conf man page
Default value: false
coredumpdir
Data type: Optional[Stdlib::Absolutepath]
See conman.conf man page
Default value: undef
execpath
Data type: Optional[String]
See conman.conf man page
Default value: undef
keepalive
Data type: Boolean
See conman.conf man page
Default value: true
logdir
Data type: Optional[Stdlib::Absolutepath]
See conman.conf man page
Default value: undef
logfile
Data type: Optional[String]
See conman.conf man page
Default value: undef
loopback
Data type: Boolean
See conman.conf man page
Default value: false
pidfile
Data type: Optional[Stdlib::Absolutepath]
See conman.conf man page
Default value: undef
resetcmd
Data type: Optional[String]
See conman.conf man page
Default value: undef
syslog
Data type: Optional[String]
See conman.conf man page
Default value: undef
tcpwrappers
Data type: Optional[Boolean]
See conman.conf man page
Default value: undef
timestamp
Data type: String
See conman.conf man page
Default value: '0'
log
Data type: Optional[String]
See conman.conf man page
Default value: undef
logopts
Data type: Optional[String]
See conman.conf man page
Default value: undef
seropts
Data type: String
See conman.conf man page
Default value: '9600,8n1'
ipmiopts
Data type: Optional[String]
See conman.conf man page
Default value: undef
Defined types
conman::console
Define a conman console
Examples
conman::console { 'compute01':
device => 'ipmi:bmc-compute01',
ipmiopts => 'U:admin,P:bmcpassword',
}
Parameters
The following parameters are available in the conman::console
defined type:
device
Data type: String
The console device, maps to dev
in conman.conf
log
Data type: Optional[String]
See conman.conf man page
Default value: undef
logopts
Data type: Optional[String]
See conman.conf man page
Default value: undef
seropts
Data type: Optional[String]
See conman.conf man page
Default value: undef
ipmiopts
Data type: Optional[String]
See conman.conf man page
Default value: undef
order
Data type: String
The order of where to insert file in conman.conf The default will order alphabetically by name
Default value: '50'
Change log
All notable changes to this project will be documented in this file. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
v1.0.1 (2021-05-07)
Fixed
v1.0.0 (2021-05-07)
Changed
v0.1.2 (2019-08-15)
Fixed
v0.1.1 (2019-08-15)
Fixed
v0.1.0 (2019-08-15)
Changed
- Make tcpwrappers optional as doesn't work on all operating systems #3 (treydock)
- Convert to PDK, modernize and update to match man page #1 (treydock)
Added
* This Changelog was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 4.25.0 <8.0.0)
- puppetlabs/concat (>= 4.0.0 <8.0.0)
- puppet/epel (>= 3.0.0 <4.0.0)
Copyright (C) 2016 <FULL NAME> <EMAIL> Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.