End of Support

Setting the Interval for Sending Synchronization Messages

To set the interval (in log seconds) for sending synchronization messages, use the ptp sync-message interval command. Value ranges and defaults vary based on the PTP mode of the switch.

Example

This command configures the interval for sending synchronization messages on the interface to 3 (8 seconds).

switch(config-if-Et5)# ptp sync-message interval 3
switch(config-if-Et5)#

Setting the PTP Transport Type

To set the PTP transport type, use the ptp transport command.

This command configures the PTP transport type for the interface to IPv4.
```
switch(config-if-Et5)# ptp transport ipv4
switch(config-if-Et5)#
```
This command configures the PTP transport type for the interface to IPv6.
```
switch(config-if)# ptp transport ipv6
switch(config-if)#
```

Setting the Local Priority of the Clock and Interfaces

To set the local priority of the clock and interfaces to control the topology, use the ptp local-priority command.

switch(config)# ptp local-priority 1
switch(config-if)# ptp local-priority 255

Setting up as a Slave to another PTP Device

Each interface may be configured with a candidate grantor IP address to send requests and potentially become the slave device to another PTP device. After configuration, the switch starts negotiating with the candidate grantor, and depending on the Announce messages received, it may start requesting Sync and Delay Response to sync the clock. Each grantor may be associated with a unicast negotiation profile. If the configuration omits the profile, the device uses the default interval of one second and a duration of 60 seconds for all message types. If the profile does not exist, the switch uses the default values until the profile gets added.

Use the ptp unicast-negotiation candidate-grantor command to set up the profile. The following commands set up the candidate grantor profile.

switch(config-if)# ptp unicast-negotiation candidate-grantor 10.0.0.1
switch(config-if)# ptp unicast-negotiation candidate-grantor 10.0.0.1 profile fastProfile

Setting up as a Master to another PTP Device

Each interface may be configured with a range of IP addresses of remote grantees to grant incoming requests and potentially become a master to another PTP device. By default, the interface denies incoming requests outside the configured range of IP addresses. Each grantee may be associated with a unicast negotiation profile. If the configuration omits the profile, the interface grants incoming requests with an interval of 0 or longer for all message types. If you specify a profile, it compares it to the configured interval. If the profile does not exist, the switch uses the default values until you add the profile.

Use the ptp unicast-negotiation remote-grantee command to set up the profile. The following commands set up the remote grantee profile.

switch(config-if)# ptp unicast-negotiation remote-grantee 10.0.0.1/24
switch(config-if)# ptp unicast-negotiation remote-grantee 10.0.0.1/24 profile fastProfile

Setting the masterOnly Flag

For ports that should not be a slave regardless of other attributes, use the ptp role master command.

switch(config-if)# ptp role master

Configuring the Unicast Profile

A Unicast negotiation profile may be configured to change message rates and durations. The following tables displays the default value and the configurable range of each value.


Field	Range	Default
Announce interval	[-3, 0]	0
Announce duration	[60, 1000]	60
Sync interval	[-7, 0]	0
Sync duration	[60, 1000]	60
Delay Response interval	[-7, 0]	0
Delay Response duration	[60, 1000]	60

When you apply a profile to a remote grantee on a Grant port, it uses the profile values to determine if the given request should be granted or denied. If the requested interval is shorter than the profile, the port denies the request. When a profile applies to a candidate grantor on a Request port, it will be requested to the candidate grantor using the values in the profile.

The following configures a typical Unicast negotiation profile.

switch(config)# ptp unicast-negotiation profile fastProfile
switch(config-unicast-negotiation-profile-fastProfile)# announce interval -2
switch(config-unicast-negotiation-profile-fastProfile)# announce duration 500
switch(config-unicast-negotiation-profile-fastProfile)# sync interval -3
switch(config-unicast-negotiation-profile-fastProfile)# sync duration 300
switch(config-unicast-negotiation-profile-fastProfile)# delay-resp interval -3
switch(config-unicast-negotiation-profile-fastProfile)# delay-resp duration 300

Displaying Unicast Negotiation Configurations

The show ptp unicast-negotiation profile command displays all user configured profiles and their values.

(switch)# show ptp unicast-negotiation profile
Unicast Negotiation Profile fastProfile
Announce interval: 0.25 seconds
Announce duration: 500 seconds
Sync interval: 0.125 seconds
Sync duration: 300 seconds
Delay Response interval: 0.125 seconds
Delay Response duration: 300 seconds

The show ptp unicast-negotiation candidate-grantor command displays all configured candidate grantors, associated profile name and latest update.

(switch)# show ptp unicast-negotiation candidate-grantor
 Interface    Address      Profile       Grantor Status
----------- ---------- -------------- ------------------ 
 Ethernet1    4::1       fastProfile    Master
 Ethernet1    4::2       fastProfile    Candidate Master
 Ethernet2    4::2       fastProfile    Blacklisted

The show ptp unicast-negotiation remote-grantee command displays all configured remote grantees, associated profile name and latest update.

(switch)# show ptp unicast-negotiation remote-grantee 
Interface    Address      Profile
------------ ---------- -------------
 Ethernet1    4::1/96    fastProfile
 Ethernet1    4::2/96    fastProfile
 Ethernet2    4::2/96    fastProfile

The show ptp unicast-negotiation granted command displays to which remote grantees each port has granted and some detail.

(switch)# show ptp unicast-negotiation granted  
Interface    Address    Message     Interval        Duration       Expires In
----------- ---------- ------------ -------------- -------------- -------------
 Ethernet2    4::1       Announce    0.25 seconds    300 seconds    30 seconds
 Ethernet2    4::1       Sync        2.0 seconds     300 seconds    30 seconds

The show ptp unicast-negotiation requested command displays to which candidate grantors each port has requested and some detail.

(switch)# show ptp unicast-negotiation requested  
 Interface    Address    Message     Interval        Duration       Expires In
------------ --------- ----------- --------------- -------------- -------------
 Ethernet2    4::2       Announce    0.25 seconds    600 seconds    250 seconds
 Ethernet2    4::2       Sync        2.0 seconds     300 seconds    denied

The show ptp local-clock command displays the clock local priority in G8275.2 mode.

(switch)# show ptp local-clock  
 PTP Mode: Boundary Clock
Clock Identity: 0x00:1c:73:ff:ff:00:72:40
Clock Domain: 44
Number of PTP ports: 64
Priority1: 128
Priority2: 128
Local Priority: 128
Clock Quality:
   Class: 248
   Accuracy: 0x30
   OffsetScaledLogVariance: 0xffff
Offset From Master: -5
Mean Path Delay: 416 nanoseconds
Steps Removed: 1
Skew: 1.00000006399
Last Sync Time: 23:42:33 UTC Nov 01 2018
Current PTP System Time: 23:42:33 UTC Nov 01 2018

The show ptp interface command displays the interface local priority in G8275.2 mode.

Note: The Announce, Sync and Delay request message intervals are for multicast mode. Since G8275.2 operates in unicast mode, those values should be ignored.

(switch)# show ptp interface Ethernet 42 | nz  Interface Ethernet42
PTP: Enabled
Port state: Slave
Sync interval: 1.0 seconds
Announce interval: 2.0 seconds
Announce interval timeout multiplier: 3
Delay mechanism: end to end
Delay request message interval: 0.25 seconds
Local Priority: 128
Transport mode: ipv4
Announce messages received: 2964
Sync messages received: 2558
Follow up messages received: 2558
Delay request messages sent: 2540
Delay response messages received: 2540
Signaling messages sent: 98
Signaling messages received: 101

Viewing PTP Settings and Status

The following commands display the status of the switch PTP server connections:

Displaying General PTP Information
Displaying PTP Local Clock and Offset
Displaying PTP Masters Information
Displaying PTP Clock Properties
Displaying PTP Information for all Interfaces
Displaying PTP Interface Counters
Displaying PTP Foreign Master
Displaying PTP Monitoring Information
Displaying PTP Source IP

Displaying General PTP Information

To display general Precision Time Protocol (PTP) information, use the show ptp command.

switch# show ptp
PTP Mode: gptp - Generalized PTP Clock
Clock Identity: 2001:0DB8:73:ff:ff:26:fd:90
Grandmaster Clock Identity: 2001:0DB8:96:ff:fe:6c:ed:02
Number of slave ports: 1
Number of master ports: 6
Slave port: Ethernet33
Mean Path Delay (nanoseconds): 718
Steps Removed: 1
Neighbor Rate Ratio: 1.00000007883
Rate Ratio: 1.00000007883
Interface  State    ASTime  Since LastNeighbor Mean        Path        Residence 
Capable    Changed  Rate    Ratio              Delay (ns)  Time (ms) 
---------  -------- ------- ------------------ ----------- ----------- --------- 
Et1        Disabled No      Never              1.0         00
Et2        Disabled No      Never              1.0         00
Et3        Disabled No      Never              1.0         00
Et4        Disabled No      Never              1.0         00
Et5        Disabled No      Never              1.0         00
Et6        Disabled No      Never              1.0         00
Et7        Master   Yes                        0:21:08     1.000000094200

