salt.modules.napalm_ntp

NAPALM NTP

Manages NTP on network devices.

codeauthor

Mircea Ulinic <ping@mirceaulinic.net> & Jerome Fleury <jf@cloudflare.com>

maturity

new

depends

napalm

platform

unix

Dependencies

New in version 2016.11.0.

salt.modules.napalm_ntp.delete_peers(*peers, **options)

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(*servers, **options)

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(**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(**kwargs)

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

CLI Example:

salt '*' ntp.servers

Example output:

[
    '192.168.0.1',
    '172.17.17.1',
    '172.17.17.2',
    '2400:cb00:6:1024::c71b:840a'
]
salt.modules.napalm_ntp.set_peers(*peers, **options)

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(*servers, **options)

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(peer=None, **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'        : '188.114.101.4',
        'referenceid'   : '188.114.100.1',
        'synchronized'  : True,
        'stratum'       : 4,
        'type'          : '-',
        'when'          : '107',
        'hostpoll'      : 256,
        'reachability'  : 377,
        'delay'         : 164.228,
        'offset'        : -13.866,
        'jitter'        : 2.695
    }
]