Version information
released Mar 8th 2021
This version is compatible with:
- Puppet Enterprise 3.x
- Puppet >= 3.3.0 < 7.0.0
- , , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'ceritsc-serial_console', '0.9.13'
Learn more about managing modules with a PuppetfileDocumentation
ceritsc/serial_console — version 0.9.13 Mar 8th 2021
Puppet module for system serial console setup
This module configures system for serial console access (boot loader, kernel and login)
Requirements
Module has been tested on:
- Puppet 3.6
- OS:
- Debian 6,7,8,9
- RHEL/CentOS 6,7
Required modules:
- puppetlabs-stdlib
- herculesteam-augeasproviders_grub
Quick Start
Setup
include serial_console
Full configuration options:
class { 'serial_console':
enable => false|true, # enable configuration
enable_kernel => false|true, # enable kernel config.
enable_bootloader => false|true, # enable bootloader config.
enable_login => false|true, # enable login over serial config.
tty => '...', # text console name
ttys => '...', # serial device name without path, e.g. ttyS0
speed => ..., # serial port speed, e.g. 115200
term_type => ..., # serial terminal type, e.g. vt100
runlevels => '...', # run levels for login over serial
bootloader_timeout => '...' # bootloader timeout
logout_timeout => '...', # interactive session timeout
cmd_refresh_init => '...', # command to refresh init
cmd_refresh_bootloader => '...', # command to refresh bootloader
}
Facts
$::serialports, $::usbserialports
Returns list of available (USB) serial port device names (without /dev prefix). E.g.:
["ttyS0","ttyS1"]
$::grub1conf
Returns absolute path to GRUB 1 configuration file.
Contributors
- Steven Bakker steven.bakker@ams-ix.net
- Matthew Rásó-Barnett matthewrasobarnett@gmail.com
CERIT Scientific Cloud, support@cerit-sc.cz
2020-03-04 - Release 0.9.13
- Support Ubuntu 20.04
2020-02-03 - Release 0.9.12
- Support Debian 10
- Support Centos 8
2017-10-31 - Release 0.9.11
- Support Debian 9
2017-08-02 - Release 0.9.10
- Fix unupdated class serial_console::kernel::grubby
2017-07-21 - Release 0.9.9
- Fix autologout script template variable reference
2017-05-31 - Release 0.9.8
- Fix typos, quoting
- Classes calls simplifications
2015-09-15 - Release 0.9.7
Summary
Debian 8 and Puppet 4.x support. Facts as lists. Cleanups.
Features
- Support for new Debian 8 and updates for Puppet 4.x
- Support for getty terminal type
Bugfixes
- Better parameters validation
- Code cleanups
2015-03-02 - Release 0.9.6
Summary
Fix unquoted substitutions in /etc/default/grub.
Bugfixes
- Fix unquoted substitutions in /etc/default/grub to prevent Augeas parse errors.
2015-03-02 - Release 0.9.5
Summary
Change GRUB2 manipulation to kernel_parameter{}, allow to specify non-serial tty console output, code refactoring. Fix device names in $::usbserialports.
Features
- Change work with GRUB2 from augeas{} to kernel_parameter{}
- New option ($tty) to specify kernel console output to tty
Bugfixes
- Fix device names in fact $::usbserialports
2014-12-08 - Release 0.9.3
Summary
Fix file/directory permissions.
Bugfixes
- Fix PF module archive file/directory permissions.
2014-10-02 - Release 0.9.2
Summary
Remove deprecation warning on ERB
Bugfixes
- Remove deprevation warning from ERB
2014-09-02 - Release 0.9.1
Summary
Fix metadata.json
Bugfixes
- Fix metadata.json module dependencies
2014-08-28 - Release 0.9.0
Summary
Initial release.
Dependencies
- puppetlabs/stdlib (>= 4.0.0)
- herculesteam/augeasproviders_grub (>= 2.0.1)
The MIT License (MIT) Copyright (c) 2014-2015 CERIT-SC, Institute of Computer Science, Masaryk University Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.