Usage¶

The Network Time Protocol (NTP) formula is used to properly synchronize services across the nodes. This file provides the sample configurations for different use cases.

• [Deprecated] NTP client configuration, should not be used if the stratum parameter exists:

  ntp:
    client:
      enabled: true
      strata:
      - ntp.cesnet.cz
      - ntp.nic.cz
  

• The NTP client extended definition with auth:

  ntp:
    client:
      enabled: true
      stratum:
        primary:
          server: ntp.cesnet.cz
          key_id: 1
        secondary:
          server: ntp.nic.cz
          key_id: 2
  

• The NTP client with MD5 auth configuration:

  ntp:
    client:
      enabled: true
      auth:
        enabled: true
        secrets:
          1:
            secret_type: 'M'
            secret: 'Runrabbitrundigthath'
            trustedkey: true
          2:
            secret_type: 'M'
            secret: 'Howiwishyouwereherew'
            trustedkey: true
      stratum:
        primary:
          server: ntp.cesnet.cz
          key_id: 1
        secondary:
          server: ntp.nic.cz
          key_id: 2
  

• The NTP server with MD5 auth configuration:

  ntp:
    client:
      enabled: false
    server:
      enabled: true
      auth:
        enabled: true
        secrets:
          1:
            secret_type: 'M'
            secret: 'Runrabbitrundigthath'
            trustedkey: true
          2:
            secret_type: 'M'
            secret: 'Howiwishyouwereherew'
            trustedkey: true
      stratum:
        primary:
          server: ntp.cesnet.cz
          key_id: 1
        secondary:
          server: ntp.nic.cz
          key_id: 2
  

• A cleaning up of the NTP configurations left by DHCP:

  ntp:
    client:
      enabled: true
      remove_dhcp_conf: true # default false
  

• The NTP server simple peering definition:

  ntp:
    server:
      peers:
      - 192.168.0.241
      - 192.168.0.242
  

• The NTP server extended peering definition:

  ntp:
     server:
       peers:
         1:
           host: 192.168.31.1
         2:
           host: 192.168.31.2
         3:
           host: 192.168.31.3
  

• The NTP server definition enabling the listen and ignore actions on specific addresses:

  ntp:
    server:
        1:
          value: wildcard
          action: ignore
        2:
          value: ::1
          action: listen
        3:
          value: 192.168.31.1
          action: listen
  

Read more

• https://collectd.org/wiki/index.php/Plugin:NTPd