# NTP

The `nv unset` commands remove the configuration you set with the equivalent `nv set` commands. This guide only describes an `nv unset` command if it differs from the `nv set` command.

## nv set system ntp vrf <vrf-id>

Configures the Network Time Protocol (NTP) in a specific VRF. The default VRF is `default`.

In Cumulus Linux 5.14 and earlier, this command is `nv set service ntp <vrf-id>`.

### Command Syntax

Syntax | Description
--- | ---
`<vrf-id>` | The VRF you want to configure.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp vrf default

## nv set system ntp listen <interface-name>

Configures the NTP interface on which to listen. The default setting is `eth0`.

In Cumulus Linux 5.14 and earlier, this command is `nv set service ntp <vrf-id> listen <interface-name>`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-name>` | The NTP interface on which to listen.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp listen swp10

## nv set service ntp <vrf-id> pool <server-id>

Configures the remote NTP server pool.

Cumulus Linux 5.15 and later no longer supports this command.

### Command Syntax

Syntax | Description
--- | ---
`<vrf-id>` | The VRF you want to configure.
`<server-id>` | The NTP server pool.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set service ntp default pool 4.cumulusnetworks.pool.ntp.org

## nv set system ntp server <server-id>

Configures the remote NTP server.

In Cumulus Linux 5.14 and earlier, this command is `nv set service ntp <vrf-id> server <server-id>`.

### Command Syntax

Syntax | Description
--- | ---
`<server-id>` | The hostname or IP address of the NTP server.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp server time.nist.gov

## nv set system ntp server <server-id> association-type

Configures the NTP server association type. You can specify `server` or `pool`. The default value is `server`.

### Command Syntax

Syntax | Description
--- | ---
`<server-id>` | The NTP server pool.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp server 192.168.200.1 association-type pool

## nv set system ntp server <server-id> iburst

Configures NTP to send a burst of eight packets instead of the usual one packet when the server pool is unreachable. You can specify `enabled` or `disabled`. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier, this command is `nv set service ntp <vrf-id> server <server-id> iburst` and the value is `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<server-id>` | The NTP server pool.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp server 192.168.200.1 iburst

## nv set system ntp server <server-id> state

Enables and disables the NTP server. You can specify `enabled` or `disabled`. The default setting is `enabled`.

### Command Syntax

Syntax | Description
--- | ---
`<server-id>` | The NTP server pool.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp server 192.168.200.1 state enabled

## nv set system ntp server <server-id> version

Configure the NTP server version. You can specify `3` or `4`. The default setting is `4`.

### Command Syntax

Syntax | Description
--- | ---
`<server-id>` | The NTP server pool.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp server 192.168.200.1 version 3

## nv set system ntp state

Enables and disables NTP. You can specify `enabled` or `disabled`. The default setting is `enabled`.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp state disabled

## nv set system ntp vrf <vrf-id>

Configures the VRF for NTP.

### Command Syntax

Syntax | Description
--- | ---
`<vrf-id>` | The VRF name.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system ntp vrf RED