salt.modules.napalm_ntp module

NAPALM NTP

Manages NTP on network devices.

codeauthor:Mircea Ulinic <mircea@cloudflare.com> & Jerome Fleury <jf@cloudflare.com>
maturity:new
depends:napalm
platform:unix

Dependencies

New in version 2016.11.0.

salt.modules.napalm_ntp.delete_peers(*args, **kwargs)

Removes NTP peers configured on the device.

Parameters:
  • peers -- list of IP Addresses/Domain Names to be removed as NTP peers
  • (bool) (commit) -- discard loaded config. By default test is False (will not dicard the changes)
  • (bool) -- commit loaded config. By default commit is True (will commit the changes). Useful when the user does not want to commit after each change, but after a couple.

By default this function will commit the config changes (if any). To load without committing, use the commit option. For a dry run, use the test argument.

CLI Example:

salt '*' ntp.delete_peers 8.8.8.8 time.apple.com
salt '*' ntp.delete_peers 172.17.17.1 test=True  # only displays the diff
salt '*' ntp.delete_peers 192.168.0.1 commit=False  # preserves the changes, but does not commit
salt.modules.napalm_ntp.delete_servers(*args, **kwargs)

Removes NTP servers configured on the device.

Parameters:
  • servers -- list of IP Addresses/Domain Names to be removed as NTP servers
  • (bool) (commit) -- discard loaded config. By default test is False (will not dicard the changes)
  • (bool) -- commit loaded config. By default commit is True (will commit the changes). Useful when the user does not want to commit after each change, but after a couple.

By default this function will commit the config changes (if any). To load without committing, use the commit option. For dry run use the test argument.

CLI Example:

salt '*' ntp.delete_servers 8.8.8.8 time.apple.com
salt '*' ntp.delete_servers 172.17.17.1 test=True  # only displays the diff
salt '*' ntp.delete_servers 192.168.0.1 commit=False  # preserves the changes, but does not commit
salt.modules.napalm_ntp.peers(*args, **kwargs)

Returns a list the NTP peers configured on the network device.

Returns:configured NTP peers as list.

CLI Example:

salt '*' ntp.peers

Example output:

[
    '192.168.0.1',
    '172.17.17.1',
    '172.17.17.2',
    '2400:cb00:6:1024::c71b:840a'
]
salt.modules.napalm_ntp.servers(*args, **kwargs)

Returns a list of the configured NTP servers on the device.

CLI Example:

salt '*' ntp.servers
salt.modules.napalm_ntp.set_peers(*args, **kwargs)

Configures a list of NTP peers on the device.

Parameters:
  • peers -- list of IP Addresses/Domain Names
  • (bool) (test) -- discard loaded config. By default test is False (will not dicard the changes)
Commit commit (bool):
 

commit loaded config. By default commit is True (will commit the changes). Useful when the user does not want to commit after each change, but after a couple.

By default this function will commit the config changes (if any). To load without committing, use the commit option. For dry run use the test argument.

CLI Example:

salt '*' ntp.set_peers 192.168.0.1 172.17.17.1 time.apple.com
salt '*' ntp.set_peers 172.17.17.1 test=True  # only displays the diff
salt '*' ntp.set_peers 192.168.0.1 commit=False  # preserves the changes, but does not commit
salt.modules.napalm_ntp.set_servers(*args, **kwargs)

Configures a list of NTP servers on the device.

Parameters:
  • servers -- list of IP Addresses/Domain Names
  • (bool) (test) -- discard loaded config. By default test is False (will not dicard the changes)
Commit commit (bool):
 

commit loaded config. By default commit is True (will commit the changes). Useful when the user does not want to commit after each change, but after a couple.

By default this function will commit the config changes (if any). To load without committing, use the commit option. For dry run use the test argument.

CLI Example:

salt '*' ntp.set_servers 192.168.0.1 172.17.17.1 time.apple.com
salt '*' ntp.set_servers 172.17.17.1 test=True  # only displays the diff
salt '*' ntp.set_servers 192.168.0.1 commit=False  # preserves the changes, but does not commit
salt.modules.napalm_ntp.stats(*args, **kwargs)

Returns a dictionary containing synchronization details of the NTP peers.

Parameters:peer -- Returns only the details of a specific NTP peer.
Returns:a list of dictionaries, with the following keys:
  • remote
  • referenceid
  • synchronized
  • stratum
  • type
  • when
  • hostpoll
  • reachability
  • delay
  • offset
  • jitter

CLI Example:

salt '*' ntp.stats

Example output:

[
    {
        'remote'        : u'188.114.101.4',
        'referenceid'   : u'188.114.100.1',
        'synchronized'  : True,
        'stratum'       : 4,
        'type'          : u'-',
        'when'          : u'107',
        'hostpoll'      : 256,
        'reachability'  : 377,
        'delay'         : 164.228,
        'offset'        : -13.866,
        'jitter'        : 2.695
    }
]