clock timezone

The command sets a timezone.

The use of a negative form (no) of the command sets the default timezone.

Syntax
clock timezone <OFFSET>
no clock timezone
Parameters

<OFFSET> – zone designation, including offset in hours regarding Greenwich Mean Time, takes the value of [gmt -12 .. gmt +12].

Default value

gmt 0

Required privilege level

15

Command mode

CONFIG

Example:
esr(config)# clock timezone gmt +7
CODE

key

The command defines a key from the key trust list.

The use of a negative form (no) of the command removes a bind to a specified key.

Syntax
key <ID>
no key
Parameters

<ID> – key identifier, set in the range of [1..255].

Required privilege level

15

Command mode

CONFIG-NTP

Example:
esr(config-ntp)# key 245
CODE

maxpoll

The command sets the maximum value of time interval between sending messages to NTP server.

The use of a negative form (no) of the command sets the default value.

Syntax
maxpoll <INTERVAL>
no maxpoll
Parameters

<INTERVAL> – maximum value of poll interval. The command parameter is used as an indicator of the power of two when calculating the interval durability in seconds; it is calculated by raising two to power that is specified by the command parameter, takes the value of [10..17].

Default value

10 (210 = 1024 seconds or 17 minutes 4 seconds)

Required privilege level

10

Command mode

CONFIG-NTP

Example:
esr(ntp-remote)# maxpoll 11
CODE

minpoll

The command sets the minimum value of time interval between sending messages to NTP server.

The use of a negative form (no) of the command sets the default value.

Syntax
minpoll <INTERVAL>
no minpoll
Parameters

<INTERVAL> – minimum value of poll interval in seconds; it is calculated by raising two to power that is specified by the command parameter, takes the value of [4..6].

Default value

6 (26 = 64 seconds or 1 minutes 4 seconds)

Required privilege level

10

Command mode

CONFIG-NTP

Example:
esr(ntp-remote)# minpoll 4
CODE

ntp access-addresses

This command defines a list of trusted IP addresses with which ntp packets can be exchanged.

The use of a negative form (no) of the command removes a specified list.

Syntax
ntp access-addresses <NAME>
no ntp access-addresses
Parameters

<NAME> – IP addresses profile name, set by the string of up to 31 characters.

Default value

Filtering disabled.

Required privilege level

15

Command mode

CONFIG

Example:
esr(config)# ntp access-addresses 192.168.16.33
CODE

ntp authentication enable

The command enables authentication for NTP protocol.

The use of a negative form (no) of the command sets the default value.

Syntax
[no] ntp authentication enable
Parameters

The command does not contain parameters.

Default value

Disabled.

Required privilege level

15

Command mode

CONFIG

Example:
esr(config)# ntp authentication enable
CODE

ntp authentication key-chain

The command specifies a set of passwords for authentication with a server or peer via md5 hash algorithm.

The use of a negative form (no) of the command removes a bind to the password set.

Syntax
ntp authentication key-chain <KEYCHAIN>
no ntp authentication key-chain
Parameters

<KEYCHAIN> – key list identifier, set by the string of up to 16 characters.

Required privilege level

15

Command mode

CONFIG

Example:
esr(config)# ntp authentication key-chain lock
CODE

ntp authentication trusted-key

The command defines a list of trusted keys from the key set.

The use of a negative form (no) of the command removes a specified key.

Syntax
[no] ntp authentication trusted-key <ID>
Parameters

<ID> – key identifier, set in the range of [1..255].

Required privilege level

15

Command mode

CONFIG

Example:
esr(config)# ntp authentication trusted-key 25
CODE

ntp broadcast-client enable

This command enables the mode of receiving broadcast messages from NTP servers for the global configuration and all existing VRFs. The router operates as NTP client. If NTP peers and servers are set in the device configuration, then they are ignored in the broadcast mode.

The use of a negative form (no) of the command disables the broadcast mode.

Syntax
[no] ntp broadcast-client enable
Parameters

The command does not contain parameters.

Default value

Disabled.

Required privilege level

10

Command mode

CONFIG

Example:
esr(config)# ntp broadcast-client enable
CODE

ntp dscp

The command sets the DSCP code value for the use in IP headers of NTP server outgoing packets.

The use of a negative form (no) of the command sets the default DSCP value.

Syntax
ntp dscp <DSCP>
no ntp dscp
Parameters

<DSCP> – DSCP code value, takes values in the range of [0..63].

Default value

46

Required privilege level

10

Command mode

CONFIG

Example:
esr(config)# ntp dscp 40
CODE

ntp enable

This command enables the synchronization of the system clock with remote servers via NTP for the global configuration and all created VRFs.

The use of a negative form (no) of the command disables the synchronization via NTP.

Syntax
[no] ntp enable
Parameters

