To set the minimum interval between the PTP peer delay-request messages, use the ptp pdelay-req interval command.
Example
switch(config-if-Et5)# ptp pdelay-request interval 3
switch(config-if-Et5)#To set the delay threshold for which the peer will be considered unable to run generalized Precision Time Protocol (gPTP), use the ptp pdelay-neighbor-threshold command.
Example
switch(config-if-Et5)# ptp pdelay-neighbor-threshold 200000
switch(config-if-Et5)#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
switch(config-if-Et5)# ptp sync-message interval 3
switch(config-if-Et5)#switch(config-if-Et5)# ptp transport ipv4
switch(config-if-Et5)#switch(config-if)# ptp transport ipv6
switch(config-if)#switch(config)# ptp local-priority 1
switch(config-if)# ptp local-priority 255Each 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.
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 fastProfileEach 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.
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 fastProfileswitch(config-if)# ptp role masterA 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.
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(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)# 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(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(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(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(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 2018The show ptp interface command displays the interface local priority in G8275.2 mode.
(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: 101To 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.000000094200To 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#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#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#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# 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#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#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.998974658To 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#The most simple and efficient way to make the most of the extensibility on which EOS is built is through the use of extensions. An extension is a pre-packaged optional feature or a set of scripts in an RPM Package Manager (RPM) or Software image extension (SWIX) format. A variety of extensions are available from the EOS Central page at https://www.arista.com/en/.
Complete the following steps to install an EOS extension.
Complete the following steps to install an EOS extension on a dual-supervisor switch.
Complete the steps to verify that the EOS extensions are installed correctly.
Complete the following steps to uninstall an EOS extension.
The banner login command configures a message that the switch displays before login and password prompts. The login banner is available on console, telnet, and ssh connections.
The no banner login and default banner login commands delete the login banner.
Command Mode
Global Configuration
Command Syntax
banner login
no banner login
default banner login
switch(config)# banner login
Enter TEXT message. Type 'EOF' on its own line to end.
This is a login banner for $(hostname).
Enter your login name at the prompt.
EOF
switch(config)#This is a login banner for switch.
Enter your login name at the prompt.
switch login:john
Password:
Last login: Mon Jan 14 09:05:23 2013 from adobe-wrks.aristanetworks.com
switch>The banner motd command configures a message of the day (motd) that the switch displays after a user logs in. The motd banner is available on console, telnet, and ssh connections.
The no banner motd and default banner motd commands delete the motd banner.
Command Mode
Global Configuration
Command Syntax
banner motd
no banner motd
default banner motd
switch(config)# banner motd
Enter TEXT message. Type 'EOF' on its own line to end.
This is an motd banner for $(hostname)
EOF
switch(config)#switch login: john
Password:
Last login: Mon Jan 14 09:17:09 2013 from adobe-wrks.aristanetworks.com
This is an motd banner for Switch
switch>The clear ptp interface counters command resets the Precision Time Protocol (PTP) packet counters.
Command Mode
Privileged EXEC
Command Syntax
clear ptp interface [INTERFACE_NAME] counters
Parameters
Valid parameter formats include number, number range, or comma-delimited list of numbers and ranges.
Example
switch# clear ptp counters
switch#The clock set command sets the system clock time and date. If the switch is configured with an NTP server, NTP time synchronizations override manually entered time settings.
Time entered by this command is local, as configured by the clock timezone command.
Command Mode
Privileged EXEC
Command Syntax
clock set hh:mm:ss date
Example
switch# clock set 08:15:24 14 Jan 2013
Mon Jan 14 08:15:25 2013
timezone is US/CentralThe clock timezone command specifies the UTC offset that converts system time to local time. The switch uses local time for time displays and to time-stamp system logs and messages.
The no clock timezone and default clock timezone commands delete the timezone statement from running-config, setting local time to UTC.
Command Mode
Global Configuration
Command Syntax
clock timezone zone_name
no clock timezone
default clock timezone
Parameters
zone_name the time zone. Settings include a list of predefined time zone labels.
switch(config)# clock timezone US/Central
switch(config)# show clock
Fri Jan 11 18:42:49 2013
timezone is US/Central
switch(config)#switch(config)# clock timezone ?
Africa/Abidjan Africa/Accra
Africa/Addis_Ababa Africa/Algiers
Africa/Asmara Africa/Asmera
Africa/Bamako Africa/Bangui
W-SU W-SU timezone
WET WET timezone
Zulu Zulu timezone
switch(config)#clock timezoneswitch(config)# clock timezone AMERICA?
America/Adak America/Anchorage
America/Anguilla America/Antigua
America/Araguaina America/Argentina/Buenos_Aires
America/Virgin America/Whitehorse
America/Winnipeg America/Yakutat
America/Yellowknife
switch(config)#clock timezone AMERICAThe dns domain command configures the switchs domain name. The switch uses this name to complete unqualified host names.
The no dns domain and default dns domain commands delete the domain name by removing the dns domain command from running-config.
Command Mode
Global Configuration
Command Syntax
dns domain string
no dns domain
default dns domain
Parameter
string domain name (text string).
Example
switch(config)# dns domain aristanetworks.com
switch(config)#The email command places the switch in email client configuration mode. If you configure a from-user and an outgoing SMTP server on the switch, you can then use an email address as an output modifier to a show command and receive the output as email.
Command Mode
Global Configuration
Command Syntax
Example
switch(config)# email
switch(config)#The event-monitor backup max-size command specifies the quantity of event monitor backup files the switch maintains. Values range from 1 to 200 files with a default of ten files.
The event-monitor backup path command specifies the path/name of these files. The switch appends an extension to the file name that tracks the creation order of backup files. When the quantity of files exceeds the configured limit, the switch deletes the oldest file.
The no event-monitor backup max-size and default event-monitor backup max-size command restores the default maximum number of backup files the switch can store to ten by removing the corresponding event-monitor backup max-size command from running-config.
Command Mode
Global Configuration
Command Syntax
event-monitor backup max-size file_quantity
no event-monitor backup max-size
default event-monitor backup max-size
Parameter
file_quantity maximum number of backup files. Value ranges from 1 to 200. Default is 10.
Example
switch(config)# event-monitor backup path sw-event.log
switch(config)# event-monitor backup max-size 4
switch(config)#The first five files that the switch creates to store event monitor buffer contents are:
sw-event.log.0
sw-event.log.1
sw-event.log.2
sw-event.log.3
sw-event.log.4
The switch deletes sw-event.log.0 the first time it verifies the number of existing backup files after the creation of sw-event.log.4.
The event-monitor backup path command enables the storage of the event monitor buffer to switch files and specifies the path/name of these files. The command references the file location either from the flash drive root directory (/mnt/flash) where the CLI operates or from the switch root directory (/).
The event monitor buffer is circular after the buffer is filled, new data is written to the beginning of the buffer, replacing old data. At the conclusion of each buffer writing cycle, it is copied into a new backup file before the switch starts re-writing the buffer. The switch appends a extension number to the file name when it creates a new file. After every 500 events, the switch deletes the oldest backup file if the file limit specified by the event-monitor backup max-size command is exceeded.
running-config can contain a maximum of one event-monitor backup path statement. Subsequent event-monitor backup path commands replace the existing statement in running-config, changing the name of the file where event monitor backup files are stored.
The no event-monitor backup path and default event-monitor backup path commands disable the storage of the event monitor buffer to switch files by deleting the event-monitor backup path command from running-config.
Command Mode
Global Configuration
Command Syntax
event-monitor backup path URL_FILE
no event-monitor backup path
default event-monitor backup path
Parameters
Example
switch(config)# event-monitor backup path eventmon_backup_dir/event.log
switch(config)#
bash-4.3# ls /mnt/flash/eventmon_backup_dir/
arpevent.log.1 lacpevent.log.1 neighborevent.log.1 routeevent.log.1
igmpsnoopingevent.log.1 macevent.log.1 route6event.log.1
stpunstableevent.log.1The event-monitor buffer max-size command specifies the size of the event monitor buffer. The event monitor buffer is a fixed-size circular data structure that receives event records from the event monitor. When event monitor backup is enabled (event-monitor backup path), the buffer is copied to a backup file before each rollover.
Buffer size ranges from 6 Kb to 50 Kb. The default size is 32 Kb.
The no event-monitor buffer max-size and default event-monitor buffer max-size commands restore the default buffer size of 32 Kb by removing the event-monitor buffer max-size command from running-config.
Command Mode
Global Configuration
Command Syntax
event-monitor buffer max-size buffer_size
no event-monitor buffer max-size
default event-monitor buffer max-size
Parameters
buffer_size buffer capacity (Kb). Values range from 6 to 50. Default value is 32.
Example
switch(config)# event-monitor buffer max-size 48
switch(config)#The event-monitor clear command removes the contents of the event monitor buffer. If event monitor backup is enabled, this command removes the contents from all event monitor backup files.
Command Mode
Privileged EXEC
Command Syntax
event-monitor clear
Example
switch# event-monitor clear
switch#The event-monitor buffer sync command combines the event monitor buffer and all backup logs and synchronizes them into a single SQLite file, which is stored at /var/log/eventMon.db.
Command Mode
Privileged EXEC
Command Syntax
event-monitor sync
Example
switch(config)# event-monitor sync
switch(config)#The event-monitor command enables the event monitor and specifies the types of events that are logged. The event monitor is an event logging service that records system events to a local database.
The database maintains a separate table for each event type.
The no event-monitor and default event-monitor commands, without a LOG_TYPE parameter, restore the default event monitor settings by deleting all event monitor related commands from running-config.
Command Mode
Global Configuration
Command Syntax
event-monitor LOG_TYPE
no event-monitor LOG_TYPE
default event-monitor LOG_TYPE
Parameters
Related Command
switch(config)# no event-monitor all
switch(config)#switch(config)# event-monitor route
switch(config)#The hostname command assigns a text string as the switch's host name. The default host name is localhost.
The prompt displays the host name when appropriately configured through the prompt command.
The no hostname and default hostname commands return the switch's host name to the default value of localhost.
Command Mode
Global Configuration
Command Syntax
hostname string
no hostname
default hostname
Parameter
string host name assigned to the switch.
Example
switch(config)# hostname main-host
main-host(config)#The prompt was previously configured to display the host name.
The ip domain lookup command specifies the source interface for all DNS requests sent from the specified VRF.
The no ip domain lookup and default ip domain lookup commands return the switch to its default state, in which the switch selects source IP addresses for each DNS request from the specified VRF.
Command Mode
Global Configuration
Command Syntax
ip domain lookup [VRF_INSTANCE] source-interface INTF_NAME
no ip domain lookup [VRF_INSTANCE] source-interface
default ip domain lookup [VRF_INSTANCE] source-interface
switch(config)# ip domain lookup source-interface Vlan5
switch(config)#switch(config)# ip domain lookup vrf purple source-interface Vlan10
switch(config)#The ip domain-list command specifies a domain name to add to the IP domain list.
The no ip domain-list and default ip domain-list commands return the IP domain list to its default state, in which the switch selects source IP addresses for each DNS request from the specified VRF.
Command Mode
Global Configuration
Command Syntax
ip domain-list [IP_DOMAIN_NAME]
no ip domain-list [IP_DOMAIN_NAME]
default ip domain-list [IP_DOMAIN_NAME]
Parameter
IP_DOMAIN_NAME specifies the IP domain name.
switch(config)# ip domain-list foo.com
switch(config)#switch(config)# no ip domain-list foo.com
switch(config)#The ip host command associates a hostname to an IPv4 address. This command supports local hostname resolution based on local hostname IP address maps. Multiple hostnames can be mapped to an IP address. IPv4 and IPv6 addresses can be mapped to the same hostname. To map an IPv6 address to a hostname, use the ipv6 host command. The show hosts command displays the local hostname IP address mappings.
Command Mode
Global Configuration
Command Syntax
ip host hostname hostadd_1 [hostadd_2] ...[hostadd_X]
no ip host [hostname] [hostadd_1 [hostadd_2] [hostadd_X]
default ip host [hostname] [hostadd_1 [hostadd_2] [hostadd_X]
switch(config)#ip host MyTestLab 10.24.18.5 10.24.16.3switch(config)#no ip host production_lab
switch(config)#The ip name-server command adds name server addresses to running_config. The switch uses name servers for name and address resolution. The switch can be configured with up to three name servers. Although a command can specify multiple name server addresses, running_config stores each address in a separate statement. Name server addresses can be IPv4 and IPv6; each command can specify both address types.
Attempts to add a fourth server generate an error message. All name server addresses must be configured in the same VRF. When name servers were previously configured in a VRF, they must all be removed before adding new name server entries.
The no ip name-server and default ip name-server commands remove specified name servers from running_config. Commands that do not list an address remove all name servers.
Command Mode
Global Configuration
Command Syntax
ip name-server [VRF_INSTANCE] [SERVER_1] [SERVER_2] [SERVER_3]
no ip name-server [VRF_INSTANCE] [SERVER_1] [SERVER_2] [SERVER_3]
default ip name-server [VRF_INSTANCE] [SERVER_1] [SERVER_2] [SERVER_3]
A command can contain both (IPv4 and IPv6) address types.
Guidelines
All configured name server addresses must come from the same VRF. To use a user defined VRF for connection to a name server, first remove any name servers configured in the default VRF.
switch(config)# ip name-server 172.0.14.21 3:4F21:1902::
switch(config)#switch(config)# ip name-server 172.1.10.22
% Maximum number of nameservers reached. '172.1.10.22' not added
switch(config)#The ipv6 host command associates a hostname to an IPv6 address. This command supports local hostname resolution based on local hostname IP address maps. Multiple hostnames can be mapped to an IPv6 address. IPv4 and IPv6 addresses can be mapped to the same hostname. To map IPv4 addresses to a hostname, use the ip host command. The show hosts command displays the local hostname IP address mappings.
Command Mode
Global Configuration
Command Syntax
ipv6 host hostname hostadd1 [hostadd2] ...[hostaddX]
no ipv6 host [hostname] [hostadd1 [hostadd2] [hostaddX]
default ipv6 host [hostname] [hostadd1 [hostadd2] [hostaddX]
Example
switch(config)#ipv6 host MySupportLab 2001:0DB8:73:ff:ff:26:fd:90
switch(config)#The logging format command configures formatting options for syslog messages.
The no logging format and default logging format commands remove the corresponding logging format command from running-config and restore the specified formatting to its default setting.
Command Mode
Global Configuration
Command Syntax
logging format {hostname{fqdn|ipv4}|rfc5424|sequence-numbers|timestamp{high-resolution|traditional[timezone][year]}}
no logging format {hostname|rfc5424|sequence-numbers|timestamp}
default logging format {hostname|rfc5424|sequence-numbers|timestamp}
Parameters
hostname {fqdn\ipv4} specifies the formatting for the hostname in syslog messages as either fqdn (fully qualified domain name) or ipvr (IPv4 address).
rfc5424 causes syslogs generated locally to include high-resolution timestamps, and syslogs forwarded to remote servers to be sent in RFC5424 format.
sequence-numbers causes the sequence numbers of syslog messages to be visible when the messages are displayed.
timestamp {high-resolution|traditional[timezone][year]} specifies the formatting for syslog timestamps as either high-resolution (high-resolution RFC3339 timestamps) or traditional (traditional syslog timestamps as specified in RFC3164).When using the traditional timestamp format, timezone and year can also be included.
switch(config)# logging format sequence-numbers
switch(config)#switch# show logging
Syslog logging: enabled
Buffer logging: level debugging
Console logging: level informational
Synchronous logging: disabled
Trap logging: level informational
Sequence numbers: enabled
Syslog facility: local4
Hostname format: Hostname only
Repeat logging interval: disabled
Log Buffer:
Nov 12 14:03:34 switch1 SuperServer: 1: %SYS-7-CLI_SCHEDULER_LOG_STORED: Logfile for scheduled CLI execution job 'tech-support' is stored in
flash:/schedule/tech-support/tech-support_2012-11-12.1402.log.gz
Nov 12 14:06:52 switch1 Cli: 2: %SYS-5-CONFIG_I: Configured from console by admin on con0 (0.0.0.0)
Nov 12 14:07:26 switch1 Cli: 3: %SYS-5-CONFIG_E: Enter configuration mode from console by admin on con0 (0.0.0.0)
Nov 12 14:14:29 switch1 Cli: 4: %SYS-5-CONFIG_I: Configured from console by admin on con0 (0.0.0.0)
Nov 12 14:15:55 switch1 Cli: 5: %SYS-5-CONFIG_E: Enter configuration mode from console by admin on con0 (0.0.0.0)
Nov 12 14:33:05 switch1 Cli: 6: %SYS-5-CONFIG_I: Configured from console by admin on con0 (0.0.0.0)
Nov 12 14:45:13 switch1 Cli: 7: %SYS-5-CONFIG_E: Enter configuration mode from console by admin on con0 (0.0.0.0)
switch#The logging persistent command logs the files stored on the flash disk. It can store upto 30MB logs.
The no logging persistent command disables the logging from the running-config.
Command Mode
Global Configuration Mode
Command Syntax
logging persistent logging file size
no logging persistent logging file size
switch# config
switch(config)# logging persistent 1024
! Note: writing system log message on non-volatile flash will affect the life
expectancy of the flash drive due to heavy writing. Please disable persistent logging unless needed.The logging repeat-messages command configures repetition of syslog messages instead of summarizing the count of repeats.
The no logging repeat-messages and default logging repeat-messages commands disable the functionality to repeat logging messages in running-config.
Command Mode
Global Configuration
Command Syntax
logging repeat-messages
no logging repeat-messages
default logging repeat-messages
switch(config)# logging repeat-messages
switch(config)#switch(config)# show logging
Syslog logging: enabled
Buffer logging: level debugging
Console logging: level debugging
Monitor logging: level debugging
Synchronous logging: disabled
Trap logging: level informational
Sequence numbers: disabled
Syslog facility: local4
Hostname format: Hostname only
Repeat logging interval: disabled
Repeat messages: enabled
Facility Severity Effective Severity
-------------- ------------- ------------------
aaa debugging debugging
accounting debugging debugging
switch(config)#To disable the event monitor, enter the no event-monitor all command (event-monitor).
Command Mode
Global Configuration
Command Syntax
no event-monitor [PARAMETER]
default event-monitor [PARAMETER]
Parameters
Example
switch(config)# no event-monitor
switch(config)#The ntp authenticate command enables the authentication of incoming NTP packets. When authentication is enabled, NTP packets will be used to synchronize time on the switch only if they include a trusted authentication key. Authentication keys are created on the switch using the ntp authentication-key command, and the ntp trusted-key command is used to specify which keys are trusted. NTP authentication is disabled by default.
The no ntp authenticate and default ntp authenticate commands disable NTP authentication on the switch by removing the corresponding ntp authenticate command from running-config.
Command Mode
Global Configuration
Command Syntax
ntp authenticate
no ntp authenticate
default ntp authenticate
switch(config)# ntp authenticate
switch(config)#switch(config)# no ntp authenticate
switch(config)#The ntp authentication-key command creates an authentication key for use in authenticating incoming NTP packets. For the key to be used in authentication:
The no ntp authentication-key and default ntp authentication-key commands remove the specified authentication key by removing the corresponding ntp authentication-key command from running-config.
Command Mode
Global Configuration
Command Syntax
ntp authentication-keykey_id ENCRYPT_TYPE password_text
no ntp authentication-key key_id
default ntp authentication-key key_id
switch(config)# ntp authentication-key 234 md5 timeSync Running-config stores the password as plain text.
switch(config)# no ntp authentication-key 234The ntp local-interface command configures an interface as the local NTP source. The IP address of that interface will then be used as the source address in NTP packets sent by the switch. If the switch is acting as an NTP server and a server-specific source interface has been configured using the source option of the ntp server command, the server-specific source address will take precedence.
The no ntp local-interface and default ntp local-interface commands remove the ntp local-interface command from running-config.
Command Mode
Global Configuration
Command Syntax
ntp local-interface [VRF_INSTANCE] INT_PORT
no ntp local-interface
default ntp local-interface
switch(config)# ntp local-interface vlan 25
switch(config)#switch(config)# no ntp local-interface
switch(config)#The ntp serve all command configures the switch to act as an NTP server by accepting incoming NTP requests.
Using this command also causes the switch to re-synchronize with its upstream NTP server.
Individual interfaces can be configured separately to accept or deny NTP requests by using the ntp serve command, and these settings override the global setting.
Command Mode
Global Configuration
Command Syntax
ntp serve all
no ntp serve all
default ntp serve all
switch(config)# ntp serve all
switch(config)#switch(config)# no ntp serve all
switch(config)#The ntp serve command configures the command mode interface to accept incoming NTP requests regardless of the global setting.
The no ntp serve command configures the command mode interface to refuse incoming NTP requests regardless of the global setting. The default ntp serve command configures the command mode interface to follow the global setting.
Using this command also causes the switch to re-synchronize with its upstream NTP server.
Command Modes
Interface-Ethernet Configuration
Interface-Loopback Configuration
Interface-Management Configuration
Interface-Port-channel Configuration
Interface-VLAN Configuration
Interface-VXLAN Configuration
Command Syntax
ntp serve
no ntp serve
default ntp serve
switch(config)# interface ethernet 5
switch(config-if-Et5)# ntp serve
switch(config-if-Et5)#switch(config)# interface ethernet 5
switch(config-if-Et5)# no ntp serve
switch(config-if-Et5)#switch(config)# interface ethernet 5
switch(config-if-Et5)#default ntp serve
switch(config-if-Et5)#The ntp server command adds a Network Time Protocol (NTP) server to running-config. If the command specifies a server that already exists in running-config, it will modify the server settings. The switch synchronizes the system clock with an NTP server when running-config contains at least one valid NTP server.
The switch supports NTP versions 1 through 4. The default is version 4.
The prefer option specifies a preferred NTP server, which is used as the NTP server if not discarded by NTP.
The no ntp server and default ntp server commands remove the specified NTP server from running-config. To remove an NTP server configured in a user-defined VRF, include the VRF name in the no ntp server command.
Command Mode
Global Configuration
Command Syntax
ntp server [VRF_INSTANCE] SERVER_NAME [PREFERENCE] [NTP_VERSION] [IP_SOURCE] [burst] [iburst] [AUTH_KEY][MAX_POLL_INT][MIN_POLL_INT]
no ntp server [VRF_INSTANCE] SERVER_NAME
default ntp server [VRF_INSTANCE] SERVER_NAME
All parameters except VRF_INSTANCE and SERVER_NAME can be placed in any order.
Guidelines
To configure multiple parameters for a single server, include them all in a single ntp server command. Using the command again for the same server overwrites parameters previously configured in running-config.
All NTP servers must use the same VRF. If no VRF is specified, the server is configured in the default VRF. To use a user-defined VRF for connection to an NTP server, first use the no ntp server command to remove any NTP servers configured in the default VRF.
When specifying a source interface, choose an interface in the same VRF as the server. If the source interface is not in the same VRF, the source data will be included in running-config but will not be added to NTP packets.
An NTP server may be configured using an invalid or inactive VRF, but the status of the NTP server will remain inactive until the VRF is active.
switch(config)# ntp server 172.16.0.23 preferswitch(config)# ntp server local-nettimeswitch(config)# ntp server 171.18.1.22 version 3switch(config)# no ntp server 172.16.0.23
switch(config)# no ntp server local-nettime
switch(config)# no ntp server 171.18.1.22
switch(config)# ntp server vrf magenta 172.16.0.23 prefer
switch(config)# ntp server vrf magenta local-nettime
switch(config)# ntp server vrf magenta 171.18.1.22 version 3
switch(config)#The ntp trusted-key command specifies which authentication keys will be trusted for authentication of NTP packets. A packet with a trusted key will be used to update the local time if authenticated.
The no ntp trusted-key and default ntp trusted-key commands remove the specified authentication keys from the trusted key list by removing the corresponding ntp trusted-key command from running-config.
Command Mode
Global Configuration
Command Syntax
ntp trusted-key key_list
no ntp trusted-key
default ntp trusted-key
Parameter
key_list specified one or more keys. Formats include a number (1 to 65534), number range, or comma-delimited list of numbers and ranges.
Example
switch(config)# ntp trusted-key 234,237
switch(config)#The power enable module command powers up the specified module. The no power enable module command powers down the specified module.
Command Mode
Global Configuration
Command Syntax
power enable module {fabric|linecard|supervisor|switchcard} module_number
no power enable module {fabric|linecard|supervisor|switchcard} module_number
default power enable module {fabric|linecard|supervisor|switchcard} module_number
Parameters
fabric specifies a fabric card
linecard specifies a linecard
supervisor specifies a supervisor
switchcard specifies a switch card
module_number specifies the number of the module
switch(config)# no power enable module linecard 3
switch(config)#switch(config)# no power enable module fabric 2
switch(config)# power enable module fabric 2
switch(config)#The prompt command specifies the contents of the CLI prompt. Characters allowed in the prompt include A-Z, a-z, 0-9, and these punctuation marks:
! @ # $ % & * ( ) - = + f g [ ] ; : < > , . ? / n
|
Command Mode |
Command Mode Prompt |
Extended Command Mode Prompt |
|---|---|---|
|
Exec |
> |
> |
|
Privileged Exec |
# |
# |
|
Global Configuration |
(config)# |
(config)# |
|
Ethernet Interface Configuration |
(config-if)# |
(config-if-ET15)# |
|
VLAN Interface Configuration |
(config-if)# |
(config-if-Vl24)# |
|
Port Channel Interface Configuration |
(config-if)# |
(config-if-Po4)# |
|
Management Interface Configuration |
(config-if)# |
(config-if-Ma1) |
|
Access List Configuration |
(config-acl)# |
(config-acl-listname)# |
|
OSPF Configuration |
(config-router)# |
(config-router-ospf)# |
|
BGP Configuration |
(config-router)# |
(config-router-bgp)# |
The no prompt and default prompt commands return the prompt to the default of %H%R%P.
Command Mode
Global Configuration
Command Syntax
prompt p_string
no prompt
default prompt
Parameters
p_string prompt text (character string). Elements include letters, numbers, and control sequences.
host-name.dut103(config)# prompt system%s1%P
system 1(config)#host-name.dut103(config)# prompt %p
(config)#% prompt %H%P
host-name.dut103(config)#% no prompt
host-name.dut103(config)#The show banner command displays the specified banner.
Command Mode
Privileged EXEC
Command Syntax
show banner BANNER_TYPE [login | motd]
Parameters
Example
switch(config)# banner motd
Enter TEXT message. Type 'EOF' on its own line to end.
This is an motd banner for $(hostname)
EOF
switch(config)# show banner motd
This is an motd banner for $(hostname)
switch(config)#The show clock command displays the current system clock time and configured time zone. The switch uses the system clock for system log messages and debugging traces.
Command Mode
EXEC
Command Syntax
show clock
Example
switch> show clock
Wed Nov 2 10:29:32 2011
timezone is America/Los_Angeles
switch>The show event-monitor arp command performs an SQL-style query on the event monitor database and displays ARP table events as specified by command parameters. The event monitor buffer and all backup logs are synchronized into a single SQLite file.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor arp [GROUP] [MESSAGES] [INTERFACE] [IP] [MAC] [TIME] [VRF]
Optional parameters can be placed in any order.
Example
switch# show event-monitor arp
% Writing 220017 Arp, 234204 Route, 1732559 Mac events to the database
2012-11-06 12:36:10|10.33.6.159|Vlan1417|0000.00dc.cc0d|0|added|2186271
2012-11-06 12:38:20|10.33.7.150|Vlan1417|0000.00f7.e25f|0|added|2186292
2012-11-06 12:38:34|10.33.6.62|Vlan1417|0000:00:01:c2:ac|0|added|2186295
2012-11-06 12:39:13|10.33.7.162|Vlan1417|00:00:00:45:c2:79|0|added|2186299
2012-11-06 12:39:50|10.33.12.54|Vlan1417|||removed|2186303
2012-11-06 12:39:51|10.33.6.218|Vlan1417|00:00:00:e9:36:46|0|added|2186305
2012-11-06 12:40:00|10.33.6.140|Vlan1417|00:00:00:4a:36:c3|0|added|2186308
2012-11-06 12:40:02|10.33.6.239|Vlan1417|00:00:00:5b:a7:21|0|added|2186312
2012-11-06 12:41:16|10.33.7.11|Vlan1417|00:00:00:3f:94:59|0|added|2186320
2012-11-06 12:41:50|10.33.7.60|Vlan1417|00:00:00:1f:3c:8e|0|added|2186346
2012-11-06 12:43:34|10.33.7.81|Vlan1417|00:00:00:e3:0d:9c|0|added|2186762
2012-11-06 12:43:42|10.33.6.214|Vlan1417|00:00:00:7b:09:7d|0|added|2186765
2012-11-06 12:43:59|10.33.7.149|Vlan1417|00:00:00:8d:a6:d8|0|added|2186768
switch#The show event-monitor igmpsnooping command performs an SQL-style query on the event-monitor database, using the statement specified in the command.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor igmpsnooping [GROUP] [MESSAGES] [MAC] [INTERFACE] [VLAN] [TIME]
switch# show event-monitor igmpsnooping
switch#The show event-monitor mac command performs an SQL-style query on the event monitor database and displays MAC address table events as specified by command parameters. The event monitor buffer and all backup logs are synchronized into a single SQLite file.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor mac [GROUP] [MESSAGES] [INTERFACE] [MAC] [TIME]
Optional parameters can be placed in any order.
switch# show event-monitor mac
% Writing 0 Arp, 0 Route, 1 Mac events to the database
2012-01-19 13:57:55|1|0808.0808.0808|Ethernet1|configuredStaticMac|added|0switch# show event-monitor mac match-mac 08:08:08:%
2012-01-19 13:57:55|1|0808.0808.0808|Ethernet1|configuredStaticMac|added|0The show event-monitor mroute command performs an SQL-style query on the event-monitor database, using the statement specified in the command.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor mroute [GROUP] [MESSAGES] [IP] [INTERFACE] [SRC_IP] [TIME]
Optional parameters can be placed in any order.
Example
switch# show event-monitor mroute
2011-07-28 12:33:28|default|16.17.18.19/32|225.0.0.1/32|||added|30
2011-07-28 12:33:28|default|16.17.18.19/32|225.0.0.1/32|Vlan2|iif|join|31
2011-07-28 12:33:28|default|16.17.18.19/32|225.0.0.1/32|Vlan3|oif|join|32
2011-07-28 12:33:28|default|16.17.18.19/32|225.0.0.1/32|Vlan4|oif|join|33
2011-07-28 12:33:28|default|10.11.12.13/32|225.0.0.2/32|||added|34
2011-07-28 12:33:28|default|10.11.12.13/32|225.0.0.2/32|Vlan3|iif|join|35
2011-07-28 12:33:28|default|10.11.12.13/32|225.0.0.2/32|Vlan2|oif|join|36
2011-07-28 12:33:28|default|16.17.18.19/32|225.0.0.1/32|Vlan4||leave|37
2011-07-28 12:33:28|default|16.17.18.19/32|225.0.0.1/32|||deleted|38
2011-07-28 12:33:28|default|10.11.12.13/32|225.0.0.2/32|||deleted|39The show event-monitor neighbor command performs an SQL-style query on the event monitor database and displays neighbor table events as specified by command parameters. The event monitor buffer and all backup logs are synchronized into a single SQLite file.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor neighbor [GROUP][MESSAGES][INTERFACE][IP6][MAC][TIME][VRF]
Optional parameters can be placed in any order.
Example
switch# show event-monitor neighbor
2019-09-30 14:37:32.894147|def0::1|Vlan1|default|0005.0005.0005|1|added|1
2019-09-30 14:37:32.894395|def0::2|Vlan1|default|0005.0005.0005|1|added|2
2019-09-30 14:37:32.894607|def0::3|Vlan1|default|0005.0005.0005|1|added|3
2019-09-30 14:37:32.894815|def0::4|Vlan1|default|0005.0005.0005|1|added|4
2019-09-30 14:37:32.895071|def0::5|Vlan1|default|0005.0005.0005|1|added|5
2019-09-30 14:37:32.895303|def0::6|Vlan1|default|0005.0005.0005|1|added|6
2019-09-30 14:37:32.895527|def0::7|Vlan1|default|0005.0005.0005|1|added|7
2019-09-30 14:37:32.895732|def0::8|Vlan1|default|0005.0005.0005|1|added|8
2019-09-30 14:37:32.895968|def0::9|Vlan1|default|0005.0005.0005|1|added|9
2019-09-30 14:37:32.896194|def0::a|Vlan1|default|0005.0005.0005|1|added|10The show event-monitor route6 command performs an SQL-style query on the event monitor database and displays routing6 table events as specified by command parameters. The event monitor buffer and all backup logs are synchronized into a single SQLite file.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor route6 [GROUP][MESSAGES][IP6][TIME]
Optional parameters can be placed in any order.
Example
switch# show event-monitor route6
2019-09-30 14:59:30.660447|def1::1:0/128|default|receive|0|1|updated|41
2019-09-30 14:59:30.660720|def1::2:0/128|default|attached|0|1|updated|42
2019-09-30 14:59:30.660983|def1::3:0/128|default|staticConfig|0|1|updated|43
2019-09-30 14:59:30.661226|def1::4:0/128|default|kernel|0|1|updated|44
2019-09-30 14:59:30.661469|def1::5:0/128|default|rip|0|1|updated|45
2019-09-30 14:59:30.661706|def1::6:0/128|default|connected|0|1|updated|46
2019-09-30 14:59:30.661968|def1::7:0/128|default|redirect|0|1|updated|47
2019-09-30 14:59:30.662207|def1::8:0/128|default|bgpAggregate|0|1|updated|48
2019-09-30 14:59:30.662451|def1::9:0/128|default|ospfAggregate|0|1|updated|49
2019-09-30 14:59:30.662694|def1::a:0/128|default|ospf|0|1|updated|50
2019-09-30 14:59:30.662935|def1::b:0/128|default|bgp|0|1|updated|51
2019-09-30 14:59:30.663174|def1::c:0/128|default|unknown|0|1|updated|52
switch#The show event-monitor route command performs an SQL-style query on the event monitor database and displays routing table events as specified by command parameters. The event monitor buffer and all backup logs are synchronized into a single SQLite file.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor route [GROUP][MESSAGES][IP][TIME]
Optional parameters can be placed in any order.
Example
switch# show event-monitor route limit 10
2019-09-30 14:01:21.659428|16.16.16.255/32|default|receiveBcast|0|0|updated|20
2019-09-30 14:01:21.659464|192.168.201.12/30|default|connected|1|0|updated|21
2019-09-30 14:01:21.659497|192.168.1.255/32|default|receiveBcast|0|0|updated|22
2019-09-30 14:01:21.659503|192.168.201.8/32|default|receiveBcast|0|0|updated|23
2019-09-30 14:01:21.659512|16.16.16.0/32|default|receiveBcast|0|0|updated|24
2019-09-30
14:01:21.659517|192.168.201.12/32|default|receiveBcast|0|0|updated|25
2019-09-30
14:01:21.659524|192.168.201.15/32|default|receiveBcast|0|0|updated|26
2019-09-30 14:01:21.659541|192.168.201.8/30|default|connected|1|0|updated|27
2019-09-30 14:01:21.659564|16.16.16.0/24|default|connected|1|0|updated|28
2019-09-30 14:01:21.659578|192.168.201.9/32|default|receive|0|0|updated|29
switch#The show event-monitor sqlite command performs an SQL-style query on the event monitor database, using the statement specified in the command.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor sqlite statement
Parameter
statement SQLite statement.
Example
switch# show event-monitor sqlite select * from route;
2019-09-30 14:01:21.659428|16.16.16.255/32|default|receiveBcast|0|0|updated|20
2019-09-30 14:01:21.659464|192.168.201.12/30|default|connected|1|0|updated|21
2019-09-30 14:01:21.659497|192.168.1.255/32|default|receiveBcast|0|0|updated|22
2019-09-30 14:01:21.659503|192.168.201.8/32|default|receiveBcast|0|0|updated|23
2019-09-30 14:01:21.659512|16.16.16.0/32|default|receiveBcast|0|0|updated|24
2019-09-30
14:01:21.659517|192.168.201.12/32|default|receiveBcast|0|0|updated|25
2019-09-30
14:01:21.659524|192.168.201.15/32|default|receiveBcast|0|0|updated|26
2019-09-30 14:01:21.659541|192.168.201.8/30|default|connected|1|0|updated|27
2019-09-30 14:01:21.659564|16.16.16.0/24|default|connected|1|0|updated|28
2019-09-30 14:01:21.659578|192.168.201.9/32|default|receive|0|0|updated|29
switch#The show event-monitor stpunstable command performs an SQL-style query on the event-monitor database, using the statement specified in the command.
Command Mode
Privileged EXEC
Command Syntax
show event-monitor stpunstable [MESSAGES][TIME]
Optional parameters can be placed in any order.
switch# show event-monitor stpunstable limit 5
2019-02-07 07:22:10.286164|Cist|Ethernet5|forward-delay-while|1
2019-02-07 07:22:10.286651|Cist|Ethernet6|forward-delay-while|2
2019-02-07 07:22:10.286844|Cist|Ethernet8|forward-delay-while|3
2019-02-07 07:22:10.287030|Cist|Ethernet14|forward-delay-while|4
2019-02-07 07:22:10.287215|Cist|Ethernet21|forward-delay-while|5
switch#The show hostname command displays the hostname and the Fully Qualified Domain Name (FQDN) of the switch.
Command Mode
EXEC
Command Syntax
show hostname
Example
switch> show hostname
Hostname: switch_1
FQDN: switch_1.aristanetworks.com
switch>The show hosts command displays the default domain name, name lookup service style, a list of name server hosts, and the static hostname-IP address maps.
Command Mode
EXEC
Command Syntax
show hosts
Example
switch> show hosts
Default domain is: aristanetworks.com
Name/address lookup uses domain service
Name servers are: 172.22.22.40, 172.22.22.10
Static Mappings:
Hostname IP Addresses
TEST_LAB IPV4 10.24.18.6
PRODUCTION_LAB IPV4 10.24.18.7
SUPPORT_LAB IPV6 2001:0DB8:73:ff:ff:26:fd:90
switch>The show ip domain-name command displays the switchs IP domain name that is configured with the ip domain name command.
Command Mode
EXEC
Command Syntax
show ip domain-name
Example
switch> show ip domain-name
aristanetworks.com
switch>The show ip name-server command displays the ip addresses of name-servers in running-config. The name servers are configured by the ip name-server command.
Command Mode
EXEC
Command Syntax
show ip name-server
Example
switch> show ip name-server
172.22.22.10
172.22.22.40
switch>The show local-clock time-properties command displays the Precision Time Protocol (PTP) clock properties.
Command Mode
Privileged EXEC
Command Syntax
show local-clock time-properties
Example
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#The show ntp associations command displays the status of connections to NTP servers.
Command Mode
EXEC
Command Syntax
show ntp associations
Example
switch> show ntp associations
remote refid st t when poll reach delay offset jitter
==============================================================================
+l.ntp.arista.co 125.157.10.11 2 u 539 1024 377 121.748 -0.345 0.893
-3.ntp.arista.co 127.31.152.34 2 u 868 1024 377 101.671 2.434 1.529
+2.ntp.arista.co 176.131.12.185 2 u 676 1024 377 116.505 0.03 0.768
*4.ntp.arista.co 120.181.192.192 2 u 696 1024 377 48.431 -0.416 0.15
switch#The show ntp status command displays the status of NTP on the switch. If the switch clock is not synchronized to an NTP server, the status reads “unsynchronised” and shows the server polling interval. If the clock is synchronized to an NTP server, the status shows the IP address and stratum of the server, the precision of the synchronization, and the polling interval.
Command Mode
EXEC
Command Syntax
show ntp status
Example
switch> show ntp status
synchronised to NTP server (192.168.78.62) at stratum 3
time correct to within 66 ms
polling server every 1024 s
switch>This section describes the purpose, behavior, and configuration of the 7130 platform and includes the following topics:
The Arista 7130 Series provides a comprehensive set of platforms to service ultra-low latency networking, in-network applications, and composable custom packet processing. The product family contains a broad selection of powerful hardware, FPGA-based network applications and developer toolkits.
The series contains the following features:This chapter provides information about configuring a 7130 Layer 1 interface to connect on your network.
Switch interfaces can be used instead of the application interfaces for creating connections between app interfaces and front panel ports. Configure Layer 1 traffic between front panel ports, application FPGA ports, and switch interfaces using the l1 source command.
Adding this connection does not affect previously configured destinations.
On DCS-7130 series switches, change the default connections dynamically by using the l1 source CLI command using the switch interfaces as a source or destination. Connect bidirectional network traffic on a Switch1/26 and an Ethernet 36 interface when using a Layer 2 full profile.
Example
switch(config)# l1 connect Switch1/26 Ethernet36switch(config)# interface ethernet1
switch(config-if-Et1)# l1 source interface et2MetaMux is an FPGA-based feature available on Arista 7130 platforms. It performs ultra-low latency Ethernet packet multiplexing with or without packet contention queuing. The port to port latency functions as the selected MetaMux profile, using the front panel ingress port, the front panel egress port, the FPGA connector ingress port, and the platform.
Use the l1 source and l1 connect commands to connect the MuxIn and MuxOut ports to Ethernet ports. In this example, the commands connect the first two Mux1 inputs, MuxIn2/1/1 and MuxIn2/1/2 of the MetaMux instance 2 to the ingress ports of Ethernet 17 and 20 and the Mux1 output, MuxOut2/1 of the same instance to the egress port of Ethernet 22.
Example
switch(config)# interface MuxIn 2/1/1
switch(config-if-MuI2/1/1)# l1 source interface Eth5
switch(config-if-MuI2/1/1)# interface MuxIn 2/1/2
switch(config-if-MuI2/1/2)# l1 source interface Eth6
switch(config-if-MuI2/1/2)# interface eth11
switch(config-if-Et22)# l1 source interface muxout 2/1switch# show l1 path int et17,20,22
Source Destination Type
----------------------- ------------------------ -------
Ethernet17 MuxIn2/1/1 (Ap2/1) dynamic
Ethernet20 MuxIn2/1/2 (Ap2/2) dynamic
MuxOut2/1 (Ap2/4) Ethernet22 dynamic
switch# show l1 matrix int et5,6,11
Ethernet MuxIn
5 6 11 2/1/1* 2/1/2*
Et5 -> -|-|-|------+ |
Et6 -> -|-|-|-------------+
MuO2/1* -> -|-|-+
MAC -> -+-+
* indicates interface is a function interface
For more information about MetaMux interfaces, see Software Downloads for the 7130 platform.
7130 platforms provide support for MultiAccess, an FPGA-based feature. It performs low-latency Ethernet multiplexing with optional packet contention queuing, storm control, VLAN tunneling, and packet access control. The interface to interface latency provides functionality for the selected MultiAccess profile, front panel interfaces, MultiAccess interfaces, configuration settings, and platform used. The MultiAccess feature uses the Downstream and Upstream interfaces to connect to Ethernet interfaces.
Example
To configure Multiaccess Layer 1 topology, use the following commands. In this case, you have an active Multiaccess instance with an ID of 2 to bidirectionally connect the two Downstream interfaces from Group 2 to Ethernet interfaces, 17 and 20.
switch(config)# interface Ethernet17
switch(config-if-Et17)# l1 source interface Downstream2/1/1
switch(config-if-Et17)# interface Downstream2/1/1
switch1(config-if-Dn2/1/1)# l1 source interface Ethernet17
switch(config-if-Dn2/1/1)#
switch(config)# interface Ethernet20
switch(config-if-Et20)# l1 source interface Downstream2/1/2
switch(config-if-Et20)# interface Downstream2/1/2
switch(config-if-Dn2/1/2)# l1 source interface Ethernet20
switch(config-if-Dn2/1/2)#Next, add the Upstream interface, Upstream2/1, to the configuration:
oml201(config)# interface Ethernet25
switch(config-if-Et25)# l1 source interface Upstream2/1
switch(config-if-Et25)# interface Upstream2/1
switch(config-if-Up2/1)# l1 source interface Ethernet25
switch(config-if-Up2/1)#switch# show l1 path interface Ethernet17,20,25
Source Destination Type
----------------------------- ----------------------------- -------
Ethernet17 Downstream2/1/1 (Ap1/5) dynamic
Ethernet20 Downstream2/1/2 (Ap1/6) dynamic
Ethernet25 Upstream2/1 (Ap1/12) dynamic
Downstream2/1/1 (Ap1/5) Ethernet17 dynamic
Downstream2/1/2 (Ap1/6) Ethernet20 dynamic
Upstream2/1 (Ap1/12) Ethernet25 dynamic
switch# show l1 matrix interface Ethernet17,20,25
Ethernet Downstream Upstream
17 20 25 2/1/1* 2/1/2* 2/1*
Et17 -> -|--|--|----+ | |
Et20 -> -|--|--|-----------+ |
Et25 -> -|--|--|--------------------+
Dn2/1/1* -> -+ | |
Dn2/1/2* -> ----+ |
Up2/1* -> ---------+
* indicates interface is a function interfaceFor more information about MultiAccess interfaces, see Software Downloads for the 7130 platform.
(config)#int sw1/1/1
(config-if-sw1/1/1)#speed 10g
(config-if-sw1/1/1)#int et1/1
(config-if-et1/1)#speed 1g
(config-if-et1/1)#l1 source int sw1/1/1
Interface Source Interface Type
------------------ ---------------------- -------
Ethernet1/1 dynamicL1SOURCE-6-SPEED_MISMATCH: Speed mismatch found between Layer1 source Switch1/1/1 and destination Ethernet1/1, configuration has not been applied.If you attempt to configure an unsupported interface, such as a static interface, as a source, the show logging output displays the following log message:
L1SOURCE-6-UNSUPPORTED: The configured Layer1 source for interface name is unsupported.When you resolve the misconfiguration, the show logging output displays the following log message:
L1SOURCE-6-OK: Layer1 sourcing has been successfully applied between source source interface and destination destination interface>.Source the lanes individually if an interface configuration has a multi-lane speed, such as 40Gbps. Display the individual lanes using the service interface inactive expose command while in the configure mode. Configure the individual lanes with a corresponding interface name. To learn more about configuring port speeds, see speed.
See the example for an Ethernet interface connecting to a switch interface at 40Gbps.
The following commands expose the individual lanes on interface sw1 and set the sources and speed.
(config)# service interface inactive expose
(config)# int sw1/1/1
(config-if-sw1/1/1)# speed 40g
(config-if-sw1/1/1)# int et1/1
(config-if-et1/1)# speed 40g
(config-if-et1/1)# l1 source int sw1/1/1
(config-if-et1/1)# int et1/2
(config-if-et1/2)# l1 source int sw1/1/2
(config-if-et1/2)# int et1/3
(config-if-et1/3)# l1 source int sw1/1/3
(config-if-et1/3)# int et1/4
(config-if-et1/4)# l1 source int sw1/1/4
(config-if-et1/4)# show l1 source int et1/1-4
Interface Source Interface Type
------------------ ---------------------- -------
Ethernet1/1 Switch1/1/1 dynamic
Ethernet1/2 Switch1/1/2 dynamic
Ethernet1/3 Switch1/1/3 dynamic
Ethernet1/4 Switch1/1/4 dynamicIf the interfaces have matching speeds and the configuration applies to the interface, confirm the configuration by running the show l1 source command on the destination interface.
(config-if-et1/1)# l1 source int sw1/1/1
(config-if-et1/1)#show l1 source int et1/1
Interface Source Interface Type
------------------ ---------------------- -------
Ethernet1/1 Switch1/1/1 dynamicIf a speed mismatch occurs, the show l1 source output does not display mapping for the mismatched interface. To display the speed of the source before the mismatch occurs, use the show active command and check the output. View the mismatched speeds by running the show interface status command for each interface.
(config-if-et1/1)# l1 source int sw1/1/1
(config-if-et1/1)# show l1 source int et1/1
Interface Source Interface Type
------------------ ---------------------- -------
Ethernet1/1 dynamic
(config-if-et1/1)# show active
interface Ethernet1
l1 source interface Switch1/1/1(config-if-et1/1)# show interface et1/1 status
Port Name Status Vlan Duplex Speed Type Flags Encapsulation
----- ------ --------- ----------- ------------ ----- ----------- --------------------
Et1 signal Not Bridged full 10G 10GBASE-CR
(config-if-et1/1)# show interface sw1/1/1 status
Port Name Status Vlan Duplex Speed Type Flags Encapsulation
-------- ------- ------------- ------ ------------ ------ ------ --------------------
Sw1/1/1 notconnect 1 full 1G N/ASome configurations may appear even if a speed mismatch occurs on the interfaces. You may see the configurations when reviewing the static interface mappings. You cannot change the static mappings using the CLI and the l1 source command or change the speed. Compare this to dynamic mappings, which can be configured and updated based on speed changes.
The example output displays the static mappings between the switch and application interfaces on a DCS-7130LBR series device:
#show l1 source interface sw1/25/1-8
Interface Source Interface Type
------------------ ---------------------- ------
Switch1/25/1 Application1/25 static
Switch1/25/2 Application1/26 static
Switch1/25/3 Application1/27 static
Switch1/25/4 Application1/28 static
Switch1/25/5 Application1/57 static
Switch1/25/6 Application1/58 static
Switch1/25/7 Application1/59 static
Switch1/25/8 Application1/60 staticThe following information should be considered when using the L1 source suite of commands:
For more information, refer to https://www.arista.com/en/support/toi/eos-4-27-1f/14877-switchapp-ultra-low-latency-packet-switch.
The l1 source command configures the source for patching Layer 1 traffic between various front panel interfaces and Switch Application (SwitchApp) ports in the Ethernet Interface configuration mode.
The no l1 source and default l1 source commands remove the source configurations and return to the default platform configurations.
Command Mode
Interface-Ethernet Configuration
Command Syntax
l1 source {interface | mac | none}
Parameters
Examples
switch(config)# interface ethernet1
switch(config-if-Et1)# l1 source interface et2
switch(config-if-Et1)#switch(config)# interface ethernet1
switch(config-if-Et1)# l1 source none(config)# int sw1/1/1
(config-if-sw1/1/1)# speed 10g
(config-if-sw1/1/1)# int et1/1
(config-if-et1/1)# speed 1g
(config-if-et1/1)# l1 source int sw1/1/1
(config-if-et1/1)# show l1 source int et1/1
Interface Source Interface Type
------------------ ---------------------- -------
Ethernet1/1 dynamicThe show l1 destination command displays the list of all destinations for all interfaces.
Command Mode
Privileged EXEC
Command Syntax
show l1 destination [interface]
Parameters
switch> show l1 destination
Interface Destination Interface(s) Type
------------------ ------------------------ ------
Ethernet1 App1/1, Sw1 dynamic
Ethernet2 Ethernet3, Ethernet4 dynamic
Ethernet3
Ethernet4
Ethernet5
App1/1 Ethernet1 dynamic
App1/2 Sw17 static
Sw1
Sw2
Sw3
Sw4
Sw5
Sw17 App1/2 static
Cpu1
Cpu2switch# show l1 destination interface et1
Interface Destination Interfaces Type
--------------------- ------------------------ ------
Ethernet1 App1/1, Sw1 dynamicThe show l1 matrix command displays the matrix representation of Layer 1 paths for available interfaces in the privileged EXEC mode.
Command Mode
Privileged EXEC
Command Syntax
show l1 matrix [all | interface | detail | physical]
switch> show l1 matrix
Ethernet Switch App
1 3 4 1 17 1/1 1/2
| | | | | | |
Et1 -> -|-|-|------+-|--------+ |
Et2 -> -|-+-+ | |
Sw17 -> -|------------|------------+
App1/1 -> -+ |
App1/2 -> --------------+switch> show l1 matrix all
Ethernet Switch
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 1 2 3 4 5 6 7 8 9 10
| | | |
Et1 -> -|---|-|----------------------------------+
Et2 -> -|---+-+
Et3 -> |
Et4 -> |
Et5 -> |
Et6 -> |
Et7 -> |
Et8 -> |
Et9 -> |
Et10 -> |
Et11 -> |
Et12 -> |
Et13 -> |
Et14 -> |
Et15 -> |
Et16 -> |
Sw1 -> |
Sw2 -> |
Sw3 -> |
Sw4 -> |
Sw5 -> |
Sw6 -> |
Sw7 -> |
Sw8 -> |
Sw9 -> |
Sw10 -> |
Sw11 -> |
Sw12 -> |
Sw13 -> |
Sw14 -> |
Sw15 -> |
Sw16 -> |
Sw17 -> |
App1/1 -> -+
App1/2 ->
Cpu1 ->
Cpu2 ->
Switch App Cpu
11 12 13 14 15 16 17 1/1 1/2 1 2
| | |
Et1 -> -------------------|----+ |
Et2 -> | |
Et3 -> | |
Et4 -> | |
Et5 -> | |
Et6 -> | |
Et7 -> | |
Et8 -> | |
Et9 -> | |
Et10 -> | |
Et11 -> | |
Et12 -> | |
Et13 -> | |
Et14 -> | |
Et15 -> | |
Et16 -> | |
Sw1 -> | |
Sw2 -> | |
Sw3 -> | |
Sw4 -> | |
Sw5 -> | |
Sw6 -> | |
Sw7 -> | |
Sw8 -> | |
Sw9 -> | |
Sw10 -> | |
Sw11 -> | |
Sw12 -> | |
Sw13 -> | |
Sw14 -> | |
Sw15 -> | |
Sw16 -> | |
Sw17 -> -------------------|--------+
App1/1 -> |
App1/2 -> -------------------+
Cpu1 ->
Cpu2 ->
switch> show l1 matrix interface et1, et4
Ethernet Switch App
1 4 1 1/1
| | | |
Et1 -> -|-|--------+--------+
Et2 -> -|-+
App1/1 -> -+The show l1 path command displays the source and destination paths for all interfaces in the system.
Command Mode
Privileged EXEC
Command Syntax
show l1 path [interface]
switch# show l1 path
Source Destination Type
------------------ -------------------- -------
Ethernet1 App1/1 dynamic
Ethernet1 Sw1 dynamic
Ethernet2 Ethernet3 dynamic
Ethernet2 Ethernet4 dynamic
App1/1 Ethernet1 dynamic
App1/2 Sw17 static
Sw17 App1/2 staticswitch# show l1 path interface et1, et4
Source Destination Type
--------------------- ---------------------- -------
Ethernet1 App1/1 dynamic
Ethernet1 Sw1 dynamic
Ethernet2 Ethernet4 dynamic
App1/1 Ethernet1 dynamicThe show l1 source command displays the list of all source interfaces to connect for specific interfaces such as Ethernet ports, switch, FPGA ports, or CPU ports.
Command Mode
Privileged EXEC
Command Syntax
show l1 source [interface | capabilities]
Parameters
Examples
switch# show l1 source
Interface Source Interface Type
--------------------- ---------------------- -------
Ethernet1 App1/1 dynamic
Ethernet2
Ethernet3 Ethernet2 dynamic
Ethernet4 Ethernet2 dynamic
Ethernet5 MAC dynamic
App1/1 Ethernet1 dynamic
App1/2 Sw17 static
Sw1 Ethernet1 dynamic
Sw2
Sw3
Sw4
Sw5
Sw17 App1/2 static
Cpu1
Cpu2switch# show l1 source interface et1
Interface Source Interface Type
--------------------- ------------------- -------
Ethernet1 App1/1 dynamicThe show l1 source capabilities command displays the list of all interfaces available to connect in the crosspoint and the possible source ports.
Command Mode
Privileged EXEC
Command Syntax
show l1 source capabilities
Examples
switch# show l1 source capabilities
Interface Possible Source Interface(s)
--------------------- ---------------------------------
Ethernet1 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Ethernet2 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Ethernet3 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Ethernet4 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Ethernet5 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Application1/1 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Application1/2 Sw17
Switch1 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Switch2 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Switch3 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Switch4 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Switch5 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Switch17 Ap1/2
Cpu1 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Cpu2 Ap1/1,Cpu1-2,Et1-16,Sw1-16switch# show l1 source interface et1 capabilities
Interface Possible Source Interface(s)
--------------------- --------------------------------
Ethernet1 Ap1/1,Cpu1-2,Et1-16,Sw1-16 switch# show l1 source fpga capabilities
Interface Possible Source Interface(s)
--------------------- ------------------------------
Application1/1 Ap1/1,Cpu1-2,Et1-16,Sw1-16
Application1/2 Sw17