diff --git a/CHANGELOG.md b/CHANGELOG.md index cf1b397..2c0919c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,539 +1,547 @@ # Change log All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](http://semver.org). -## [v9.0.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/v9.0.0) (2021-02-27) +## [v9.0.1](https://github.com/puppetlabs/puppetlabs-ntp/tree/v9.0.1) (2021-03-29) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/v9.0.0...v9.0.1) + +### Fixed + +- Allow setting user and group permissions of the NTP logfile [\#615](https://github.com/puppetlabs/puppetlabs-ntp/pull/615) ([Kristijan](https://github.com/Kristijan)) + +## [v9.0.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/v9.0.0) (2021-03-01) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/v8.5.0...v9.0.0) ### Changed - pdksync - Remove Puppet 5 from testing and bump minimal version to 6.0.0 [\#605](https://github.com/puppetlabs/puppetlabs-ntp/pull/605) ([carabasdaniel](https://github.com/carabasdaniel)) ## [v8.5.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/v8.5.0) (2020-12-16) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/v8.4.0...v8.5.0) ### Added - pdksync - \(feat\) - Add support for Puppet 7 [\#594](https://github.com/puppetlabs/puppetlabs-ntp/pull/594) ([daianamezdrea](https://github.com/daianamezdrea)) - \(MAINT\) Make mode for logfile configurable [\#590](https://github.com/puppetlabs/puppetlabs-ntp/pull/590) ([tmanninger](https://github.com/tmanninger)) - \(IAC-997\) Removal of inappropriate terminology [\#587](https://github.com/puppetlabs/puppetlabs-ntp/pull/587) ([pmcmaw](https://github.com/pmcmaw)) ## [v8.4.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/v8.4.0) (2020-09-11) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/v8.3.0...v8.4.0) ### Added - pdksync - \(IAC-973\) - Update travis/appveyor to run on new default branch `main` [\#579](https://github.com/puppetlabs/puppetlabs-ntp/pull/579) ([david22swan](https://github.com/david22swan)) - \(IAC-746\) - Add ubuntu 20.04 support [\#575](https://github.com/puppetlabs/puppetlabs-ntp/pull/575) ([david22swan](https://github.com/david22swan)) ## [v8.3.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/v8.3.0) (2020-04-01) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/v8.2.0...v8.3.0) ### Added - \(MAINT\) Add Solaris family Hiera data [\#554](https://github.com/puppetlabs/puppetlabs-ntp/pull/554) ([paescuj](https://github.com/paescuj)) - pdksync - \(FM-8581\) - Debian 10 added to travis and provision file refactored [\#552](https://github.com/puppetlabs/puppetlabs-ntp/pull/552) ([david22swan](https://github.com/david22swan)) - \(MODULES-10413\) Allow custom ntp user and daemon options [\#551](https://github.com/puppetlabs/puppetlabs-ntp/pull/551) ([david22swan](https://github.com/david22swan)) ## [v8.2.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/v8.2.0) (2019-12-09) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/v8.1.0...v8.2.0) ### Added - FM-8407 - Add support on Debian 10 [\#528](https://github.com/puppetlabs/puppetlabs-ntp/pull/528) ([lionce](https://github.com/lionce)) ## [v8.1.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/v8.1.0) (2019-09-23) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/v8.0.0...v8.1.0) ### Added - \(FM-8188\) convert ntp to use litmus [\#517](https://github.com/puppetlabs/puppetlabs-ntp/pull/517) ([tphoney](https://github.com/tphoney)) ### Fixed - Fix disable\_dhclient [\#521](https://github.com/puppetlabs/puppetlabs-ntp/pull/521) ([raphink](https://github.com/raphink)) ## [v8.0.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/v8.0.0) (2019-05-14) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/7.4.0...v8.0.0) ### Changed - pdksync - \(MODULES-8444\) - Raise lower Puppet bound [\#510](https://github.com/puppetlabs/puppetlabs-ntp/pull/510) ([david22swan](https://github.com/david22swan)) ### Fixed - Service hasstatus and hasrestart atributes [\#499](https://github.com/puppetlabs/puppetlabs-ntp/pull/499) ([ffapitalle](https://github.com/ffapitalle)) ## [7.4.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/7.4.0) (2019-02-01) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/7.3.0...7.4.0) ### Added - \(MODULES-8139\) - Add SLES 15 support [\#492](https://github.com/puppetlabs/puppetlabs-ntp/pull/492) ([eimlav](https://github.com/eimlav)) - \(MODULES-8098\) - Add logconfig option to config file [\#491](https://github.com/puppetlabs/puppetlabs-ntp/pull/491) ([eimlav](https://github.com/eimlav)) ### Fixed - \(FM-7719\) - Remove Amazon Linux and Arch Linux testing/support for ntp module [\#498](https://github.com/puppetlabs/puppetlabs-ntp/pull/498) ([david22swan](https://github.com/david22swan)) - pdksync - \(FM-7655\) Fix rubygems-update for ruby \< 2.3 [\#495](https://github.com/puppetlabs/puppetlabs-ntp/pull/495) ([tphoney](https://github.com/tphoney)) ## [7.3.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/7.3.0) (2018-09-27) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/7.2.0...7.3.0) ### Added - pdksync - \(MODULES-6805\) metadata.json shows support for puppet 6 [\#484](https://github.com/puppetlabs/puppetlabs-ntp/pull/484) ([tphoney](https://github.com/tphoney)) - Add burst param [\#476](https://github.com/puppetlabs/puppetlabs-ntp/pull/476) ([kobybr](https://github.com/kobybr)) - \(MODULES-7465\) Addition of support for Ubuntu 18.04 to NTP [\#475](https://github.com/puppetlabs/puppetlabs-ntp/pull/475) ([david22swan](https://github.com/david22swan)) ## [7.2.0](https://github.com/puppetlabs/puppetlabs-ntp/tree/7.2.0) (2018-07-03) [Full Changelog](https://github.com/puppetlabs/puppetlabs-ntp/compare/7.1.1...7.2.0) ### Changed - \(FM-6955\) Remove unsupported OS: F24, F25, Debian 7 [\#462](https://github.com/puppetlabs/puppetlabs-ntp/pull/462) ([david22swan](https://github.com/david22swan)) ### Added - Add SLES 15 hiera data [\#472](https://github.com/puppetlabs/puppetlabs-ntp/pull/472) ([mattiasgiese](https://github.com/mattiasgiese)) - \(FM-7038\) Add support for Debian 9 [\#470](https://github.com/puppetlabs/puppetlabs-ntp/pull/470) ([david22swan](https://github.com/david22swan)) - add tos\_orphan parameter [\#452](https://github.com/puppetlabs/puppetlabs-ntp/pull/452) ([disklord](https://github.com/disklord)) ### Fixed - \(MODULES-6363\) fix disabling dhclient on redhat-derivatives [\#439](https://github.com/puppetlabs/puppetlabs-ntp/pull/439) ([sudodevnull](https://github.com/sudodevnull)) ## 7.1.1 ### Summary This release includes updated Japanese translations. ### Added - Updating translations for readmes/README_ja_JP.md ## 7.1.0 ### Summary This release uses the PDK convert functionality which in return makes the module PDK compliant. It also includes one feature and a roll up of maintenance changes. ### Added - PDK convert ntp ([MODULES-6326](https://tickets.puppet.com/browse/MODULES-6326)). - Create parameter for slewalways to be exposed in the ntp.conf template. ### Fixed - `is_virtual` fact is boolean and cant be given to str2bool. - Don't use 'inherits' in config, install and service. - Roll up of modulesync changes. - Make documentation more readable. - Fix up rubocop errors ([FM-6634](https://tickets.puppet.com/browse/FM-6634)). - Strip data types out of puppet-strings comments. ## 7.0.0 ### Summary Hiera 5 only works with Puppet 4.9.4 and above, we have bumped the Puppet requirement for the module accordingly. ### Changed - Update YAML to version 5 ([PR 428](https://github.com/puppetlabs/puppetlabs-ntp/pull/428)) - Updates the lower puppet version boundary to 4.9.4. ## 6.4.1 ### Summary This release reverts a PR that implements Hiera 5. Issues have been seen due to compatibility issues. The issues that have been seen are ([MODULES-5775](https://tickets.puppet.com/browse/MODULES-5775)) and ([MODULES-5780](https://tickets.puppet.com/browse/MODULES-5780)). ### Changed - Reverts ([PR 394](https://github.com/puppetlabs/puppetlabs-ntp/pull/394)) ## 6.4.0 ### Summary This release is to both update the modules code so that it matches the set standards and make it so that all future prs are checked by Rubocop before release. #### Added - Rubocop is now enabled. #### Changed - All ruby code within module has been altered to match standards. ## 6.3.0 ### Summary This is a feature release with some bugfixes and updated Japanese translations, too. #### Added - `enable_mode7` parameter (defaults to `false`) - disable monitor availability while setting stat properties #### Changed - Lower bound of Puppet requirement from 4.5.0 to 4.7.0 - hiera.yaml to Hiera version 5 format #### Removed - Ubuntu 10.04 and 12.04, Debian 6, SLES 10 SP4, and Fedora 20-23 support from metadata.json (existing compatibility remains) #### Fixed - Path to driftfile on Suse ([MODULES-4941](https://tickets.puppet.com/browse/MODULES-4941)) - Whitespace issue in ntp.conf.epp with `tos` - Permissions on keys file ## 6.2.0 ### Summary This is a small minor release that adds the `pool` parameter and revises some Japanese translations. #### Added - The `pool` parameter #### Fixed - Japanese translations for the README ## 6.1.0 ### Summary This release adds support for internationalization of the module. It also contains Japanese translations for the README, summary and description of the metadata.json and major cleanups in the README. Additional folders have been introduced called locales and readmes where translation files can be found. A number of features and bug fixes are also included in this release. #### Features - Addition of POT file for metadata translation for i18n. - Multiple Gemfile updates for Ruby and Gems support. - (MODULES-4225) Addition of Puppet strings to the ntp module. - Implements beaker module install helper and cleanup spec helper acceptance.rb. - (MODULES-4414) Allow NTP statistics if requested. - (MODULES-4278) Addition of noselect feature. - Addition of 'pool' parameter. - Addition of Ubuntu Xenial Support. #### Bugfixes - Huge readme updates for adding tags to private classes, edits for localization and general cleanups. - (MODULES-3397) Fix of the default Solaris settings. - Changed 'service_ensure' data type to Enum. - (MODULES-3396) remove superfluous empty lines in ntp.conf. - (MODULES-4528) Replace Puppet.version.to_f version comparison from spec helper. - Solaris data that was the wrong way round now fixed. ##s 5.0.0 and 6.0.0 ### Summary This double release adds new Puppet 4 features: data in modules, EPP templates, the $facts hash, and data types. The 5.0.0 release is fully backwards compatible to existing Puppet 4 configurations and provides you with [deprecation warnings](https://github.com/puppetlabs/puppetlabs-stdlib#deprecation) for every argument that will not work as expected with the final 6.0.0 release. See the [stdlib docs](https://github.com/puppetlabs/puppetlabs-stdlib#validate_legacy) for an in-depth discussion of this. If you want to learn more about the new features used, have a look at the [NTP: A Puppet 4 language update](https://puppet.com/blog/ntp-puppet-4-language-update) blog post. If you're still running Puppet 3, remain on the latest puppetlabs-ntp 4.x release for now, and see the documentation to [upgrade to Puppet 4](https://docs.puppet.com/puppet/4.6/reference/upgrade_major_pre.html). ### Changes * [Data in modules](https://docs.puppet.com/puppet/latest/reference/lookup_quick_module.html#example-with-hiera): Moves all distribution and OS-dependent defaults into YAML files in `data/`, alleviating the need for a `params` class. Note that while this feature is currently still classed as experimental, the final implementation will support the changes here. * [EPP templating](https://docs.puppet.com/puppet/latest/reference/lang_template_epp.html): Uses the Puppet language as a base for templates to create simpler and safer templates. No need for Ruby anymore! You can pass in EPP templates for the `ntp.conf` and `step-tickers` files using the new `config_epp` and `step_tickers_epp` parameters. * [The $facts hash](https://docs.puppet.com/puppet/latest/reference/lang_facts_and_builtin_vars.html#the-factsfactname-hash): Makes facts visibly distinct from other variables for more readable and maintainable code. This helps eliminate confusion if you use a local variable whose name happens to match that of a common fact. * [Data types for validation](https://docs.puppet.com/puppet/4.6/reference/lang_data.html): Helps you find and replace deprecated code in existing `validate_*` functions with stricter, more readable data type notation. First upgrade to the 5.0.0 release of this module, and address all deprecation warnings before upgrading to the final 6.0.0 release. Please see the [stdlib docs](https://github.com/puppetlabs/puppetlabs-stdlib#validate_legacy) for an in-depth discussion of this process. ## 4.2.0 ### Summary A large release with many new features. Multiple additions to parameters and work contributed to OS compatibility. Also includes several bug fixes, including clean ups of code. #### Features - Updated spec helper for more consistency - Addition of config_dir variable - Addition of puppet TOS options - Added support for disabling kernel time discipline in ntp.conf - Update Solaris support for newer Facter, and Amazon for < 1.7.0 facter - Added disable_dhclient parameter - Added OpenSUSE 13.2 compatibility - Parameterize file mode of config file - Enhanced the default configuration - Debian 8 compatibility - Enabled usage of the $ntpsigndsocket parameter - Added parameter for interfaces to ignore - Added support for the authprov parameter - Additional work done for SLES 12 compatibility - Addition of key template options/ key distribution #### Bugfixes - Fix for strict variables and tests - Fixed test with preferred server and iburst enabled - Added logfile parameter test - Cleaned out unused cleanup code and utilities from spec_helper - Deprecated ntp_dirname function - No longer manages the keys_file parent when it would be inappropriate to do so - Converted license string to SPDX format - Removed ruby 1.8.7 and puppet 2.7 from travis-ci jobs ## 4.1.2 ###Summary Small release for support of newer PE versions. This increments the version of PE in the metadata.json file. ## 4.1.1 ### Summary This is a bugfix release to address security vulnerability CVE-2013-5211. #### Bugfixes - Changes the default behavior to disable monitoring as part of the solution for CVE-2013-5211. ## 2015-07-21 - Supported Release 4.1.0 ### Summary This release updates metadata to support new version of puppet enterprise, as well as new features, bugfixes, and test improvements. #### Features - Adds Solaris 10 support - Adds Fedora 20, 21, 22 compatibility #### Bugfixes - Fix default configuration for Debian (MODULES-2087) - Fix to ensure log file is created before service starts - Fixes SLES params for SLES 10, 11, 12 ## 2015-05-26 - Supported Release 4.0.0 ### Summary This release drops puppet 2.7 support and older stdlib support. It also includes the addition of 12 new properties, as well as numerous bug fixes and other improvements. #### Backwards-incompatible changes - UDLC (Undisciplined local clock) is now no longer enabled by default on anything (previous was enabled on non-virtual). - Puppet 2.7 no longer supported - puppetlabs-stdlib less than 4.5.0 no longer supported #### Features - Readme, Metadata, and Contribution documentation improvements - Acceptance test improvements - Added the `broadcastclient` property - Added the `disable_auth` property - Added `broadcastclient` property - Added `disable_auth` property - Added `fudge` property - Added `peers` property - Added `udlc_stratum` property - Added `tinker` property - Added `minpoll` property - Added `maxpoll` property - Added `stepout` property - Added `leapfile` property #### Bugfixes - Removing equal sign as delimiter in ntp.conf for the logfile parameter. - Add package_manage parameter, which is set to false by default on FreeBSD - Fixed an issue with the `is_virtual` property - Fixed debian wheezy issue - Fix for Redhat to disable ntp restart due to dhcp ntp server updates ##2014-11-04 - Supported Release 3.3.0 ###Summary This release adds support for SLES 12. ####Features - Added support for SLES 12 ##2014-10-02 - Supported Release 3.2.1 ###Summary This is a bug-fix release addressing the security concerns of setting /etc/ntp to mode 0755 recursively. ####Bugfixes - Do not recursively set ownership/mode of /etc/ntp ##2014-09-10 - Supported Release 3.2.0 ###Summary This is primarily a feature release. It adds a few new parameters to class `ntp` and adds support for Solaris 11. ####Features - Add the `$interfaces` parameter to `ntp` - Add support for Solaris 10 and 11 - Synchronized files with modulesync - Test updates - Add the `$iburst_enable` parameter to `ntp` ####Bugfixes - Fixes for strict variables - Remove dependency on stdlib4 ##2014-06-06 - Release 3.1.2 ###Summary This is a supported release. This release fixes a manifest typo. ##2014-06-06 - Release 3.1.1 ###Summary This is a bugfix release to get around dependency issues in PMT 3.6. This version has a dependency on puppetlabs-stdlib >= 4 so PE3.2.x is no longer supported. ####Bugfixes - Remove deprecated Modulefile as it was causing duplicate dependencies with PMT. ##2014-05-14 - Release 3.1.0 ###Summary This release adds `disable_monitor` so you can disable the monitor functionality of NTP, which was recently used in NTP amplification attacks. It also adds support for RHEL7 and Ubuntu 14.04. ####Features - Add `disable_monitor` ####Bugfixes #####Known Bugs * No known bugs ##2014-04-09 - Supported Release 3.0.4 ###Summary This is a supported release. The only functional change in this release is to split up the restrict defaults to be per operating system so that we can provide safer defaults for AIX, to resolve cases where IPv6 are disabled. ####Features - Rework restrict defaults. ####Bugfixes - Fix up a comment. - Fix a test to work better on PE. #####Known Bugs * No known bugs ##2014-03-04 - Supported Release 3.0.3 ###Summary This is a supported release. Correct stdlib compatibility ####Bugfixes - Remove `dirname()` call for correct stdlib compatibility. - Improved tests ####Known Bugs * No known bugs ## 2014-02-13 - Release 3.0.2 ###Summary No functional changes: Update the README and allow custom gem sources. ## 2013-12-17 - Release 3.0.1 ### Summary Work around a packaging bug with symlinks, no other functional changes. ## 2013-12-13 - Release 3.0.0 ### Summary Final release of 3.0, enjoy! ## 2013-10-14 - Version 3.0.0-rc1 ###Summary This release changes the behavior of restrict and adds AIX osfamily support. ####Backwards-incompatible Changes: `restrict` no longer requires you to pass in parameters as: restrict => [ 'restrict x', 'restrict y' ] but just as: restrict => [ 'x', 'y' ] As the template now prefixes each line with restrict. ####Features - Change the behavior of `restrict` so you no longer need the restrict keyword. - Add `udlc` parameter to enable undisciplined local clock regardless of the machines status as a virtual machine. - Add AIX support. ####Fixes - Use class{} instead of including and then anchoring. (style) - Extend Gentoo coverage to Facter 1.7. --- ##2013-09-05 - Version 2.0.1 ###Summary Correct the LICENSE file. ####Bugfixes - Add in the appropriate year and name in LICENSE. ##2013-07-31 - Version 2.0.0 ###Summary The 2.0 release focuses on merging all the distro specific templates into a single reusable template across all platforms. To aid in that goal we now allow you to change the driftfile, ntp keys, and perferred_servers. ####Backwards-incompatible changes As all the distro specific templates have been removed and a unified one created you may be missing functionality you previously relied on. Please test carefully before rolling out globally. Configuration directives that might possibly be affected: - `filegen` - `fudge` (for virtual machines) - `keys` - `logfile` - `restrict` - `restrictkey` - `statistics` - `trustedkey` ####Features: - All templates merged into a single template. - NTP Keys support added. - Add preferred servers support. - Parameters in `ntp` class: - `driftfile`: path for the ntp driftfile. - `keys_enable`: Enable NTP keys feature. - `keys_file`: Path for the NTP keys file. - `keys_trusted`: Which keys to trust. - `keys_controlkey`: Which key to use for the control key. - `keys_requestkey`: Which key to use for the request key. - `preferred_servers`: Array of servers to prefer. - `restrict`: Array of restriction options to apply. --- ###2013-07-15 - Version 1.0.1 ####Bugfixes - Fix deprecated warning in `autoupdate` parameter. - Correctly quote is_virtual fact. ##2013-07-08 - Version 1.0.0 ####Features - Completely refactored to split across several classes. - rspec-puppet tests rewritten to cover more options. - rspec-system tests added. - ArchLinux handled via osfamily instead of special casing. - parameters in `ntp` class: - `autoupdate`: deprecated in favor of directly setting package_ensure. - `panic`: set to false if you wish to allow large clock skews. --- ##2011-11-10 Dan Bode - 0.0.4 * Add Amazon Linux as a supported platform * Add unit tests ##2011-06-16 Jeff McCune - 0.0.3 * Initial release under puppetlabs \* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)* diff --git a/REFERENCE.md b/REFERENCE.md index b91fe41..bceaf23 100644 --- a/REFERENCE.md +++ b/REFERENCE.md @@ -1,554 +1,575 @@ # Reference ## Table of Contents ### Classes #### Public Classes -* [`ntp`](#ntp) +* [`ntp`](#ntp): ntp Main class, includes all other classes. #### Private Classes * `ntp::config`: This class handles the configuration file. * `ntp::install`: This class handles ntp packages. * `ntp::service`: This class handles the ntp service. ### Data types * [`Ntp::Key_id`](#ntpkey_id): See http://doc.ntp.org/4.2.6/authopt.html#controlkey for documentation Alternatively: type Ntp::Key_id = Variant[Integer, Pattern['']] * [`Ntp::Poll_interval`](#ntppoll_interval): See http://doc.ntp.org/4.2.6/clockopt.html#server for documentation Alternatively: type Ntp::Poll_interval = Variant[Integer, Pattern['']] ## Classes ### `ntp` -The ntp class. +ntp + +Main class, includes all other classes. #### Parameters The following parameters are available in the `ntp` class: +* [`authprov`](#authprov) +* [`broadcastclient`](#broadcastclient) +* [`burst`](#burst) +* [`config`](#config) +* [`config_dir`](#config_dir) +* [`config_epp`](#config_epp) +* [`config_file_mode`](#config_file_mode) +* [`config_template`](#config_template) +* [`daemon_extra_opts`](#daemon_extra_opts) +* [`disable_auth`](#disable_auth) +* [`disable_dhclient`](#disable_dhclient) +* [`disable_kernel`](#disable_kernel) +* [`disable_monitor`](#disable_monitor) +* [`driftfile`](#driftfile) +* [`enable_mode7`](#enable_mode7) +* [`fudge`](#fudge) +* [`iburst_enable`](#iburst_enable) +* [`interfaces`](#interfaces) +* [`interfaces_ignore`](#interfaces_ignore) +* [`keys`](#keys) +* [`keys_controlkey`](#keys_controlkey) +* [`keys_enable`](#keys_enable) +* [`keys_file`](#keys_file) +* [`keys_requestkey`](#keys_requestkey) +* [`keys_trusted`](#keys_trusted) +* [`leapfile`](#leapfile) +* [`logfile`](#logfile) +* [`logfile_group`](#logfile_group) * [`logfile_mode`](#logfile_mode) +* [`logfile_user`](#logfile_user) * [`logconfig`](#logconfig) * [`minpoll`](#minpoll) * [`maxpoll`](#maxpoll) * [`ntpsigndsocket`](#ntpsigndsocket) * [`package_ensure`](#package_ensure) * [`package_manage`](#package_manage) * [`package_name`](#package_name) * [`panic`](#panic) * [`peers`](#peers) * [`tos_orphan`](#tos_orphan) * [`pool`](#pool) * [`preferred_servers`](#preferred_servers) * [`noselect_servers`](#noselect_servers) * [`restrict`](#restrict) * [`servers`](#servers) * [`service_enable`](#service_enable) * [`service_ensure`](#service_ensure) * [`service_manage`](#service_manage) * [`service_name`](#service_name) * [`service_provider`](#service_provider) * [`service_hasstatus`](#service_hasstatus) * [`service_hasrestart`](#service_hasrestart) * [`slewalways`](#slewalways) * [`statistics`](#statistics) * [`statsdir`](#statsdir) * [`step_tickers_file`](#step_tickers_file) * [`step_tickers_epp`](#step_tickers_epp) * [`step_tickers_template`](#step_tickers_template) * [`stepout`](#stepout) * [`tos`](#tos) * [`tos_minclock`](#tos_minclock) * [`tos_maxclock`](#tos_maxclock) * [`tos_minsane`](#tos_minsane) * [`tos_floor`](#tos_floor) * [`tos_ceiling`](#tos_ceiling) * [`tos_cohort`](#tos_cohort) * [`tinker`](#tinker) * [`udlc`](#udlc) * [`udlc_stratum`](#udlc_stratum) * [`user`](#user) -* [`broadcastclient`](#broadcastclient) -* [`burst`](#burst) -* [`config`](#config) -* [`config_dir`](#config_dir) -* [`config_file_mode`](#config_file_mode) -* [`config_epp`](#config_epp) -* [`config_template`](#config_template) -* [`disable_auth`](#disable_auth) -* [`disable_dhclient`](#disable_dhclient) -* [`disable_kernel`](#disable_kernel) -* [`disable_monitor`](#disable_monitor) -* [`enable_mode7`](#enable_mode7) -* [`fudge`](#fudge) -* [`driftfile`](#driftfile) -* [`leapfile`](#leapfile) -* [`logfile`](#logfile) -* [`iburst_enable`](#iburst_enable) -* [`keys`](#keys) -* [`keys_enable`](#keys_enable) -* [`keys_file`](#keys_file) -* [`keys_controlkey`](#keys_controlkey) -* [`keys_requestkey`](#keys_requestkey) -* [`keys_trusted`](#keys_trusted) -* [`interfaces`](#interfaces) -* [`interfaces_ignore`](#interfaces_ignore) -* [`authprov`](#authprov) -* [`daemon_extra_opts`](#daemon_extra_opts) + +##### `authprov` + +Data type: `Optional[String]` + +Enables compatibility with W32Time in some versions of NTPd (such as Novell DSfW). Default value: undef. + +##### `broadcastclient` + +Data type: `Boolean` + +Enables reception of broadcast server messages to any local interface. Default value: false. + +##### `burst` + +Data type: `Boolean` + +When the server is reachable, send a burst of eight packets instead of the usual one. Default value: false. + +##### `config` + +Data type: `Stdlib::Absolutepath` + +Specifies a file for NTP's configuration info. Default value: '/etc/ntp.conf' (or '/etc/inet/ntp.conf' on Solaris). + +##### `config_dir` + +Data type: `Optional[Stdlib::Absolutepath]` + +Specifies a directory for the NTP configuration files. Default value: undef. + +##### `config_epp` + +Data type: `Optional[String]` + +Specifies an absolute or relative file path to an EPP template for the config file. +Example value: 'ntp/ntp.conf.epp'. A validation error is thrown if both this **and** the `config_template` parameter are specified. + +##### `config_file_mode` + +Data type: `String` + +Specifies a file mode for the ntp configuration file. Default value: '0664'. + +##### `config_template` + +Data type: `Optional[String]` + +Specifies an absolute or relative file path to an ERB template for the config file. +Example value: 'ntp/ntp.conf.erb'. A validation error is thrown if both this **and** the `config_epp` parameter are specified. + +##### `daemon_extra_opts` + +Data type: `Optional[String]` + +Specifies any arguments to pass to ntp daemon. Default value: '-g'. +Example value: '-g -i /var/lib/ntp' to enable jaildir options. +Note that user is a specific parameter handled separately. + +##### `disable_auth` + +Data type: `Boolean` + +Disables cryptographic authentication for broadcast client, multicast client, and symmetric passive associations. + +##### `disable_dhclient` + +Data type: `Boolean` + +Disables `ntp-servers` in `dhclient.conf` to prevent Dhclient from managing the NTP configuration. + +##### `disable_kernel` + +Data type: `Boolean` + +Disables kernel time discipline. + +##### `disable_monitor` + +Data type: `Boolean` + +Disables the monitoring facility in NTP. Default value: true. + +##### `driftfile` + +Data type: `Stdlib::Absolutepath` + +Specifies an NTP driftfile. Default value: '/var/lib/ntp/drift' (except on AIX and Solaris). + +##### `enable_mode7` + +Data type: `Boolean` + +Enables processing of NTP mode 7 implementation-specific requests which are used by the deprecated ntpdc program. Default value: false. + +##### `fudge` + +Data type: `Optional[Array[String]]` + +Provides additional information for individual clock drivers. Default value: [ ] + +##### `iburst_enable` + +Data type: `Boolean` + +Specifies whether to enable the iburst option for every NTP peer. Default value: false (true on AIX and Debian). + +##### `interfaces` + +Data type: `Array[String]` + +Specifies one or more network interfaces for NTP to listen on. Default value: [ ]. + +##### `interfaces_ignore` + +Data type: `Array[String]` + +Specifies one or more ignore pattern for the NTP listener configuration (for example: all, wildcard, ipv6). Default value: [ ]. + +##### `keys` + +Data type: `Array[String]` + +Distributes keys to keys file. Default value: [ ]. + +##### `keys_controlkey` + +Data type: `Optional[Ntp::Key_id]` + +Specifies the key identifier to use with the ntpq utility. Value in the range of 1 to 65,534 inclusive. Default value: ' '. + +##### `keys_enable` + +Data type: `Boolean` + +Whether to enable key-based authentication. Default value: false. + +##### `keys_file` + +Data type: `Stdlib::Absolutepath` + +Specifies the complete path and location of the MD5 key file containing the keys and key identifiers used by ntpd, ntpq and ntpdc +when operating with symmetric key cryptography. Default value: `/etc/ntp.keys` (on RedHat and Amazon, `/etc/ntp/keys`). + +##### `keys_requestkey` + +Data type: `Optional[Ntp::Key_id]` + +Specifies the key identifier to use with the ntpdc utility program. Value in the range of 1 to 65,534. Default value: ' '. + +##### `keys_trusted` + +Data type: `Optional[Array[Ntp::Key_id]]` + +Provides one or more keys to be trusted by NTP. Default value: [ ]. + +##### `leapfile` + +Data type: `Optional[Stdlib::Absolutepath]` + +Specifies a leap second file for NTP to use. Default value: ' '. + +##### `logfile` + +Data type: `Optional[Stdlib::Absolutepath]` + +Specifies a log file for NTP to use instead of syslog. Default value: ' '. + +##### `logfile_group` + +Data type: `Optional[Variant[String, Integer]]` + +Specifies the group for the NTP log file. Default is 'ntp'. ##### `logfile_mode` Data type: `String` Specifies the permission for the NTP log file. Default is 0664. +##### `logfile_user` + +Data type: `Optional[Variant[String, Integer]]` + +Specifies the user for the NTP log file. Default is 'ntp'. + ##### `logconfig` Data type: `Optional[String]` Specifies the logconfig for NTP to use. Default value: ' '. ##### `minpoll` Data type: `Optional[Ntp::Poll_interval]` Sets Puppet to non-standard minimal poll interval of upstream servers. Values: 3 to 16. Default: undef. ##### `maxpoll` Data type: `Optional[Ntp::Poll_interval]` Sets use non-standard maximal poll interval of upstream servers. Values: 3 to 16. Default option: undef, except on FreeBSD (on FreeBSD, defaults to 9). ##### `ntpsigndsocket` Data type: `Optional[Stdlib::Absolutepath]` Sets NTP to sign packets using the socket in the ntpsigndsocket path. Requires NTP to be configured to sign sockets. Value: Path to the socket directory; for example, for Samba: `usr/local/samba/var/lib/ntp_signd/`. Default value: undef. ##### `package_ensure` Data type: `String` Whether to install the NTP package, and what version to install. Values: 'present', 'latest', or a specific version number. Default value: 'present'. ##### `package_manage` Data type: `Boolean` Whether to manage the NTP package. Default value: true. ##### `package_name` Data type: `Array[String]` Specifies the NTP package to manage. Default value: ['ntp'] (except on AIX and Solaris). ##### `panic` Data type: `Optional[Integer[0]]` Whether NTP should "panic" in the event of a very large clock skew. Applies only if `tinker` option set to true or if your environment is in a virtual machine. Default value: 0 if environment is virtual, undef in all other cases. ##### `peers` Data type: `Array[String]` List of NTP servers with which to synchronise the local clock. ##### `tos_orphan` Data type: `Optional[Integer[1]]` Enables Orphan mode for peer group Value: Should be set to 2 more than the worst-case externally-reachable source's stratum. ##### `pool` Data type: `Optional[Array[String]]` List of NTP server pools with which to synchronise the local clock. ##### `preferred_servers` Data type: `Array[String]` Specifies one or more preferred peers. Puppet appends 'prefer' to each matching item in the `servers` array. Default value: [ ]. ##### `noselect_servers` Data type: `Array[String]` Specifies one or more peers to not sync with. Puppet appends 'noselect' to each matching item in the `servers` array. Default value: [ ]. ##### `restrict` Data type: `Array[String]` Specifies one or more `restrict` options for the NTP configuration. Puppet prefixes each item with 'restrict', so you need to list only the content of the restriction. Default value for most operating systems: '[default kod nomodify notrap nopeer noquery', '-6 default kod nomodify notrap nopeer noquery', '127.0.0.1', '-6 ::1']'. Default value for AIX systems: '['default nomodify notrap nopeer noquery', '127.0.0.1',]'. ##### `servers` Data type: `Array[String]` Specifies one or more servers to be used as NTP peers. Default value: varies by operating system. ##### `service_enable` Data type: `Boolean` Whether to enable the NTP service at boot. Default value: true. ##### `service_ensure` Data type: `Enum['running', 'stopped']` Whether the NTP service should be running. Default value: 'running'. ##### `service_manage` Data type: `Boolean` Whether to manage the NTP service. Default value: true. ##### `service_name` Data type: `String` The NTP service to manage. Default value: varies by operating system. ##### `service_provider` Data type: `Optional[String]` Which service provider to use for NTP. Default value: 'undef'. ##### `service_hasstatus` Data type: `Boolean` Whether service has a functional status command. Default value: true. ##### `service_hasrestart` Data type: `Boolean` Whether service has a restart command. Default value: true. ##### `slewalways` Data type: `Optional[Enum['yes','no']]` xntpd setting to disable stepping behavior and always slew the clock to handle adjustments. Only relevant for AIX. Default value: 'undef'. Allowed values: 'yes', 'no' ##### `statistics` Data type: `Optional[Array]` List of statistics to have NTP generate and keep. Default value: [ ]. ##### `statsdir` Data type: `Optional[Stdlib::Absolutepath]` Location of the NTP statistics directory on the managed system. Default value: '/var/log/ntpstats'. ##### `step_tickers_file` Data type: `Optional[Stdlib::Absolutepath]` Location of the step tickers file on the managed system. Default value: varies by operating system. ##### `step_tickers_epp` Data type: `Optional[String]` Location of the step tickers EPP template file. Default value: varies by operating system. Validation error is thrown if both this and the `step_tickers_template` parameters are specified. ##### `step_tickers_template` Data type: `Optional[String]` Location of the step tickers ERB template file. Default value: varies by operating system. Validation error is thrown if both this and the `step_tickers_epp` parameter are specified. ##### `stepout` Data type: `Optional[Integer[0, 65535]]` Value for stepout if `tinker` value is true. Valid options: unsigned shortint digit. Default value: undef. ##### `tos` Data type: `Boolean` Whether to enable tos options. Default value: false. ##### `tos_minclock` Data type: `Optional[Integer[1]]` Specifies the minclock tos option. Default value: 3. ##### `tos_maxclock` Data type: `Optional[Integer[1]]` Specifies the maxclock tos option. Default value: 6. ##### `tos_minsane` Data type: `Optional[Integer[1]]` Specifies the minsane tos option. Default value: 1. ##### `tos_floor` Data type: `Optional[Integer[1]]` Specifies the floor tos option. Default value: 1. ##### `tos_ceiling` Data type: `Optional[Integer[1]]` Specifies the ceiling tos option. Default value: 15. ##### `tos_cohort` Data type: `Variant[Boolean, Integer[0,1]]` Specifies the cohort tos option. Valid options: 0 or 1. Default value: 0. ##### `tinker` Data type: `Optional[Boolean]` Whether to enable tinker options. Default value: false. ##### `udlc` Data type: `Boolean` Specifies whether to configure NTP to use the undisciplined local clock as a time source. Default value: false. ##### `udlc_stratum` Data type: `Optional[Integer[1,15]]` Specifies the stratum the server should operate at when using the undisciplined local clock as the time source. This value should be set to no less than 10 if ntpd might be accessible outside your immediate, controlled network. Default value: 10.am udlc ##### `user` Data type: `Optional[String]` Specifies user to run ntpd daemon. Default value: ntp. Usually set by default on Centos7 (/etc/systemd/system/multi-user.target.wants/ntpd.service) and ubuntu 18.04 (/usr/lib/ntp/ntp-systemd-wrapper) This is currently restricted to Redhat based systems of version 7 and above and Ubuntu 18.04. -##### `broadcastclient` - -Data type: `Boolean` - - - -##### `burst` - -Data type: `Boolean` - - - -##### `config` - -Data type: `Stdlib::Absolutepath` - - - -##### `config_dir` - -Data type: `Optional[Stdlib::Absolutepath]` - - - -##### `config_file_mode` - -Data type: `String` - - - -##### `config_epp` - -Data type: `Optional[String]` - - - -##### `config_template` - -Data type: `Optional[String]` - - - -##### `disable_auth` - -Data type: `Boolean` - - - -##### `disable_dhclient` - -Data type: `Boolean` - - - -##### `disable_kernel` - -Data type: `Boolean` - - - -##### `disable_monitor` - -Data type: `Boolean` - - - -##### `enable_mode7` - -Data type: `Boolean` - - - -##### `fudge` - -Data type: `Optional[Array[String]]` - - - -##### `driftfile` - -Data type: `Stdlib::Absolutepath` - - - -##### `leapfile` - -Data type: `Optional[Stdlib::Absolutepath]` - - - -##### `logfile` - -Data type: `Optional[Stdlib::Absolutepath]` - - - -##### `iburst_enable` - -Data type: `Boolean` - - - -##### `keys` - -Data type: `Array[String]` - - - -##### `keys_enable` - -Data type: `Boolean` - - - -##### `keys_file` - -Data type: `Stdlib::Absolutepath` - - - -##### `keys_controlkey` - -Data type: `Optional[Ntp::Key_id]` - - - -##### `keys_requestkey` - -Data type: `Optional[Ntp::Key_id]` - - - -##### `keys_trusted` - -Data type: `Optional[Array[Ntp::Key_id]]` - - - -##### `interfaces` - -Data type: `Array[String]` - - - -##### `interfaces_ignore` - -Data type: `Array[String]` - - - -##### `authprov` - -Data type: `Optional[String]` - - - -##### `daemon_extra_opts` - -Data type: `Optional[String]` - - - ## Data types ### `Ntp::Key_id` See http://doc.ntp.org/4.2.6/authopt.html#controlkey for documentation Alternatively: type Ntp::Key_id = Variant[Integer, Pattern['']] Alias of ```puppet Integer[1, 65534] ``` ### `Ntp::Poll_interval` See http://doc.ntp.org/4.2.6/clockopt.html#server for documentation Alternatively: type Ntp::Poll_interval = Variant[Integer, Pattern['']] Alias of ```puppet Integer[4, 17] ``` diff --git a/metadata.json b/metadata.json index 00045fc..460fcb2 100644 --- a/metadata.json +++ b/metadata.json @@ -1,94 +1,94 @@ { "name": "puppetlabs-ntp", - "version": "9.0.0", + "version": "9.0.1", "author": "puppetlabs", "summary": "Installs, configures, and manages the NTP service.", "license": "Apache-2.0", "source": "https://github.com/puppetlabs/puppetlabs-ntp", "project_page": "https://github.com/puppetlabs/puppetlabs-ntp", "issues_url": "https://tickets.puppetlabs.com/browse/MODULES", "dependencies": [ { "name": "puppetlabs/stdlib", "version_requirement": ">= 4.13.1 < 8.0.0" } ], "operatingsystem_support": [ { "operatingsystem": "RedHat", "operatingsystemrelease": [ "6", "7" ] }, { "operatingsystem": "CentOS", "operatingsystemrelease": [ "6", "7" ] }, { "operatingsystem": "OracleLinux", "operatingsystemrelease": [ "6", "7" ] }, { "operatingsystem": "Scientific", "operatingsystemrelease": [ "6", "7" ] }, { "operatingsystem": "SLES", "operatingsystemrelease": [ "12", "15" ] }, { "operatingsystem": "Debian", "operatingsystemrelease": [ "8", "9", "10" ] }, { "operatingsystem": "Ubuntu", "operatingsystemrelease": [ "14.04", "16.04", "18.04", "20.04" ] }, { "operatingsystem": "Solaris", "operatingsystemrelease": [ "11" ] }, { "operatingsystem": "AIX", "operatingsystemrelease": [ "5.3", "6.1", "7.1" ] } ], "requirements": [ { "name": "puppet", "version_requirement": ">= 6.0.0 < 8.0.0" } ], "description": "NTP Module for Debian, Ubuntu, CentOS, RHEL, OEL, Fedora, FreeBSD, ArchLinux, Amazon Linux and Gentoo.", "template-url": "https://github.com/puppetlabs/pdk-templates.git#main", "template-ref": "heads/main-0-g7be43a3", "pdk-version": "1.18.1" }