The command does not contain parameters.

Default value

Disabled.

Required privilege level

10

Command mode

CONFIG

Example:
esr(config)# ntp enable
CODE

ntp ipv6 source address

The command is used to specify source IPv6 address for NTP packets for all peers.

The use of a negative form (no) of the command sets the default source-IPv6 address for NTP packets.

Syntax
ntp ipv6 source address <IPV6-ADDR>
no ntp ipv6 source address
Parameters

<IPV6-ADDR> – RADIUS server IPv6 address, defined as X:X:X:X::X where each part takes values in hexadecimal format [0..FFFF].

Default value

IPv6 address of the interface from which NTP packet is sent.

Required privilege level

10

Command mode

CONFIG

Example:
esr(config)# ntp ipv6 source address fc00::1
CODE

ntp object-group query-only

The command enables query-only mode that limits interaction via NTP for a certain profile of IP addresses. Only control messages exchange is permitted.

The use of a negative form (no) of the command disables the limitations.

Syntax
ntp object-group query-only <NAME>
no ntp object-group query-only
Parameters

<NAME> – IP addresses profile name, set by the string of up to 31 characters.

Default value

Work with NTP peers is not limited by anything.

Required privilege level

15

Command mode

CONFIG

Example:
esr(config)# ntp object-group query-only OG-NTP-QO
CODE

ntp object-group serve-only

The command enables serve-only mode that limits interaction via NTP for a certain profile of IP addresses. You are allowed to respond to NTP requests only; synchronization from other hosts and  control messages exchange are prohibited.

The use of a negative form (no) of the command disables the limitations.

Syntax
ntp object-group serve-only <NAME>
no ntp object-group serve-only
Parameters

<NAME> – IP addresses profile name, set by the string of up to 31 characters.

Default value

Work with NTP peers is not limited by anything

Required privilege level

15

Command mode

CONFIG

Example:
esr(config)# ntp object-group serve-only OG-NTP-SO
CODE

ntp peer

The command is used to set partnership relations between NTP servers and to switch to CONFIG-NTP command mode.

NTP server on the router operates in the mode of bi-directional connection with a remote NTP server specified in the command. If one of the partners lost the connection to higher-level NTP server, it will be able to synchronize the time over the partner server.

The use of a negative form (no) of the command removes a specified NTP partner.

Syntax
[no] ntp peer { <ADDR> | <IPV6-ADDR> } [ vrf <VRF> ]
Parameters

<ADDR> – partner IP address, defined as AAA.BBB.CCC.DDD where each part takes values of [0..255];

<IPV6-ADDR> – partner IPv6 address, defined as X:X:X:X::X where each part takes values in hexadecimal format [0..FFFF];

<VRF> – VRF instance name, set by the string of up to 31 characters, within which an NTP partner will operate.

Required privilege level

10

Command mode

CONFIG

Example:
esr(config)# ntp peer 10.100.100.1
esr(ntp-remote)#
CODE

ntp server

The command is used to set partnership relations between NTP servers and to switch to CONFIG-NTP command mode.

The router works with a specified NTP server in one-directional connection mode. In this mode, the router local clock сan be synchronized with a remote NTP‑ server.

The use of a negative form (no) of the command removes a specified NTP server.

Syntax
[no] ntp server { <ADDR> | <IPV6-ADDR> } [ vrf <VRF> ]
Parameters

<ADDR> – server IP address, defined as AAA.BBB.CCC.DDD where each part takes values of [0..255];

<IPV6-ADDR> – server IPv6 address, defined as X:X:X:X::X where each part takes values in hexadecimal format [0..FFFF];

<VRF> – VRF instance name, set by the string of up to 31 characters, within which the NTP server will operate.

Required privilege level

10

Command mode

CONFIG

Example:
esr(config)# ntp server 10.100.100.2
esr(ntp-remote)#
CODE

ntp source address

The command is used to specify source IP address for NTP packets for all peers.

The use of a negative form (no) of the command sets the default source-IP address for NTP packets.

Syntax
ntp source address <ADDR>
no ntp source address
Parameters

<ADDR> – IP address, defined as AAA.BBB.CCC.DDD where each part takes values of [0..255];

Default value

IP address of the interface from which NTP packet is sent.

Required privilege level

10

Command mode

CONFIG

Example:
esr(config)# ntp source address 10.100.100.2
CODE

prefer

The command marks this NTP server as a preferable one. All other conditions being equal, this NTP server will be selected for synchronization among all production NTP servers.

The use of a negative form (no) of the command sets the default value.

Syntax
[no] prefer
Parameters

The command does not contain parameters.

Default value

Disabled.

Required privilege level

15

Command mode

CONFIG-NTP

Example:
esr(ntp-remote)# prefer
CODE

set date

The command sets the system time and date manually.

