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
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
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
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
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 authentication trusted-key 25
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
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
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
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
None.
Default value
Disabled.
Required privilege level
10
Command mode
CONFIG
Example:
esr(config)# ntp broadcast-client enable
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
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
None.
Default value
Disabled.
Required privilege level
10
Command mode
CONFIG
Example:
esr(config)# ntp enable
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
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
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
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)#
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)#
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
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
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
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
show ntp configuration
The command displays running NTP configuration.
Syntax
show ntp configuration
Parameters
None.
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)
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:
|
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
None.
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
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