Brocade OS Command Reference Manual Supporting Fabric OS v6.0.0 (53-1000599-01, October 2007)

Fabric OS Command Reference 659
53-1000599-01
tsClockServer
2
tsClockServer
Displays or sets the NTP Server address.
Synopsis tsclockserver [ipaddr]
Description Use this command to synchronize the local time of the principal or primary FCS switch to an
external NTP server.
The tsclockserver command accepts lists of NTP server addresses instead of just one address. The
NTP server addresses can be passed in any of IPV4 or IPV6 address format or as a DNS name.
When multiple NTP server addresses are passed, tsclockserver sets the first reachable address for
the active NTP server. The rest will be stored as backup servers, which can take over when 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 FCS policy is not enabled) or the primary
FCS switch (when FCS policy is enabled) connect to the NTP server and broadcast time service
updates.
All switches in the fabric maintain the current clock server IP address in flash memory. By default,
this value is LOCL. Changes to the clock server IP address on the principal or primary FCS switch
are propagated to all switches in the fabric.
Use this command with no parameters to display the current clock server IP address being used.
Specify the ipaddr operand to set the clock server IP address 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.
The NTP server used must support a full NTP client. Fabric OS v3.1.0 and v2.6.1 have an SNTP
client and hence will accept an SNTP or NTP server, but v4.1.0 has an NTP client, so for the proper
functioning of a mixed fabric with external time synchronization it is necessary that an NTP server
that supports a full NTP client be used.
The ipaddr specified should be the IP address of an NTP server and should be accessible from the
switch. 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 for more details.
Operands This command has the following operand:
ipaddr Specify the IP address of the NTP server or LOCL to set to use the local clock
of the Principal or Primary FCS switch as the clock server. This operand is
optional. By default, this value is LOCL.
If no operand is specified, the current value displays.
Examples To display the current clock server value (LOCL), set the value to an NTP server at the specified IP
address and then verify that the new IP address was saved:
switch:admin> tsclockserver
LOCL
switch:admin> tsclockserver "123.123.123.123"
Updating Clock Server configuration...done.
switch:admin> tsclockserver
123.123.123.123