Displaying PTP Clock Properties

To display PTP clock properties, use the Displaying PTP Clock Properties command.

switch# show local-clock time-properties
Current UTC offset valid: False
Current UTC offset: 0
Leap 59: False
Leap 61: False
Time Traceable: False
Frequency Traceable: False
PTP Timescale: False
Time Source: 0x0
switch#

Displaying PTP Foreign Master

To display information about foreign masters (PTP sources not designated as the switch's master from which the switch has received sync packets), use the show ptp foreign-master-record command.

switch# show ptp foreign-master-record
No Foreign Master Records
switch#

Displaying PTP Information for all Interfaces

To display PTP information for specified interfaces, use the show ptp interface command.

switch# show ptp interface
Interface Ethernet1
PTP: Disabled
Port state: Disabled
Sync interval: 1.0 seconds
Announce interval: 2.0 seconds
Announce interval timeout multiplier: 3
Delay mechanism: end to end
Delay request message interval: 32.0 seconds
Transport mode: ipv4

Interface Ethernet5
PTP: Disabled
Port state: Disabled
Sync interval: 8.0 seconds
Announce interval: 2.0 seconds
Announce interval timeout multiplier: 5
Delay mechanism: peer to peer
Peer delay request message interval: 8.0 seconds
Peer Mean Path Delay: 0
Transport mode: ipv4

switch#

Displaying PTP Interface Counters

To display PTP interface counters for specified interfaces, use the show ptp interface counters command.

switch# show ptp interface ethernet 5 counters 
Interface Ethernet5
Announce messages sent: 0
Announce messages received: 0
Sync messages sent: 0
Sync messages received: 0
Follow up messages sent: 0
Follow up messages received: 0
Delay request messages sent: 0
Delay request messages received: 0
Delay response messages sent: 0
Delay response messages received: 0
Peer delay request messages sent: 0
Peer delay request messages received: 0
Peer delay response messages sent: 0
Peer delay response messages received: 0
Peer delay response follow up messages sent: 0
Peer delay response follow up messages received: 0
switch#

Displaying PTP Local Clock and Offset

To display the local PTP clock and offset, use the show ptp local-clock command.

switch# show ptp local-clock
PTP Mode: Boundary Clock
Clock Identity: 0x00:1c:73:ff:ff:1e:83:24
Clock Domain: 1
Number of PTP ports: 24
Priority1: 128
Priority2: 128
Clock Quality:
   Class: 248
   Accuracy: 0x30
   OffsetScaledLogVariance: 0xffff
Offset From Master: 0
Mean Path Delay: 0
Steps Removed: 0
switch#

Displaying PTP Masters Information

To display the PTP clocks master and grandmaster identity and configuration, use the show ptp masters command.

switch# show ptp masters
Parent Clock:
Parent Clock Identity: 0x00:1c:73:ff:ff:00:72:40
Parent Port Number: 0
Parent IP Address: N/A
Observed Parent Offset (log variance): N/A
Observed Parent Clock Phase Change Rate: N/A

Grandmaster Clock:
Grandmaster Clock Identity: 0x00:1c:73:ff:ff:00:72:40
Grandmaster Clock Quality:
   Class: 248
   Accuracy: 0x30
   OffsetScaledLogVariance: 0xffff
   Priority1: 128
   Priority2: 128
switch#

Displaying PTP Monitoring Information

To display the list of up to 100 recorded entries of offset from master, mean path delay and skew values, the current PTP mode, whether or not the feature is enabled, the number of entries displayed, and the configured thresholds for each metric, use the show ptp monitor command. Entries are sorted by the system time at which the value was calculated, starting with the most recent data at the top.

switch# show ptp monitor 
PTP Mode: Boundary Clock 
Ptp monitoring: enabled 
Number of entries: 5 
Offset from master threshold: 1500 
Mean path delay threshold: not configured 
Skew threshold: 0.5 
Interface  Time                          Offset from   Mean Path    Skew 
                                         Master (ns)   Delay (ns) 
---------- ----------------------------- ------------ ------------- ----------- 
Et8        21:23:12.901 UTC Feb 22 2018  71            5849         1.003159918 
Et1        21:23:12.901 UTC Feb 22 2018  113           3672         1.004990621 
Et2        21:23:12.901 UTC Feb 22 2018  706           7799         1.002744199 
Et1        21:23:12.901 UTC Feb 22 2018  803           5861         1.003432049 
Et1        21:23:12.901 UTC Feb 22 2018  610           3415         0.998974658

Displaying PTP Source IP

To display PTP IP source information, use the show ptp source ip command.

switch# show ptp source ip
PTP source IP: 10.0.2.1
switch#

Precision Time Protocol (PTP) Commands

PTP Show Commands

show ptp foreign-master-record
show ptp interface
show ptp interface counters
show ptp local-clock
show ptp masters
show ptp monitor
show ptp source ip
show ptp unicast-negotiation
show ptp unicast-negotiation profile
show ptp

ptp announce interval

The ptp announce interval command configures the interval at which the configuration mode interface sends PTP announce messages. The no ptp announce interval command resets the announce interval to its default of 1 (2 seconds).

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp announce interval log_interval

no ptp announce interval

default ptp announce interval

Parameters

log_interval The number of log seconds between PTP announce messages (base 2 log (seconds)). Value ranges from -3 (1/8 second) to 4 (16 seconds); default value is 1 (2 seconds).

Examples

These commands set the interval between PTP announce messages sent by interface ethernet 5 to 4 seconds.

switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp announce interval 2
switch(config-if-Et5)#

These commands reset the PTP announce interval on interface ethernet 5 to the default value of 1 (2 seconds).

switch(config)# interface ethernet 5
switch(config-if-Et5)# no ptp announce interval
switch(config-if-Et5)#

ptp announce timeout

The ptp announce timeout sets the timeout multiplier for the configuration-mode interface. The timeout multiplier is the number of announcement intervals that the interface will wait without receiving a PTP announce message before a timeout occurs; the range is from 2 to 255. The default multiplier is 3, which results in a 6-second timeout interval when the announce interval is set to the default of 2 seconds. To configure the announce interval, use the ptp announce interval command.

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp announce timeout multiplier

no ptp announce timeout

default ptp announce timeout

Parameter

multiplier Number of announce intervals after which the interface will time out if it does not receive a PTP announce message. The range is from 2 to 255; default value is 3.

Examples

This command sets the timeout multiplier for interface ethernet 5 to 5. This means that the interface will time out if it doesnt receive a PTP announce message within five announce intervals.
```
switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp announce timeout 5
switch(config-if-Et5)#
```

These commands reset the PTP timeout interval on interface ethernet 5 to the default value of 3.

switch(config)# interface ethernet 5
switch(config-if-Et5)# no ptp announce timeout 
switch(config-if-Et5)#

ptp delay-mechanism

The ptp delay-mechanism command configures the delay mechanism in boundary clock mode. The no ptp delay-mechanism command disables the feature.

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp delay-mechanism mech_type

no ptp delay-mechanism

default ptp delay-mechanism

Parameters

mech_type The delay mechanism. Options include the following:

e2e end-to-end delay mechanism.
p2p peer-to-peer mechanism.

Examples

This command sets the delay mechanism to peer-to-peer in the boundary clock mode.

switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp delay-mechanism p2p
switch(config-if-Et5)#

This command sets the delay mechanism to end-to-end in the boundary clock mode.

switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp delay-mechanism e2e
switch(config-if-Et5)#

This command removes the delay mechanism configuration from Ethernet 5.

switch(config)# interface ethernet 5
switch(config-if-Et5)# no ptp delay-mechanism e2e
switch(config-if-Et5)#

ptp delay-req interval

The ptp delay-req interval command specifies the time in log seconds recommended to the slave devices to send delay request messages. You must enable PTP on the switch first and configure the source IP address for PTP communication. The no ptp delay-req interval command resets the interval to its default of 5 (32 seconds).

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp delay-req interval log_interval

no ptp delay-req interval

default ptp delay-req interval

Parameter

log_interval The range is -1 to 8 log seconds (base 2 log (seconds)). The default is 5 (32 seconds).

Examples

These commands set the minimum interval allowed between PTP delay request messages on interface ethernet 5 to 3 (8 seconds).
```
switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp delay-request interval 3
switch(config-if-Et5)#
```

These commands reset the minimum interval allowed between PTP delay-request messages to the default of 5 (32 seconds).

switch(config)# interface ethernet 5
switch(config-if-Et5)# no ptp delay-request interval
switch(config-if-Et5)#

ptp domain

The ptp domain command sets the domain number to use for the clock. The no ptp domain command resets or restores the domain to the default number 0.

Command Mode

Global Configuration

Command Syntax

ptp domain domain_number

no ptp domain

default ptp domain

Parameter

domain_number Value ranges from 0 to 255. Default number is 0.

Examples

This command shows how to configure domain 1 for use with a clock.
```
switch(config)# ptp domain 1
switch(config)#
```
This command removes the configured domain 1 for use with a clock.
```
switch(config)# no ptp domain 1
switch(config)#
```

ptp enable

The ptp enable command enables PTP on the interface. The no ptp enable command disables PTP on the interface.

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp enable

no ptp enable

default ptp enable

Examples

This command enables PTP on interface ethernet 5.

switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp enable

This command disables PTP on Ethernet interface 5.

switch(config)# interface ethernet 5
switch(config-if-Et5)# no ptp enable

ptp forward-v1

The ptp forward-v1 command configures the switch to forward Precision Time Protocol version 1 packets as regular multicast traffic. By default, PTP v1 packets are trapped by the CPU, logged and discarded.

The no ptp forward-v1 and default ptp forward-v1 commands restore the default forwarding behavior by removing the corresponding ptp forward-v1 command from running-config.

Command Mode

Global Configuration

Command Syntax

ptp forward-v1

no ptp forward-v1

default ptp forward-v1

Examples

This command configures the switch to forward PTP v1 packets as regular multicast traffic.
```
switch(config)# ptp forward-v1
switch(config)#
```
This command configures the switch to log and discard PTP v1 packets.
```
switch(config)# no ptp forward-v1
switch(config)#
```

ptp hold-ptp-time

The ptp hold-ptp-time command configures the PTP offset hold time in seconds. The no ptp hold-ptp-time command resets or restores the PTP hold time to the default value.

Command Mode

Global Configuration

Command Syntax

ptp hold-ptp-time offset

no ptp hold-ptp-time

default ptp hold-ptp-time

Parameter

offset Value ranges from 0 to 86400.

Examples

This command shows how to configure the PTP offset hold time.
```
switch(config)# ptp hold-ptp-time 600
switch(config)#
```
This command resets or restores the PTP offset hold time to the default value.
```
switch(config)# no ptp hold-ptp-time
switch(config)#
```

ptp local-priority

The ptp local-priority command configures the local priority of the clock and interfaces to control the topology.

Command Mode

Interface-Ethernet Configuration

Command Syntax

ptp local-priority PRIORITY_NUM

Parameter

PRIORITY_NUM The priority number from 1 to 255.

Example

This command sets the priority for the subinterface.

switch(config)# ptp local-priority 1
switch(config-if)# ptp local-priority 255

ptp mode

The ptp mode command configures the Precision Time Protocol (PTP) packet forwarding mode for the switch. By default, PTP is disabled globally; the mode must be changed to use PTP on switch interfaces.

The no ptp mode and default ptp mode commands return the forwarding mode to disabled by removing the ptp mode command from running-config.

Command Mode

Global Configuration

Command Syntax

ptp mode mode_name

no ptp mode

default ptp mode

Parameters

mode_name Default mode is disabled. Options include:

boundary The device acts as a boundary clock, and both runs and participates in the best master clock algorithm.
- disabled The default mode. PTP is disabled, and the device forwards all PTP packets as normal traffic.
- e2etransparent The device acts as an end-to-end transparent clock, synchronizing all ports to a connected master clock and updating the time interval field of forwarded PTP packets using switch residence time.
- p2ptransparent The device acts as a peer-to-peer transparent clock, synchronizing all ports to a connected master clock and updating the time interval field of forwarded PTP packets using switch residence time and inbound path delays.
- gptp The device runs generalized Precision Time Protocol (gPTP), participating in the best master clock algorithm but also updating the interval field of forwarded PTP packets using switch residence time and inbound path delays.

Examples

This command configures the switch to act as a PTP boundary clock.
```
switch(config)# ptp mode boundary
switch(config)#
```

This command restores PTP to disabled mode.

switch(config)# no ptp mode
switch(config)#

ptp monitor threshold mean-path-delay

Mean path delay is the mean time in nanoseconds that PTP packets take to travel between PTP master and slave. The ptp monitor threshold mean-path-delay command configures the mean-path-delay threshold in nanoseconds. When this threshold is configured, a Syslog message is generated if the value of the most recently calculated mean path delay is greater than or equal to this value.

The no ptp monitor threshold mean-path-delay and default ptp monitor threshold mean-path-delay commands clear the threshold value and prevent further Syslog messages from being generated for this parameter.

Command Mode

Global Configuration

Command Syntax

ptp monitor threshold mean-path-delay threshold

no ptp monitor threshold mean-path-delay

default ptp monitor threshold mean-path-delay

Parameter

threshold threshold in nanoseconds. Values range from 0 to 1000000000 (1 second).

Example

This command sets a mean-path-delay threshold value of 2000 nanoseconds.

switch(config)# ptp monitor threshold mean-path-delay 2000

ptp monitor threshold offset-from-master

PTP offset is the difference in nanoseconds between master and slave time. The ptp monitor threshold offset-from-master command configures the offset-from-master threshold in nanoseconds. A Syslog message is generated if the most recently calculated time offset from the PTP master is outside of the range (-<threshold>, <threshold>). The maximum offset threshold is one second.

The no ptp monitor threshold offset-from-master and no ptp monitor threshold offset-from-master commands clear the threshold value and prevents further Syslog messages from being generated for this parameter.

Command Mode

Global Configuration

Command Syntax

ptp monitor threshold offset-from-master threshold

no ptp monitor threshold offset-from-master

default ptp monitor threshold offset-from-master

Parameter

threshold Offset threshold value in nanoseconds. Values range from 0 to 1000000000.

Example

This command sets an offset-from-master threshold value of 500 nanoseconds.

switch(config)# ptp monitor threshold offset-from-master 500 
switch(config)#

ptp monitor threshold skew

PTP skew is the clock frequency difference between master and slave. The ptp monitor threshold skew command configures the value of the skew-threshold percentage. A Syslog message is generated if the value of the most recently calculated skew is not in the range (1/(1+threshold), 1*(1+threshold)).

The no ptp monitor threshold skew and default ptp monitor threshold skew commands clear the threshold value and prevent further Syslog messages from being generated for this parameter.

Command Mode

Global Configuration

Command Syntax

ptp monitor threshold skew threshold

no ptp monitor threshold skew

default ptp monitor threshold skew

Parameter

threshold skew percentage threshold represented as a double precision (16 digit) real number ranging from 0 (0%) to 10 (1000%).

Example

This command sets a skew threshold value of 5 (500%).

switch(config)# ptp monitor threshold skew 5
switch(config)#

ptp monitor

The ptp monitor command enables and disables PTP monitoring on the switch. When PTP monitoring is enabled, the switch records PTP status and configuration information (which can be viewed using the show ptp monitor command) and generates Syslog messages for metrics whose threshold values have been configured. PTP monitoring is enabled by default.

The no ptp monitor command disables the PTP monitoring and clears all the recorded data from running-config.

Command Mode

Global Configuration

Command Syntax

ptp monitor

no ptp monitor

Related Commands

ptp monitor threshold mean-path-delay
ptp monitor threshold offset-from-master
ptp monitor threshold skew
show ptp monitor

Example

This command disables ptp monitor PTP monitoring on the switch and clears all the recorded data.

switch(config)# ptp monitor
switch(config)#

ptp pdelay-neighbor-threshold

The ptp pdelay-neighbor-threshold command configures the propagation delay threshold above which the switch will consider the neighbor connected to this port to be incapable of participating in generalized Precision Time Protocol (gPTP).

The no ptp pdelay-neighbor-threshold and default ptp pdelay-neighbor-threshold commands restore the threshold to 100000 nanoseconds by removing the corresponding ptp pdelay-neighbor-threshold command from running-config.

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp pdelay-neighbor-threshold link_prop

no ptp pdelay-neighbor-threshold

default ptp pdelay-neighbor-threshold

Parameter

link_prop Threshold in nanoseconds. Value ranges from 0 to 10000000000 (ten billion). Default is 100000.

Examples

These commands set the link propagation delay threshold on interface ethernet 5 to 200000 nanoseconds.

switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp pdelay-neighbor-threshold 200000
switch(config-if-Et5)#

These commands restore the link propagation delay threshold on interface ethernet 5 to its default value of 100000 nanoseconds.
```
switch(config)# interface ethernet 5s
witch(config-if-Et5)# no ptp pdelay-neighbor-threshold
switch(config-if-Et5)#
```

ptp pdelay-req interval

The ptp pdelay-req interval command configures the interval between Precision Time Protocol peer delay-request messages. The no ptp pdelay-req interval command removes the configuration.

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp pdelay-req interval log_interval

no ptp pdelay-req interval

default ptp pdelay-req interval

Parameter

log_interval The log interval in seconds (base 2 log (seconds)). Value ranges from 0 to 5.

Examples

This command shows how to configure the interval allowed between PTP peer delay request messages on interface Ethernet 5.
```
switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp pdelay-request interval 3
switch(config-if-Et5)#
```
This command removes the configure the interval allowed between PTP peer delay request messages on interface Ethernet 5.
```
switch(config)# interface ethernet 5
switch(config-if-Et5)# no ptp pdelay-request interval
switch(config-if-Et5)#
```

ptp priority1

The ptp priority1 command configures the priority 1 value for advertising the switchs PTP clock. Priority 1 is the most significant of the six factors used by devices in the selection of a master clock. Lower values indicate higher priority.

The no ptp priority1 and default ptp priority1 commands restore the priority 1 default setting of 128.

Command Mode

Global Configuration

Command Syntax

ptp priority1 priority_rate

no ptp priority1

default ptp priority1

Parameter

priority_rate Value ranges from 0 to 255. Default is 128.

Examples

This command sets the priority 1 level for the switchs PTP clock to 120.
```
switch(config)# ptp priority1 120
switch(config)#
```
This command restores the default priority 1 level of 128.
```
switch(config)# no ptp priority1
switch(config)#
```

ptp priority2

The ptp priority2 command sets the priority 2 value for the clock. The range is from 0 to 255. Priority 2 is the fifth most significant of the six factors used by devices in the selection of a master clock. Lower values indicate higher priority.

The no ptp priority2 and default ptp priority2 commands restore the priority 2 default setting of 128.

Command Mode

Global Configuration

Command Syntax

ptp priority2 priority_rate

no ptp priority2

default ptp priority2

Parameter

priority_rate Specifies the priority 2 level for the PTP clock. Value ranges from 0 to 255; default value is 128.

Examples

This command sets the priority 2 level for the switchs PTP clock to 120.
```
switch(config)# ptp priority2 120
switch(config)#
```
This command restores the default priority 2 level of 128.
```
switch(config)# no ptp priority2 
switch(config)#
```

ptp role

The ptp role command configures a port to operate either in the master mode or the dynamic mode when it is executed in the interface configuration mode.

The no ptp role command removes the master or dynamic mode if it was previously configured on an interface.

Command Mode

Interface-Ethernet Configuration

Command Syntax

ptp role [dynamic | master]

no ptp role

default ptp role

Parameters

dynamic the dynamic mode.
master the master clock mode that has the most precise time.

Related Commands

ptp enable
ptp enable
show ptp interface

Examples

This command configures a port to operate in the master mode for interface ethernet 1.
```
switch(config)# interface ethernet 1
switch(config-if-Et1)# ptp role master
```
This command configures a port to operate in the dynamic mode for interface ethernet 1.
```
switch(config)# interface ethernet 1
switch(config-if-Et1)# ptp role dynamic
```

ptp source

The ptp source command configures the source IP address for all PTP packets. The IP address can be in IPv4 or IPv6 format. The no ptp source ip command removes this configuration.

Command Mode

Global Configuration

Command Syntax

ptp source ip {ip|ipv6} ip_addr

no ptp source ip

default ptp source ip

Parameters

ip specifies an IPv4 source address.

ipv6 specifies an IPv6 source address.

ip_addr the source IP address.

Examples

This command configures the source IP address 10.0.2.1 for all PTP packets.
```
switch(config)# ptp source ip 10.0.2.1
switch(config)#
```
This command configures the source IP address 2001:db8:ac10:fe01:: for all PTP packets.
```
switch(config)# ptp source ip 2001:db8:ac10:fe01::
switch(config)#
```
This command removes any configured source IP address for all PTP packets.
```
switch(config)# no ptp source ip
switch(config)#
```

ptp sync timeout

A PTP synchronization timeout occurs if a sync message is not received for a specified period of time, calculated as a multiple of the PTP sync-message interval. The ptp sync timeout command configures the sync timeout multiplier. The range is 2 to 255, with a default of 20 (20 times the sync interval). To configure the sync interval, use the ptp sync-message interval command.

The no ptp sync timeout and default ptp sync timeout commands restore the PTP sync timeout multiplier to its default value of 20.

Command Mode

Interface-Ethernet Configuration

Command Syntax

ptp sync timeout interval_multiplier

no ptp sync timeout

default ptp sync timeout

Parameter

interval_multiplier The number of sync intervals that must pass without the configuration mode interface receiving a PTP sync message before a timeout occurs. Value ranges from 2 to 255. Default value is 20.

Example

These commands configure the sync timeout on interface ethernet 5 to ten times the configured sync interval.

switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp sync timeout 10
switch(config-if-Et5)#

ptp sync-message interval

The ptp sync-message interval command configures the time for sending synchronization messages by specifying its log2 value. Default values and ranges depend on the PTP mode, which is set using the ptp mode command.

The no ptp sync-message interval and default ptp sync-message interval commands restore the sync interval to its default (1 second in boundary mode, 1/8 second in gptp mode) by removing the corresponding ptp sync-message interval command from running-config.

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp sync-message interval log_interval

no ptp sync-message interval

default ptp sync-message interval

Parameter

log_interval The interval between PTP synchronization messages sent from the master to the slave (base 2 log (seconds)). Values vary according to PTP mode: in boundary mode, the range is from -7 (1/128 second) to 3 (8 seconds) and the default value is 0 (1 second). In gptp mode, the range is from -3 (1/8 second) to 17 (131072 seconds, approximately 36 hours) with a default of -3.

Examples

These commands set the interval for PTP synchronization messages on interface ethernet 5 to 3 (8 seconds).

switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp sync-message interval 3
switch(config-if-Et5)#

In boundary mode, these commands restore the interval for PTP synchronization messages on interface ethernet 5 to its default of 0 (1 second).
```
switch(config)# interface ethernet 5
switch(config-if-Et5)# no ptp sync-message interval
switch(config-if-Et5)#
```

ptp transport

The ptp transport command configures the PTP transport type for a specific interface. Any values set in interface PTP configuration mode override the settings in the PTP configuration profile associated with the interface. The no ptp transport command removes the stetting from the running-config.

Command Mode

Interface-Ethernet Configuration

Interface-Port Channel Configuration

Command Syntax

ptp transport TRANSPORT_TYPE

no ptp transport

default ptp transport

Parameters

TRANSPORT_TYPE The transport mode in boundary clock mode. Options include:

ipv4 The IPv4 address used as the transport type on the interface.
ipv6 The IPv6 address used as the transport type on the interface.
layer2 The Layer 2 protocol used as the transport type on the interface.

Examples

This command overrides the transport type in the profile and sets it to be IPv4 for the interface.

switch(config)# interface ethernet 5
switch(config-if-Et5)# ptp transport ipv4
switch(config-if-Et5)#

This command removes the interval for PTP synchronization messages on interface Ethernet 5.

switch(config)# interface ethernet 5
switch(config-if-Et5)# no ptp transport 
switch(config-if-Et5)#

ptp ttl

The ptp ttl command configures the Time To Live (TTL) value of the PTP packets. The no ptp ttl resets the TTL value to the default value of 1 hop by removing the ptp ttl command from the running-config.

Command Mode

Global Configuration

Command Syntax

ptp ttl hop_count

no ptp ttl

default ptp ttl

Parameter

hop_count The TTL value measured in hops. Value ranges from 1 to 255, default is 1.

Examples

This command sets the time to live of the PTP packets to 60 hops.
```
switch(config)# ptp ttl 60
switch(config)#
```
This command resets the time to live of the PTP packets to the default value of 1 hop.
```
switch(config)# no ptp ttl
switch(config)#
```

ptp unicast-negotiation

The ptp unicast-negotiation command configures the master slave profiles for PTP devices.

Command Mode

Interface-Ethernet Configuration

Command Syntax

ptp unicast-negotiation

ptp unicast-negotiation remote-grantee

Parameters

candidate-grantor become slave to another PTP device.
remote-grantee become master to another PTP device.

Examples

This command sets up an interface as a potential master.

switch(config-if)# ptp unicast-negotiation remote-grantee 10.0.0.1/24
switch(config-if)# ptp unicast-negotiation remote-grantee 10.0.0.1/24 profile fastProfile

This command sets up an interface as a potential slave.

switch(config-if)# ptp unicast-negotiation candidate-grantor 10.0.0.1
switch(config-if)# ptp unicast-negotiation candidate-grantor 10.0.0.1 profile fastProfile

show ptp

The show ptp command displays summary Precision Time Protocol (PTP) information and PTP status of switch ports.

Command Mode

EXEC

Command Syntax

show ptp

Example

This command displays summary PTP information.

switch#show ptp
PTP Mode: gptp - Generalized PTP Clock
Clock Identity: 2001:0DB8:73:ff:ff:26:fd:90
Grandmaster Clock Identity: 2001:0DB8:96:ff:fe:6c:ed:02
Number of slave ports: 1
Number of master ports: 6
Slave port: Ethernet33
Mean Path Delay (nanoseconds): 718
Steps Removed: 1
Neighbor Rate Ratio: 1.00000007883
Rate Ratio: 1.00000007883
Interface StateASTime Since LastNeighborMean PathResidence 
Capable   Changed  Rate    Ratio              Delay (ns)  Time (ms) 
--------- -------- ------- ------------------ ----------- -----------  
Et1       Disabled No      Never              1.0          00
Et2       Disabled No      Never              1.0          00
Et3       Disabled No      Never              1.0          00
Et4       Disabled No      Never              1.0          00
Et5       Disabled No      Never              1.0          00
Et6       Disabled No      Never              1.0          00
Et7       Master           Yes                0:21:08      1.000000094200

show ptp foreign-master-record

The show ptp foreign-master-record command displays information about foreign masters (PTP sources not designated as the switch's master from which the switch has received sync packets).

Command Mode

EXEC

Command Syntax

show ptp foreign-master-record

Example

This command displays information about PTP foreign masters.

switch# show ptp foreign-master-record
No Foreign Master Records
switch#

show ptp interface counters

The show ptp interface counters command displays PTP interface counters for all interfaces.

Command Mode

EXEC

Command Syntax

show ptp[INTERFACE_NAME] counters

Parameters

INTERFACE_NAME Interface type and numbers. Options include:

no parameter Display information for all interfaces.
ethernet e_range Ethernet interface range specified by e_range.
loopback l_range Loopback interface specified by l_range
management m_range Management interface range specified by m_range.
port-channel p_range Port-Channel Interface range specified by p_range.
vlan v_range VLAN interface range specified by v_range.
VXLAN vx_range VXLAN interface range specified by vx_range.

Valid range formats include number, number range, or comma-delimited list of numbers and ranges.

Example

This command displays the PTP interface counters.

switch# show ptp interface ethernet 5 counters
Interface Ethernet5
Announce messages sent: 0
Announce messages received: 0
Sync messages sent: 0
Sync messages received: 0
Follow up messages sent: 0
Follow up messages received: 0
Delay request messages sent: 0
Delay request messages received: 0
Delay response messages sent: 0
Delay response messages received: 0
Peer delay request messages sent: 0
Peer delay request messages received: 0
Peer delay response messages sent: 0
Peer delay response messages received: 0
Peer delay response follow up messages sent: 0
Peer delay response follow up messages received: 0
switch#

show ptp interface

The show ptp interface command displays PTP information for all the interfaces on the device.

Command Mode

EXEC

Command Syntax

show ptp [INTERFACE_NAME][STATUS_FILTER]

Parameters

INTERFACE_NAME Interface type and numbers. Options include:
- no parameter Display information for all interfaces.
- ethernet e_range Ethernet interface range specified by e_range.
- loopback l_range Loopback interface specified by l_range.
- management m_range Management interface range specified by m_range.
- port-channel p_range Port-Channel Interface range specified by p_range.
- vlan v_range VLAN interface range specified by v_range.
Valid range formats include number, number range, or comma-delimited list of numbers and ranges.
STATUS_FILTER Filters interfaces by their configuration status. Options include:
- no parameter all interfaces.
- enabled PTP configured interfaces.

Example

This command displays PTP information for all the interfaces on the device.

switch# show ptp interface
Interface Ethernet1
PTP: Disabled
Port state: Disabled
Sync interval: 1.0 seconds
Announce interval: 2.0 seconds
Announce interval timeout multiplier: 3
Delay mechanism: end to end
Delay request message interval: 32.0 seconds
Transport mode: ipv4

Interface Ethernet5
PTP: Disabled
Port state: Disabled
Sync interval: 8.0 seconds
Announce interval: 2.0 seconds
Announce interval timeout multiplier: 5
Delay mechanism: peer to peer
Peer delay request message interval: 8.0 seconds
Peer Mean Path Delay: 0
Transport mode: ipv6

switch#

show ptp local-clock

The show ptp local-clock command displays the Precision Time Protocol (PTP) clock information.

Command Mode

EXEC

Command Syntax

show ptp local-clock

Example

This command shows how to display the PTP local clock and offset.

switch# show ptp local-clock
PTP Mode: Boundary Clock
Clock Identity: 0x00:1c:73:ff:ff:1e:83:24
Clock Domain: 1
Number of PTP ports: 24
Priority1: 128
Priority2: 128
Clock Quality:
   Class: 248
   Accuracy: 0x30
   OffsetScaledLogVariance: 0xffff
Offset From Master: 0
Mean Path Delay: 0
Steps Removed: 0
switch#

show ptp masters

The show ptp masters command displays information about the switch's PTP master and grand master clocks.

Command Mode

Privileged EXEC

Command Syntax

show ptp masters

Example

This command displays information about the switchs PTP master and grand master clocks.

switch# show ptp masters
Parent Clock:
Parent Clock Identity: 0x00:1c:73:ff:ff:00:72:40
Parent Port Number: 0
Parent IP Address: N/A
Observed Parent Offset (log variance): N/A
Observed Parent Clock Phase Change Rate: N/A

Grandmaster Clock:
Grandmaster Clock Identity: 0x00:1c:73:ff:ff:00:72:40
Grandmaster Clock Quality:
   Class: 248
   Accuracy: 0x30
   OffsetScaledLogVariance: 0xffff
   Priority1: 128
   Priority2: 128
switch#

show ptp monitor

The show ptp monitor command to displays the list of up to 100 recorded entries of offset from master, mean path delay and skew values, along with current PTP mode, whether or not the feature is enabled, number of entries displayed and the configured thresholds for each metric. Entries are sorted by the system time at which the value was calculated, starting with the most recent data at the top.

Command Mode

EXEC

Command Syntax

show ptp monitor

Example

This command displays the information recorded by PTP monitoring.

switch# show ptp monitor 
PTP Mode: Boundary Clock 
Ptp monitoring: enabled 
Number of entries: 5 
Offset from master threshold: 1500 
Mean path delay threshold: not configured 
Skew threshold: 0.5 
Interface  Time                          Offset from   Mean Path     Skew         
                                         Master (ns)   Delay (ns) 
---------- ----------------------------- ------------  ------------- ----------- 
Et8        21:23:12.901 UTC Feb 22 2018  71            5849           1.003159918 
Et1        21:23:12.901 UTC Feb 22 2018  113           3672           1.004990621 
Et2        21:23:12.901 UTC Feb 22 2018  706           7799           1.002744199 
Et1        21:23:12.901 UTC Feb 22 2018  803           5861           1.003432049 
Et1        21:23:12.901 UTC Feb 22 2018  610           3415           0.998974658

show ptp source ip

The show ptp source ip command displays the PTP source IP for the device.

Command Mode

Privileged EXEC

Command Syntax

show ptp source ip

Example

This command shows the PTP source IP to be 10.0.2.1

switch# show ptp source ip
PTP source IP: 10.0.2.1
switch#

This command shows the PTP source IP to be 2001:db8:ac10:fe01::

switch# show ptp source ip
PTP source IP: 2001:db8:ac10:fe01::
switch#

show ptp unicast-negotiation

The show ptp unicast-negotiation command displays PTP unicast negotiation information for the switch.

Command Mode

EXEC

Command Syntax

show ptp unicast-negotiation profile

show ptp unicast-negotiation [DETAILS]

Parameters

DETAILS Details requested. Options include:

candidate-grantor Display all configured candidate grantors, associated profile name and latest update.
remote-grantee Display all configured remote grantees, associated profile name and latest update.
granted Display to which remote grantees each port has granted and some detail.
requested Display to which candidate grantors each port has requested and some detail.

Examples

This command displays the unicast negotiation profiles configured on the switch.

switch# show ptp unicast-negotiation profile
Unicast Negotiation Profile fastProfile
Announce interval: 0.25 seconds
Announce duration: 500 seconds
Sync interval: 0.125 seconds
Sync duration: 300 seconds
Delay Response interval: 0.125 seconds
Delay Response duration: 300 seconds

This command displays all configured candidate grantors, associated profile name and latest update.

switch# show ptp unicast-negotiation candidate-grantor
 Interface  Address    Profile        Grantor Status
----------- ---------- -------------- ------------------ 
 Ethernet1  4::1       fastProfile    Master
 Ethernet1  4::2       fastProfile    Candidate Master
 Ethernet2  4::2       fastProfile    Blacklisted

This command displays all configured remote grantees, associated profile name and latest update.

switch# show ptp unicast-negotiation remote-grantee
 Interface    Address    Profile
------------ ---------- -------------
 Ethernet1    4::1/96    fastProfile
 Ethernet1    4::2/96    fastProfile
 Ethernet2    4::2/96    fastProfile

This command displays to which remote grantees each port has granted and some detail.

switch# show ptp unicast-negotiation granted 
Interface    Address    Message     Interval       Duration       Expires In
----------- ---------- ------------ -------------- -------------- -----------
 Ethernet2   4::1       Announce    0.25 seconds   300 seconds    30 seconds
 Ethernet2   4::1       Sync        2.0 seconds    300 seconds    30 seconds

This command displays to which candidate grantors each port has requested and some detail.

switch# show ptp unicast-negotiation requested  
Interface    Address   Message     Interval        Duration       Expires In
------------ --------- ----------- --------------- -------------- ------------
 Ethernet2   4::2      Announce    0.25 seconds    600 seconds    250 seconds
 Ethernet2   4::2      Sync        2.0 seconds     300 seconds    denied

show ptp unicast-negotiation profile

The show ptp unicast-negotiation profile command displays all user configured profiles and their values.

Command Mode

EXEC

Command Syntax

show ptp unicast-negotiation profile

Example

This command displays the PTP profiles.

switch# show ptp unicast-negotiation profile
Unicast Negotiation Profile fastProfile
Announce interval: 0.25 seconds
Announce duration: 500 seconds
Sync interval: 0.125 seconds
Sync duration: 300 seconds
Delay Response interval: 0.125 seconds
Delay Response duration: 300 seconds

Switch Environment Control

The following sections describe the commands that display temperature, fan, and power supply status:

The switch chassis, fans, power supplies, line cards, and supervisors also provide LEDs that signal status and conditions that require attention. The Quick Start Guide for the individual switches provides information about their LEDs.

Environment Control Introduction

Arista switching platforms are designed to work reliably in common data center environments.

To ensure their reliable operation and to monitor or diagnose the switch's health, Arista provides a set of monitoring capabilities available through the CLI or SNMP entity MIBs to monitor and diagnose potential problems with the switching platform.

Environment Control Overview

This section contains the following topics:

Temperature
Fans
Power

Temperature

Arista switches include internal temperature sensors. The number and location of the sensors vary with each switch model. Each sensor is assigned temperature thresholds that denote alert and critical conditions. Temperatures that exceed the threshold trigger the following:

Alert Threshold: All fans run at maximum speed, and a warning message is logged.
Critical Threshold: The component is shut down immediately, and its Status LED flashes orange.

In modular systems, cards are shut down when their temperatures exceed the critical threshold. The switch is shut down if the temperature remains above the critical threshold for three minutes.

Fans

Arista switches include fan modules that maintain internal components at proper operating temperatures. The number and type of fans vary with switch chassis type:

Fixed configuration switches contain hot-swappable independent fans. Fan models with different airflow directions are available, but all fans within a switch must have the same airflow direction.
Modular switches contain independent fans that circulate air from the front to the rear panel. The power supplies for modular switches also include fans that cool the power supply and supervisors.

The switch operates normally when one fan is not operating. Non-functioning modules should only be removed from the switch if they are immediately replaced; adequate switch cooling requires the installation of all components, including a non-functional fan.

Two non-operational fans trigger an insufficient fan shutdown condition. Under normal operations, this condition initiates a switch power-down procedure.

Fans are accessible from the rear panel.

Power

Arista switches contain power supplies that provide power to internal components.

Fixed configuration switches contain two power supplies, providing 1+1 redundancy.
Modular switches contain four power supplies, providing a minimum of 2+2 redundancy.

Power supply LED indicators are visible from the rear panel.

Configuring and Viewing Environment Settings

This section contains the following topics:

Overriding Automatic Shutdown
Viewing Environment Status
Locating Components on the Switch

Overriding Automatic Shutdown

This section contains the following topics:

Overheating
Insufficient Fans
Fan Speed

Overheating

The switch can be configured to continue operating during temperature shutdown conditions. Ignoring a temperature shutdown condition is strongly discouraged because operating at high temperatures can damage the switch and void the warranty.

Temperature shutdown condition actions are specified by the environment overheat action command. The switch displays this warning when configured to ignore shutdown temperature conditions.

switch(config)# environment overheat action ignore
====================================================================
WARNING: Overriding the system shutdown behavior when the system
is overheating is unsupported and should only be done under
the direction of an Arista Networks engineer. You risk damaging
hardware by not shutting down the system in this situation, and doing
so without direction from Arista Networks can be grounds for voiding
your warranty. To re-enable the shutdown-on-overheat behavior, use
the 'environment overheat action shutdown' command.
====================================================================
Switch(config)#

The running-config contains the environment overheat action command when set to ignore. When the command is not in running-config, the switch shuts down when an overheating condition exists.

The following running-config file lists the environment overheat action command.

switch# show running-config
! Command: show running-config
! device: switch (DCS-7150S-64-CL, EOS-4.13.2F)


ip route 0.0.0.0/0 10.255.255.1
!
environment overheat action ignore
!
!
end
switch#

Insufficient Fans

The switch can be configured to ignore the insufficient fan shutdown condition. This is strongly discouraged because continued operation without sufficient cooling may lead to a critical temperature condition that can damage the switch and void the warranty.

Insufficient-fans shutdown override is configured by the environment insufficient-fans action command. The switch displays this warning when configured to ignore insufficient-fan conditions.

switch(config)# environment insufficient-fans action ignore
====================================================================
WARNING: Overriding the system shutdown behavior when the system
has insufficient fans inserted is unsupported and should only be done 
under
the direction of an Arista Networks engineer. You risk damaging
hardware by not shutting down the system in this situation, and doing
so without direction from Arista Networks can be grounds for voiding
your warranty. To re-enable the shutdown-on-overheat behavior, use
the 'environment insufficient-fans action shutdown' command.
====================================================================
switch(config)#

The running-config contains the environment insufficient-fans action command when set to ignore. When running-config does not contain this command, the switch shuts down when it detects an insufficient-fans condition.

Fan Speed

The switch can be configured to override the automatic fan speed. The switch normally controls the fan speed to maintain optimal operating temperatures. The fans can be configured to operate at a constant speed regardless of the switch temperature conditions.

Fan speed override is configured by the environment fan-speed command. The switch displays this warning when its control of fan speed is overridden.

switch(config)# environment fan-speed override 50
====================================================================
WARNING: Overriding the system fan speed is unsupported and should only
be done under the direction of an Arista Networks engineer.
You can risk damaging hardware by setting the fan speed too low
and doing so without direction from Arista Networks can be grounds
for voiding your warranty.
To set the fan speed back to automatic mode, use the
'environment fan-speed auto' command
====================================================================
switch(config)#

The running-config contains the environment fan-speed override command if it is set to override. When running-config does not contain this command, the switch controls the fan speed.

Viewing Environment Status

This section contains the following topics:

Power Status
Temperature Status
Fan Status
System Status

Power Status

The show environment power command displays the status of the power supplies.

Example

This command displays the status of the power supplies.

switch> show environment power
Power Input Output Output
Supply  Model         Capacity  Current  Current  Power    Status
------- ------------- --------- -------- -------- -------- -------
1       PWR-650AC      650W      0.44A    10.50A  124.0W   Ok
Switch>

Temperature Status

To display internal temperature sensor status, enter show environment temperature.

switch> show environment temperature
System temperature status is: Ok
                                               Alert      Critical
Sensor  Description               Temperature  Threshold  Threshold
------- ------------------------- ------------ ---------- ----------
1       Front-panel temp sensor   22.000C       65C        75C
2       Fan controller 1 sensor   23.000C       75C        85C
3       Fan controller 2 sensor   28.000C       75C        85C
4       Switch chip 1 sensor      40.000C       105C       115C
5       VRM 1 temp sensor         48.000C       105C       110C
switch>

System temperature status is the first line that the command displays. System temperature status values indicate the following:

Ok: All sensors report temperatures below the alert threshold.
Overheating: At least one sensor reports a temperature above its alert threshold.
Critical: At least one sensor reports a temperature above its critical threshold.
Unknown: The switch is initializing.
Sensor Failed: At least one sensor is not functioning.

Fan Status

The show system environment cooling command displays the cooling and fan status.

Example

This command displays the fan and cooling status:

switch> show system environment cooling
System cooling status is: Ok
Ambient temperature: 22C
Airflow: port-side-intake
Fan Tray  Status          Speed
--------- --------------- ------
1 Ok 35%
2 Ok 35%
3 Ok 35%
4 Ok 35%
5 Ok 35%
switch>

System Status

The show system environment all command lists the temperature, cooling, fan, and power supply information the individual show environment commands display, as described in Temperature Status, Fans, and Power.

Example

This command displays the temperature, cooling, fan, and power supply status:

switch> show system environment all
System temperature status is: Ok
                                               Alert      Critical
Sensor  Description              Temperature   Threshold  Threshold
------- ------------------------ ------------- ---------- ----------
1       Front-panel temp sensor   22.750C       65C        75C
2       Fan controller 1 sensor   24.000C       75C        85C
3       Fan controller 2 sensor   29.000C       75C        85C
4       Switch chip 1 sensor      41.000C       105C       115C
5       VRM 1 temp sensor         49.000C       105C       110C

System cooling status is: Ok
Ambient temperature: 22C
Airflow: port-side-intake
Fan Tray  Status           Speed
--------- --------------- ------
1         Ok                 35%
2         Ok                 35%
3         Ok                 35%
4         Ok                 35%
5         Ok                 35%

Power                         Input    Output   Output
Supply  Model       Capacity  Current  Current  Power    Status
------- ----------- --------- -------- -------- -------- -------
1       PWR-650AC   650W       0.44A   10.50A   124.0W   Ok

Locating Components on the Switch

When a component requires service, the switch administrator may use the locator-led command to assist a technician in finding the component. The command causes the status LED on the specified component to flash and display a “service requested” message on the LCD panel of modular switches or lights the blue locator light on the front of fixed switches. Use the show locator-led command to display all locator LEDs currently enabled on the switch.

This command enables the locator LED on fan tray 3:

switch# locator-led fantray 3
Enabling locator led for FanTray3
switch#

This command displays all locator LEDs enabled on the switch:

switch# show locator-led
There are no locator LED enabled
switch#

Environment Commands

Environment Control Configuration Commands

environment fan-speed
environment insufficient-fans action
environment overheat action
locator-led

environment fan-speed

The environment fan-speed command determines how to control the speed of the switch fans. By default, the switch automatically controls the fan speed.

The switch normally controls the fan speed to maintain optimal operating temperatures. The fans can be configured to operate at a constant speed regardless of the switch temperature conditions.

The no environment fan-speed and default environment fan-speed commands restore the default action of automatic fan-speed control by removing the environment fan-speed override statement from running-config.

Note: Overriding the system fan speed is unsupported and should only be done under the direction of an Arista Networks engineer. You can risk damaging hardware by setting the fan speed too low. Doing so without direction from Arista Networks can be grounds for voiding your warranty.

Command Mode

Global Configuration

Command Syntax

environment fan-speed ACTION

no environment fan-speed

default environment fan-speed

Parameters

ACTION Fan speed control method. Valid settings include:

auto Fan speed is controlled by the switch.
This option restores the default setting by removing the environment fan-speed override command from running-config
override percent Fan speed is set to the specified percentage of the maximum. Valid percent settings range from 30 to 100.

Examples

This command overrides the automatic fan speed control and configures the fans to operate at 50% of maximum speed.

switch(config)# environment fan-speed override 50
====================================================================
WARNING: Overriding the system fan speed is unsupported and should 
only be done under the direction of an Arista Networks engineer.
You can risk damaging hardware by setting the fan speed too low
and doing so without direction from Arista Networks can be grounds
for voiding your warranty.
To set the fan speed back to automatic mode, use the
'environment fan-speed auto' command
====================================================================
switch(config)#

This command restores control of the fan speed to the switch.
```
switch(config)# environment fan-speed auto
switch(config)#
```

environment insufficient-fans action

The environment insufficient-fans command controls the switch response to the insufficient fan condition. By default, the switch initiates a shutdown procedure when it senses insufficient fans.

Two non-operational fans trigger an insufficient fan shutdown condition. This condition normally initiates a power-down procedure.

The no environment insufficient-fans and default environment insufficient-fans commands restore the default shutdown response to the insufficient-fans condition by removing the environment insufficient-fans action ignore statement from running-config.

Note: Overriding the system shutdown behavior when the system has insufficient fans inserted is unsupported and should only be done under the direction of an Arista Networks engineer. You risk damaging hardware by not shutting down the system in this situation, and doing so without direction from Arista Networks can be grounds for voiding your warranty.

Command Mode

Global Configuration

Command Syntax

environment insufficient-fans action REMEDY

no environment insufficient-fans action

default environment insufficient-fans action

Parameters

REMEDY Configures action when the switch senses an insufficient fan condition. Settings include:

ignore Switch continues operating when insufficient fans are operating.
shutdown Switch shuts the power down when insufficient fans are operating.
The shutdown parameter restores default behavior by removing the environment insufficient-fans command from running-config.

Examples

This command configures the switch to continue operating after it senses insufficient fan condition.

switch(config)# environment insufficient-fans action ignore
====================================================================
WARNING: Overriding the system shutdown behavior when the system
has insufficient fans inserted is unsupported and should only be done 
under the direction of an Arista Networks engineer. You risk damaging
hardware by not shutting down the system in this situation, and doing
so without direction from Arista Networks can be grounds for voiding
your warranty. To re-enable the shutdown-on-overheat behavior, use
the 'environment insufficient-fans action shutdown' command.
====================================================================

This command configures the switch to shut down when it senses an insufficient fan condition.
```
switch(config)# environment insufficient-fans action shutdown
switch(config)#
```

environment overheat action

The environment overheat command controls the switch's response to an overheat condition. By default, the switch shuts down when it senses an overheat condition.

Note: Overriding the system shutdown behavior when the system is overheating is unsupported and should only be done under the direction of an Arista Networks engineer. You risk damaging hardware by not shutting down the system in this situation, and doing so without direction from Arista Networks can be grounds for voiding your warranty.

Alert Threshold: All fans run at maximum speed, and a warning message is logged.
Critical Threshold: The component is shut down immediately, and its Status LED flashes orange.

In modular systems, cards are shut down when their temperatures exceed the critical threshold. The switch normally shuts down if the temperature remains above the critical threshold for three minutes.

The no environment overheat action, and default environment overheat action commands restore the default shutdown response to the environment overheat condition by removing the environment overheat action ignore statement from running-config.

Command Mode

Global Configuration

Command Syntax

environment overheat action REMEDY

no environment overheat action

default environment overheat action

Parameters

REMEDY Reaction to an overheat condition. The default value is shutdown.

shutdown Switch shuts power down by an overheat condition.
ignore Switch continues operating during an overheat condition.

Examples

This command configures the switch to continue operating after it senses an overheat condition.

switch(config)# environment overheat action ignore
====================================================================
WARNING: Overriding the system shutdown behavior when the system
is overheating is unsupported and should only be done under
the direction of an Arista Networks engineer. You risk damaging
hardware by not shutting down the system in this situation, and doing
so without direction from Arista Networks can be grounds for voiding
your warranty. To re-enable the shutdown-on-overheat behavior, use
the 'environment overheat action shutdown' command.
====================================================================
switch(config)#

This command configures the switch to shut down when it senses an overheat condition.
```
switch(config)# environment overheat action shutdown
switch(config)#
```

locator-led

When a component requires service, the locator-led command activates a locator to assist a technician in finding the component. The command causes the status LED on the specified component to flash and display a “service requested” message on the LCD panel of modular switches or lights the blue locator light on the front of fixed switches. The available locators vary by platform; to see a list of the locator LEDs available on the switch, use the locator-led ? command. To trun off the locator LED, use the no locator-led command.

Command Mode

Privileged EXEC

Command Syntax

locator-led {fantray tray_num | interface interface | module module_num | powersupply supply_num}

no locator-led {fantray tray_num | interface interface | module module_num | powersupply supply_num}

Parameters

fantray tray_num Activates the locator LED on specified fan tray.
interface interface Activates the locator LED on specified interface.
module module_num Activates the locator LED on specified module.
powersupply supply_num Activates the locator LED on specified power supply.

Examples:

This command enables the locator LED on fantray 3.

switch# locator-led fantray 3
Enabling locator led for FanTray3
switch#

This command disables the locator LED on fantray 3.

switch# no locator-led fantray 3
Disabling locator led for FanTray3
switch#

This command displays the locator LEDs available on the switch.

switch# locator-led ?
  fantray      Fan tray LED
  interface    Interface LED
  module       Module LED
  powersupply  Power supply LED
switch#

show environment power

The show environment power command displays the status of all power supplies in the switch.

Command Mode

EXEC

Command Syntax

show environment power [INFO_LEVEL]

Parameters

INFO_LEVEL Specifies level of detail that the command displays. Options include:

no parameter Displays current and power levels for each supply.
detail Also includes status codes that can report error conditions.

Example

This command displays the status of power supplies on the switch.

switch> show environment power
Power                        Input    Output   Output
Supply  Model      Capacity  Current  Current  Power    Status
------- ---------- --------- -------- -------- -------- -------
1       PWR-760AC  760W       0.81A    11.00A   132.8W   Ok
2       PWR-760AC  760W       0.00A    0.00A    0.0W AC  Loss
switch>

show environment temperature

The show environment temperature command displays the operating temperature of all sensors on the switch.

Command Mode

EXEC

Command Syntax

show environment temperature [MODULE_NAME] [INFO_LEVEL]

Parameters

MODULE_NAME Specifies modules for which data is displayed. This parameter is only available on modular switches. Options include:
- no parameter All modules (identical to all option).
- fabric fab_num Specified fabric module. Number range varies with switch model.
- linecard line_num Line card module. Number range varies with switch model.
- supervisor super_num Supervisor module. Number range varies with switch model.
- mod_num Supervisor (1 to 2) or line card (3 to 18) module.
- all All modules.
INFO_LEVEL Specifies level of detail that the command displays. Options include:
- no parameter Displays table that lists the temperature and thresholds of each sensor.
- detail Displays data block for each sensor listing the current temperature and historic data.

Display Values

System temperature status is the first line that the command displays. Values report the following:

Ok All sensors report temperatures below the alert threshold.
Overheating At least one sensor reports a temperature above its alert threshold.
Critical At least one sensor reports a temperature above its critical threshold.
Unknown The switch is initializing.
Sensor Failed At least one sensor is not functioning.

Examples

This command displays a table that lists the temperature measured by each sensor.

switch> show environment temperature
System temperature status is: Ok
                                              Alert      Critical
Sensor  Description              Temperature  Threshold  Threshold
------- ------------------------ ------------ ---------- ----------
1       Front-panel temp sensor   30.750C       65C        75C
2       Fan controller 1 sensor   32.000C       75C        85C
3       Fan controller 2 sensor   38.000C       75C        85C
4       Switch chip 1 sensor      50.000C       105C       115C
5       VRM 1 temp sensor         60.000C       105C       110C
switch>

This command lists the temperature detected by each sensor and includes the number of previous alerts, the time of the last alert, and the time of the last temperature change.

switch> show environment temperature detail
TempSensor1 - Front-panel temp sensor
                       Current State   Count    Last Change
  Temperature          30.750C
  Max Temperature      35.000C                  4 days, 23:35:24 ago
  Alert                 False           0        never

TempSensor2 - Fan controller 1 sensor
                       Current State    Count    Last Change
  Temperature           32.000C
  Max Temperature       36.000C                  4 days, 23:32:46 ago
  Alert                  False           0        never

TempSensor3 - Fan controller 2 sensor
                        Current State    Count     Last Change
  Temperature            38.000C
  Max Temperature        41.000C                   4 days, 23:37:56 ago
  Alert                  False            0        never

TempSensor4 - Switch chip 1 sensor
                         Current State    Count    Last Change
  Temperature            51.000C
  Max Temperature        53.000C                    4 days, 23:35:16 ago
  Alert                  False              0       never

TempSensor5 - VRM 1 temp sensor
                          Current State     Count    Last Change
  Temperature             60.000C
  Max Temperature         62.000C                    4 days, 22:54:51 ago
  Alert                   False             0        never

switch>

show locator-led

The show locator-led command displays the status of locator LEDs enabled on the switch.

Command Mode

Privileged EXEC

Command Syntax

show locator-led

Example

This command displays all locator LEDs enabled on the switch.

switch# show locator-led
There are no locator LED enabled
switch#

show system environment all

The show system environment all command displays temperature, cooling, and power supply status.

Command Mode

EXEC

Command Syntax

show system environment all

Example

This command displays the switch’s temperature, cooling, and power supply status

switch> show system environment all
System temperature status is: Ok
                                              Alert      Critical
Sensor  Description              Temperature  Threshold  Threshold
------- ------------------------ ------------- ---------- ----------
1       Front-panel temp sensor   31.000C       65C        75C
2       Fan controller 1 sensor   32.000C       75C        85C
3       Fan controller 2 sensor   38.000C       75C        85C
4       Switch chip 1 sensor      50.000C       105C       115C
5       VRM 1 temp sensor         60.000C       105C       110C

System cooling status is: Ok
Ambient temperature: 31C
Airflow: port-side-intake
Fan Tray  Status           Speed
--------- --------------- ------
1         Ok                 52%
2         Ok                 52%
3         Ok                 52%
4         Ok                 52%
5         Ok                 52%

Power                         Input    Output   Output
Supply  Model       Capacity  Current  Current  Power    Status
------- ----------- --------- -------- -------- -------- -------
1       PWR-760AC    760W     0.81A    11.00A    132.6W  Ok
2       PWR-760AC    760W     0.00A     0.00A      0.0W  AC Loss

switch>

show system environment cooling

The show system environment cooling command displays fan status, air flow direction, and ambient temperature on the switch.

Command Mode

EXEC

Command Syntax

show system environment cooling [INFO_LEVEL]

Parameters

INFO_LEVEL Specifies level of detail that the command displays. Options include:
- no parameter Displays the fan status, air flow direction, and ambient switch temperature.
- detail Also displays actual and configured fan speed of each fan.

Status

System Cooling Status
- Ok No more than one fan has failed or is not inserted.
- Insufficient fans More than one fan has failed or is not inserted. This status is also displayed if fans with different airflow directions are installed. The switch shuts down if the error is not resolved.
- Ambient temperature Temperature of the surrounding area.
- Airflow Indicates the direction of the installed fans:
  - port-side-intake All fans flow air from the front (port side) to the rear of the chassis.
  - port-side-exhaust All fans flow air from the rear to the front (port side) of the chassis.
  - incompatible fans Fans with different airflow directions are inserted.
  - Unknown The switch is initializing.
Fan Tray Status table Displays the status and operating speed of each fan. Status values indicate the following conditions:
- OK The fan is operating normally.
- Failed The fan is not operating normally.
- Unknown The system is initializing.
- Not Inserted The system is unable to detect the specified fan.
- Unsupported The system detects a fan that the current software version does not support.

Example

This command displays the fan status, air flow direction, and ambient switch temperature.

switch> show system environment cooling
System cooling status is: Ok
Ambient temperature: 30C
Airflow: port-side-intake
Fan Tray  Status           Speed
--------- --------------- ------
1         Ok                 51%
2         Ok                 51%
3         Ok                 51%
4         Ok                 51%
5         Ok                 51%
switch>

show system environment power budget

The show system environment power budget command displays the configured power budget for PoE switches and a table to show the current consumption.

Command Mode

EXEC

Command Syntax

show system environment power budget

This command displays the configured power budget for a PoE switch and a table to show the current consumption

switch> show system environment power budget
Budget is 300.0W out of 1425.2W of total power
Active devices using up to 60.0W

Device                  Consumed               
Name                    Power                  
----------------------- -----------------------
Ethernet37              30.0W                  
Ethernet38              30.0W                  
Total                   60.0W 

switch>

Timing Protocols

The Precision Time Protocol (PTP) provides clock accuracy for networked devices, allowing clocks to be synchronized locally in increments of less than a microsecond. PTP uses a master-slave hierarchy similar to that used by NTP. The master clock provides the most precise time, and slave devices use its signal to synchronize their clocks.

The master clock sends a sync request, called an announce message by the IEEE 1588-2008 standard, at a regular interval. The slave clock responds with a time-stamped delay request message in order to measure and compensate for packet delays between the devices. The slave then receives a message from the master specifying the time of the delay message and allows the slave to calculate final values for clock synchronization. The time maintains synchronization by regularly exchanging PTP packets between master and slave.

Note: Arista switches do not support setting the system clock using PTP. Use the NTP service on the PTP grandmaster for system clock synchronization.

EOS disables PTP globally by default. Enabling PTP on an interface requires the following steps:

Optional PTP global configurations include the following:

Optional PTP interface-level configurations include the following:

Page 11 of 15

End of Support

Setting the Interval for Sending Synchronization Messages

Setting the PTP Transport Type

Setting the Local Priority of the Clock and Interfaces

Setting up as a Slave to another PTP Device

Setting up as a Master to another PTP Device

Setting the masterOnly Flag

Configuring the Unicast Profile

Displaying Unicast Negotiation Configurations

Viewing PTP Settings and Status

Displaying General PTP Information

Displaying PTP Clock Properties

Displaying PTP Foreign Master

Displaying PTP Information for all Interfaces

Displaying PTP Interface Counters

Displaying PTP Local Clock and Offset

Displaying PTP Masters Information

Displaying PTP Monitoring Information

Displaying PTP Source IP

Precision Time Protocol (PTP) Commands

ptp announce interval

ptp announce timeout

ptp delay-mechanism

ptp delay-req interval

ptp domain

ptp enable

ptp forward-v1

ptp hold-ptp-time

ptp local-priority

ptp mode

ptp monitor threshold mean-path-delay

ptp monitor threshold offset-from-master

ptp monitor threshold skew

ptp monitor

ptp pdelay-neighbor-threshold

ptp pdelay-req interval

ptp priority1

ptp priority2

ptp role

ptp source

ptp sync timeout

ptp sync-message interval

ptp transport

ptp ttl

ptp unicast-negotiation

show ptp

show ptp foreign-master-record

show ptp interface counters

show ptp interface

show ptp local-clock

show ptp masters

show ptp monitor

show ptp source ip

show ptp unicast-negotiation

show ptp unicast-negotiation profile

Switch Environment Control

Environment Control Introduction

Environment Control Overview

Temperature

Fans

Power

Configuring and Viewing Environment Settings

Overriding Automatic Shutdown

Overheating

Insufficient Fans

Fan Speed

Viewing Environment Status

Power Status

Temperature Status

Fan Status

System Status

Locating Components on the Switch

Environment Commands

Environment Control Configuration Commands

Environment Display Commands

environment fan-speed

environment insufficient-fans action

environment overheat action

locator-led

show environment power