Skip to main content

cluster time-service ntp status show

Contributors
Suggest changes

Display status of the node's NTP client

Availability: This command is available to cluster administrators at the advanced privilege level.

Description

The cluster time-service ntp status show command displays the status of the associations between the cluster and external network time servers that use the Network Time Protocol (NTP).

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If this parameter is specified, the command displays detailed information about all entries.

[-node {<nodename>|local}] - Node (privilege: advanced)

If this parameter is specified, the command displays information related to associations on the specifed node.

[-server <text>] - NTP Server Host Name, IPv4 or IPv6 Address (privilege: advanced)

If this parameter is specified, the command displays information about the associations related to the specified NTP server. The server should be specified as it is configured in the cluster time-service ntp server show command.

[-server-address <IP Address>] - Server IP Address (privilege: advanced)

If this parameter is specified, the command displays information about the associations related to the NTP server with the specified IP address.

[-is-peer-reachable {true|false}] - Is Peer Reachable and Responding to Polls? (privilege: advanced)

If this parameter is specified as true , the command displays information about associations with the NTP servers that have been successfully polled.

[-is-peer-selected {true|false}] - Is Peer Selected as Clock Source? (privilege: advanced)

If this parameter is specified as true , the command displays information about associations with the NTP servers that have been selected as the current clock source.

[-selection-state <State of NTP Peer Selection>] - State of Server Selection (privilege: advanced)

If this parameter is specified, the command displays information about associations with the specified selection state.

[-selection-state-text <text>] - Description of Server Selection State (privilege: advanced)

If this parameter is specified, the command displays information about associations with the specified selection state description.

[-poll-interval <integer>] - Poll Interval (secs) (privilege: advanced)

If this parameter is specified, the command displays information about associations that have the specified polling interval.

[-time-last-poll <integer>] - Time from Last Poll (secs) (privilege: advanced)

If this parameter is specified, the command displays information about associations that are polled at the specified time.

[-offset <double hundredths>] - Offset from Server Time (ms) (privilege: advanced)

If this parameter is specified, the command displays information about associations with the specified offset from the NTP server.

[-delay <double hundredths>] - Delay Time to Server (ms) (privilege: advanced)

If this parameter is specified, the command displays information about associations with the specified travelling time to the NTP server.

[-jitter <double hundredths>] - Maximum Offset Error (ms) (privilege: advanced)

If this parameter is specified, the command displays information about associations with the specified offset error from the NTP server.

[-reachability <Hex String>] - Reachability of Server (privilege: advanced)

If this parameter is specified, the command displays information about associations with the specified reachability to the NTP server. Reachability is specified as a hexbyte that has a bit to represent the success of each of the last eight polls of the specified server. A set bit represents a successful poll. The least significant bit represents the most recent poll, the next most significant bit the poll before that, and so on.

[-server-stratum <integer>] - Stratum of Server Clock (privilege: advanced)

If this parameter is specified, the command displays information about associations with NTP servers with the specified clock stratum.

[-server-reference <text>] - Reference Clock at Server (privilege: advanced)

If this parameter is specified, the command displays information about associations with NTP servers using the specified clock as reference.

[-reported-errors <NTP Peer and Packet Errors>,…​] - Reported Packet and Peer Errors (privilege: advanced)

If this parameter is specified, the command displays information about associations with the specified errors.

Examples

The following example displays the status of the NTP associations of the cluster:

cluster-1::*>cluster time-service ntp status show
Node: node-1
Server                  Reachable  Selection State                Offset (ms)
----------------------- ---------  ------------------------------ ------------
ntp1.eng.netapp.com          true  Currently Selected Server            39.122
ntp2.eng.netapp.com          true  Candidate Server                     37.786
2 entries were displayed.

The following example displays the status of the association with the specified external NTP server:

cluster-1::*>cluster time-service ntp status show -instance -server ntp1.example.com
Node: node-1
NTP Server Host Name, IPv4 or IPv6 Address: ntp1.example.com
                         Server IP Address: 10.56.32.33
Is Peer Reachable and Responding to Polls?: true
         Is Peer Selected as Clock Source?: true
                 State of Server Selection: sys_peer
     Description of Server Selection State: Currently Selected Server
                      Poll Interval (secs): 64
                Time from Last Poll (secs): 1
              Offset from Server Time (ms): 26.736
                 Delay Time to Server (ms): 61.772
                 Maximum Offset Error (ms): 3.064
                    Reachability of Server: 01
                   Stratum of Server Clock: 2
                 Reference Clock at Server: 10.56.68.21
           Reported Packet and Peer Errors: -