![]() Change options: * panic - panic is not boolean, it is integer, actually Add options: * tinker - disable or enable tinker * minpoll - to change ntpd send packages frequency * maxpoll - to change ntpd send packages frequency * stepout - to change stepout interval Change-Id: I8da3a129227061bd436e5343dfcceb8eb7a3aca0 Link to upstream fix: https://tickets.puppetlabs.com/browse/MODULES-1925 Related-bug: #1430482 Related-bug: #1436373 |
||
---|---|---|
.. | ||
lib/puppet/parser/functions | ||
manifests | ||
spec | ||
templates | ||
tests | ||
.fixtures.yml | ||
.gitignore | ||
.nodeset.yml | ||
.sync.yml | ||
.travis.yml | ||
CHANGELOG.md | ||
CONTRIBUTING.md | ||
Gemfile | ||
LICENSE | ||
metadata.json | ||
Rakefile | ||
README.markdown |
#ntp
####Table of Contents
- Overview
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with ntp
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
##Overview
The ntp module installs, configures, and manages the NTP service.
##Module Description
The ntp module handles installing, configuring, and running NTP across a range of operating systems and distributions.
##Setup
###What ntp affects
- ntp package.
- ntp configuration file.
- ntp service.
###Beginning with ntp
include '::ntp'
is enough to get you up and running. If you wish to pass in
parameters specifying which servers to use, then:
class { '::ntp':
servers => [ 'ntp1.corp.com', 'ntp2.corp.com' ],
}
##Usage
All interaction with the ntp module can do be done through the main ntp class.
This means you can simply toggle the options in ::ntp
to have full functionality of the module.
###I just want NTP, what's the minimum I need?
include '::ntp'
###I just want to tweak the servers, nothing else.
class { '::ntp':
servers => [ 'ntp1.corp.com', 'ntp2.corp.com' ],
}
###I'd like to make sure I restrict who can connect as well.
class { '::ntp':
servers => [ 'ntp1.corp.com', 'ntp2.corp.com' ],
restrict => ['127.0.0.1'],
}
###I only want to listen on specific interfaces, not on 0.0.0.0
Restricting this is especially useful on Openstack nodes which may have numerous virtual interfaces.
class { '::ntp':
servers => [ 'ntp1.corp.com', 'ntp2.corp.com' ],
interfaces => ['127.0.0.1', '1.2.3.4']
}
###I'd like to opt out of having the service controlled; we use another tool for that.
class { '::ntp':
servers => [ 'ntp1.corp.com', 'ntp2.corp.com' ],
restrict => ['127.0.0.1'],
service_manage => false,
}
###Looks great! But I'd like a different template; we need to do something unique here.
class { '::ntp':
servers => [ 'ntp1.corp.com', 'ntp2.corp.com' ],
restrict => ['127.0.0.1'],
service_manage => false,
config_template => 'different/module/custom.template.erb',
}
##Reference
###Classes
####Public Classes
- ntp: Main class, includes all other classes.
####Private Classes
- ntp::install: Handles the packages.
- ntp::config: Handles the configuration file.
- ntp::service: Handles the service.
###Parameters
The following parameters are available in the ntp module:
####autoupdate
Deprecated: This parameter determined whether the ntp module should be
automatically updated to the latest version available. Replaced by package_ensure
.
####config
Sets the file that ntp configuration is written into.
####config_template
Determines which template Puppet should use for the ntp configuration.
####disable_monitor
Disables monitoring of ntp.
####driftfile
Sets the location of the drift file for ntp.
####iburst_enable
Set the iburst option in the ntp configuration. If enabled the option is set for every ntp peer.
####interfaces
Sets the list of interfaces NTP will listen on. This parameter must be an array.
####keys_controlkey
The key to use as the control key.
####keys_enable
Whether the ntp keys functionality is enabled.
####keys_file
Location of the keys file.
####keys_requestkey
Which of the keys is the request key.
keys_trusted
Array of trusted keys.
####package_ensure
Sets the ntp package to be installed. Can be set to 'present', 'latest', or a specific version.
####package_name
Determines the name of the package to install.
####panic
Determines if ntp should 'panic' in the event of a very large clock skew. This defaults to false for virtual machines, as they don't do a great job with keeping time.
####preferred_servers
List of ntp servers to prefer. Will append 'prefer' for any server in this list that also appears in the servers list.
####restrict
Sets the restrict options in the ntp configuration. The lines are prefixed with 'restrict', so you just need to list the rest of the restriction.
####servers
Selects the servers to use for ntp peers.
####service_enable
Determines if the service should be enabled at boot.
####service_ensure
Determines if the service should be running or not.
####service_manage
Selects whether Puppet should manage the service.
####service_name
Selects the name of the ntp service for Puppet to manage.
####udlc
Enables configs for undisciplined local clock, regardless of status as a virtual machine.
##Limitations
This module has been built on and tested against Puppet 3.
The module has been tested on:
- RedHat Enterprise Linux 5/6/7
- CentOS 5/6/7
- Oracle Enterprise Linux 5/6/7
- Scientific Linux 5/6/7
- SLES 10SP4/11SP1/12
- Debian 6/7
- Ubuntu 10.04/12.04/14.04
- Solaris 11
- AIX 5.3/6.1/7.1
Testing on other platforms has been light and cannot be guaranteed.
##Development
Puppet Labs modules on the Puppet Forge are open projects, and community contributions are essential for keeping them great. We can’t access the huge number of platforms and myriad of hardware, software, and deployment configurations that Puppet is intended to serve.
We want to keep it as easy as possible to contribute changes so that our modules work in your environment. There are a few guidelines that we need contributors to follow so that we can have a chance of keeping on top of things.
You can read the complete module contribution guide on the Puppet Labs wiki.
###Contributors
The list of contributors can be found at: https://github.com/puppetlabs/puppetlabs-ntp/graphs/contributors