Syntax
set date <TIME> [<DAY> <MONTH> [ <YEAR> ] ]
Parameters

<TIME> – system timer, defined as HH:MM:SS, where:

  • HH – hours, takes the value of [0..23];
  • MM – minutes, takes the value of [0 ..59];
  • SS – seconds, takes the value of [0..59];

<DAY> – day of the month, takes values of [1..31];

<MONTH> – month, takes the following values [ January/February/March/April/May/June/July/August/September/October/November/December];

<YEAR> – year, takes values of [2001..2037].

Required privilege level

10

Command mode

ROOT

Example:
esr# set date 16:35:00 15 May 2014
CODE

show date

The command displays the current system time and date.

Syntax
show date
Parameters

The command does not contain parameters.

Required privilege level

1

Command mode

ROOT

Example:
esr# show date
Thursday 23:48:33 GMT+7 May 15 2014
CODE

show ntp configuration

The command displays running NTP configuration.

Syntax
show ntp configuration
Parameters

The command does not contain parameters.

Required privilege level

10

Command mode

ROOT

Example:
esr# show ntp configuration
 NTP status: Enabled
 NTP mode:   client/server
Address          Type     Prefer   NTP version   Min poll          Max poll
--------------   ------   ------   -----------   ---------------   ---------------
10.100.100.1      peer     yes      NTPv4         6(1m 4s)          11(34m 8s)
10.100.100.2      peer     yes      NTPv4         6(1m 4s)          10(17m 4s)
1.2.3.4           server   no       NTPv4         6(1m 4s)          10(17m 4s)
CODE

show ntp peers

The command displays the current condition of NTP servers (peers). The tables below contain the list of parameters being displayed and their description.

Table 6 – Remote server condition (peer)

Parameter

Description

remote

DNS name or IP address of server (peer). The first character in the table is used to define server (peer) condition, conditions are described in Table 7.

refid

Binding handle or IP address of who a remote server (peer) is synchronized with. Binding handle types are described in Table 8.

st

Stratum.

t

Relation of the router to a remote server (peer), the types are described in Table 9.

when

The time period since the server (peer) was last polled, in seconds ('h' hours, 'd' days).

poll

Polling rate of server (peer).

reach

Eight-bit left-shift register containing polling results (1 = successful, 0 = unsuccessful) is displayed in octal notation.

delay

Packet transmission time - to a server (peer) and back, in milliseconds.

offset

Average constant time offset of the router with respect to the server (peer).

jitter

Average dispersion of time deviation (jitter).

Table 7 – Remote server condition (peer)

Type

Description

space

Indicates that:

  • there were not responses from a remote server (peer);
  • the server is not used as the stratum has a big value;
  • server (peer) uses the router to synchronize its time.

x

server (peer) is not used to synchronize time; it has been dropped by collision algorithm.

-

server (peer) is not used to synchronize time; it has been dropped by cluster algorithm.

#

Remote server (peer) is production but is not used since it was not among first 6 servers (peers) sorted by the synchronization distance; it is a backup server.

+

Production and preferable remote server (peer), enabled by union algorithm.

*

Server (peer) which is currently a primary source of time.

Table 8 – Types of remote server (peer) connection identifier

Type

Description

.ACST.

Manycast server.

.AUTH.

Authentication error.

.AUTO.

Automatic key sequence error.

.BCST.

Broadcast server.

.CRYPT.

Automatic key protocol error.

.DENY.

Server denied access.

.INIT.

Server connection initialization.

.MCST.

Multicast server.

.TIME.

Server connection timeout.

.STEP.

Step change of time, the offset is less than threshold (1000 milliseconds) but more than threshold step (125 milliseconds).

.RATE.

Polling rate exceeding.

Table 9 – Types of relations of router to a remote server (peer)

Type

Description

u

Unicast or manycast client.

b

Broadcast or unicast client.

s

Bi-directional coupling (peer).

A

Manycast server.

B

Broadcast server.

M

Multicast server.

Syntax
show ntp peers
Parameters

The command does not contain parameters.

Required privilege level

1

Command mode

ROOT

Example:
esr# sh ntp peers 
Clock is synchronized, stratum 3, reference is 192.168.1.1
     remote           refid           st t when poll reach  delay   offset  jitter
--------------------- --------------- -- - ---- ---- ----- ------- -------- -------
*192.168.1.1          192.168.1.2      2 u   45  128  377   0.283   0.204   0.049
CODE

version

The command sets NTP version.

The use of a negative form (no) of the command sets the default value.

Syntax
version <VERSION>
no version
Parameters

<VERSION> – NTP version, takes values in the range of [1..4].

Default value

4

Required privilege level

15

Command mode

CONFIG-NTP

Example:
esr(ntp-remote)# version 3
CODE