Brocade Communications Systems Fabric OS v7.0.1, Command Reference Manual, Page: 1065 / 1132

Fabric OS Command Reference 1039
53-1001764-01
tsClockServer
2
tsClockServer
Displays or sets the Network Time Protocol (NTP) Server addresses.
SYNOPSIS
tsclockserver [ ipaddr [ ; ipaddr ... ]]
DESCRIPTION
Use this command to synchronize the local time of the Principal or Primary FCS switch to one or more
external NTP servers.
This command accepts a list of NTP server addresses. The NTP server addresses can be passed in
either IPV4 or IPV6 address format or as a DNS server name. When multiple NTP server addresses are
specified,
tsClockServer sets the first reachable address for the active NTP server. The remaining
addresses are stored as backup servers, which can take over if the active NTP server fails.
The time server daemon synchronizes fabric time by sending updates of the Principal or Primary FCS
local switch time periodically to every switch in the fabric. The time server daemon runs on all switches in
the fabric, but only the Principal switch (when an FCS policy is not enabled) or the Primary FCS switch
(when an FCS policy is enabled) connect to the NTP server (if specified) and broadcasts time service
updates.
All switches in the fabric maintain the current clock server IP address in nonvolatile memory. By default,
this value is
LOCL ., that is, the local clock of the Principal or the Primary FCS switch is the default clock
server. Changes to the clock server IP addresses on the Principal or Primary FCS switch are propagated
to all switches in the fabric.
Use this command without parameters to display the active NTP server and the configured NTP server
list. Specify the
ipaddr operands to set the clock server IP addresses and enable fabric-wide clock
synchronization with the specified clock server. A value of LOCL may be specified as operand to set the
clock server back to default.
Each ipaddr specified should be the IP address of an NTP server and should be accessible from the
switch. The NTP server must support a full NTP client. When a clock server IP address other than LOCL
is specified but is not used by the fabric, a warning is displayed and logged. When a clock server IP
address other than
LOCL is specified, the date command is restricted to display only. Refer to the date
command help for details.
NOTES
When an FCS policy is enabled, this command can be run on all switches to view the clock server value.
However, you can only modify the clock server value from the Primary FCS switch.
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in
place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for
details.
OPERANDS
This command has the following operand:
ipaddr
Specify the IP address of the NTP server or LOCL to use the local clock of the
Principal or Primary FCS switch as the clock server. If more than one IP address
is specified, separate the IP addresses by semicolons and enclose the list in
double quotation marks. This operand is optional; if omitted, the current NTP
server configuration is displayed. The default NTP server is
LOCL .
EXAMPLES
To display the default clock server:
switch:admin> tsclockserver
LOCL