Forge Home

Modules

Puppet

Resources

PuppetEcosystemPuppet CommunityUpdates

ntp

NTP Module
Project URLRSS FeedReport issues

79,677,913 downloads

24,179 latest version

3.5 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 10.1.0 (latest)
  • 10.0.0
  • 9.2.2
  • 9.2.1
  • 9.2.0
  • 9.1.1
  • 9.1.0
  • 9.0.1
  • 9.0.0
  • 8.5.0
  • 8.4.0
  • 8.3.0
  • 8.2.0
  • 8.1.0
  • 8.0.0
  • 7.4.0
  • 7.3.0
  • 7.2.0
  • 7.1.1
  • 7.1.0
  • 7.0.0
  • 6.4.1
  • 6.4.0
  • 6.3.0
  • 6.2.0
  • 6.1.0
  • 6.0.0
  • 5.0.0
  • 4.2.0
  • 4.1.2
  • 4.1.1
  • 4.1.0
  • 4.0.0
  • 3.3.0
  • 3.2.1
  • 3.2.0
  • 3.1.2
  • 3.1.1
  • 3.1.0
  • 3.0.4
  • 3.0.3
  • 3.0.2
  • 3.0.1
  • 3.0.0
  • 3.0.0-rc1 (pre-release)
  • 2.0.1
  • 2.0.0
  • 2.0.0-rc1 (pre-release)
  • 1.0.1
  • 1.0.0
  • 1.0.0-rc1 (pre-release)
  • 0.3.0
  • 0.2.0
  • 0.1.0
  • 0.0.4
  • 0.0.3
released Oct 15th 2013

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'puppetlabs-ntp', '3.0.0-rc1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppetlabs-ntp
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppetlabs-ntp --version 3.0.0-rc1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download
Tags: debian, ubuntu, ntp, time, rhel, ntpd, archlinux, centos, gentoo, aix, ntpserver

Documentation

puppetlabs/ntp — version 3.0.0-rc1 Oct 15th 2013

#ntp

####Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with ntp
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

##Overview

The NTP module installs, configures, and manages the ntp service.

##Module Description

The NTP module handles running NTP across a range of operating systems and distributions. Where possible we use the upstream ntp templates so that the results closely match what you'd get if you modified the package default conf files.

##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 like which servers to use then you can use:

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 the ntp class to get at the full functionality.

###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'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'],
  manage_service => 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'],
  manage_service  => false,
  config_template => 'different/module/custom.template.erb',
}

##Reference

###Classes

  • ntp: Main class, includes all the rest.
  • 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 previously determined if the ntp module should be automatically updated to the latest version available. Replaced by package_ ensure.

####config

This sets the file to write ntp configuration into.

####config_template

This determines which template puppet should use for the ntp configuration.

####driftfile

This sets the location of the driftfile for ntp.

####keys_controlkey

Which of the keys is used as the control key.

####keys_enable

Should the ntp keys functionality be enabled.

####keys_file

Location of the keys file.

####keys_requestkey

Which of the keys is used as the request key.

####package_ensure

This can be set to 'present' or 'latest' or a specific version to choose the ntp package to be installed.

####package_name

This determines the name of the package to install.

####panic

This determines if ntp should 'panic' in the event of a very large clock skew. We set this to false if you're on a virtual machine by default 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

This sets the restrict options in the ntp configuration. The lines are preappended with restrict so you just need to list the rest of the restriction.

####servers

This selects the servers to use for ntp peers.

####service_enable

This determines if the service should be enabled at boot.

####service_ensure

This determines if the service should be running or not.

####service_manage

This selects if puppet should manage the service in the first place.

####service_name

This 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 2.7 and higher.

The module has been tested on:

  • RedHat Enterprise Linux 5/6
  • Debian 6/7
  • CentOS 5/6
  • Ubuntu 12.04
  • Gentoo
  • Arch Linux
  • FreeBSD

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.