Version information
This version is compatible with:
- Puppet Enterprise 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 < 7.0.0
- , , , , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'jorten-timezone', '0.1.0'
Learn more about managing modules with a PuppetfileDocumentation
timezone
Configures the system timezone.
Table of Contents
- Description
- Setup - The basics of getting started with timezone
- Usage - Configuration options and additional functionality
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Description
This module configures the system timezone.
Setup
What timezone affects
- Installs timezone package.
- Configures the system timezone.
- Configures whether the RTC is on UTC or local time.
Setup Requirements
- Supported OS with timezone package available in a configured package repository.
- puppetlabs/stdlib module.
Beginning with timezone
To configure the system timezone to UTC with the RTC set on UTC:
class { 'timezone':
timezone => 'UTC',
rtc_is_utc => true,
}
Usage
Configures the system for timezone UTC with RTC on UTC time.
class { 'timezone':
timezone => 'UTC',
rtc_is_utc => true,
}
Previous example but configured with data provided by hiera.
timezone::timezone: 'UTC'
timezone::rtc_is_utc: true
include timezone
Configures the system for timezone Europe/Stockholm with RTC on UTC time.
class { 'timezone':
timezone => 'Europe/Stockholm',
rtc_is_utc => true,
}
Previous example but configured with data provided by hiera.
timezone::timezone: 'Europe/Stockholm'
timezone::rtc_is_utc: true
include timezone
Limitations
Tested on CentOS 7, Debian 9, Fedora 29, SLES 15 and Ubuntu 18.04.
Development
All bugreports, suggestions and patches will be considered.
Reference
Table of Contents
Classes
timezone
: Configures the system timezone.
Classes
timezone
Configures the system timezone.
Examples
Configures the system for timezone UTC with RTC on UTC time.
class { 'timezone':
timezone => 'UTC',
rtc_is_utc => true,
}
Previous example but configured with data provided by hiera.
timezone::timezone: 'UTC'
timezone::rtc_is_utc: true
include timezone
Configures the system for timezone Europe/Stockholm with RTC on UTC time.
class { 'timezone':
timezone => 'Europe/Stockholm',
rtc_is_utc => true,
}
Previous example but configured with data provided by hiera.
timezone::timezone: 'Europe/Stockholm'
timezone::rtc_is_utc: true
include timezone
Parameters
The following parameters are available in the timezone
class.
timezone
Data type: Timezone::Timezone
Name of the timezone to configure.
rtc_is_utc
Data type: Boolean
Whether the RTC is on UTC time or local time.
package
Data type: String
Package to install.
timedatectl_cmd
Data type: Stdlib::Absolutepath
Command used to set the timezone.
timedatectl_chk
Data type: Stdlib::Absolutepath
Command used to test the current timezone setting.
setlocalrtc_cmd
Data type: Stdlib::Absolutepath
Command used to set if RTC is on UTC time or local time.
setlocalrtc_chk
Data type: Stdlib::Absolutepath
Command used to test the current setting of RTC.
Dependencies
- puppetlabs-stdlib (>= 4.13.0 < 6.0.0)