timezone

Configures the system timezone.

Table of Contents

1. Description
2. Setup - The basics of getting started with timezone
   • What timezone affects
   • Setup requirements
   • Beginning with timezone
3. Usage - Configuration options and additional functionality
4. Limitations - OS compatibility, etc.
5. 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.

Changelog

All notable changes to this project will be documented in this file.

Release 0.1.0

Features

• Configure the system timezone.
• Configure whether RTC is on UTC or on local time.

Bugfixes

Known Issues