cluster time-service ntp server create

Add a NTP Server

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

Description

The cluster time-service ntp server create command associates the cluster with an external network time server for time correction and adjustment by using the Network Time Protocol (NTP).

The command resolves the time server host name to an IP address and performs several validation checks. If an error is detected during validation, it is reported.

The validation checks performed by this command include the following:
  • The NTP replies to an NTP query with the specified protocol version.
  • The NTP reply indicates that the external time server is synchronized to another time server.
  • The distance and dispersion of the NTP reply from the "root" or source clock are within the required limits.

Parameters

-server <text> - NTP Server Host Name, IPv4 or IPv6 Address
This parameter specifies the host name or IP address of the external NTP server that is to be associated with the cluster for time correction and adjustment.
[-version {3|4|auto}] - NTP Version for Server (default: auto)
Use this parameter to optionally specify the NTP protocol version that should be used for communicating with the external NTP server. If the external NTP server does not support the specified protocol version, time exchange cannot take place.
The supported values for this parameter include the following:
  • 3 - Use NTP protocol version 3, which is based on Internet Standard request for comments (RFC) #1305.
  • 4 - Use NTP protocol version 4, which is based on Internet Standard RFC #5905.
  • auto - Have Data ONTAP select the NTP protocol version.

The default setting is auto.

[-is-preferred {true|false}] - Is Preferred NTP Server (default: false) (privilege: advanced)
Use this parameter to optionally specify whether the external NTP server is the primary time source for correcting and adjusting the cluster time. The responses from this source are used unless its time is outside the accepted selection range.

The default setting is false.

You use this parameter when a high quality radio (or GPS) based time server is being used with a set of non-radio based backup time servers.

[-key-id <integer>] - NTP Symmetric Authentication Key ID
Use this parameter to optionally enable NTP symmetric authentication key for communication with the specified time server. The ID must refer to a key created by the cluster time-service ntp key create command and must be a key with the same ID and value as one configured on the specified time server.

Examples

The following example associates the cluster with an NTP server named ntp1.example.com.
cluster1::> cluster time-service ntp server create -server ntp1.example.com