Switch Administration commands
Switch Name configuration commands
Banner configuration commands
Prompt configuration Command
Event Manager commands
- event-monitor
- event-monitor backup max-size
- event-monitor backup path
- event-monitor buffer max-size
- event-monitor clear
- event-monitor interact
- event-monitor sync
- no event-monitor
- show event-monitor arp
- show event-monitor igmpsnooping
- show event-monitor mac
- show event-monitor mroute
- show event-monitor neighbor
- show event-monitor route6
- show event-monitor route
- show event-monitor sqlite
- show event-monitor stpunstable
Email configuration Command
System Clock commands
NTP commands
Syslog configuration commands
banner login
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
Parameters
- banner_text To configure the banner, enter a message
when prompted. The message may span multiple lines. Banner text supports the
following keywords:
- $(hostname) displays the switchs host name.
- EOF To end the banner editing session, type EOF on its own line and press enter.
Examples
- These commands create a two-line login
banner.
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 output displays the login banner.
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>
banner motd
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
Parameters
- banner_text To configure the banner, enter a message
when prompted. The message may span multiple lines. Banner text supports this
keyword:
- $(hostname) displays the switchs host name.
- EOF To end the banner editing session, type EOF on its own line and press enter.
Examples
- These commands create an motd
banner.
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)#
This output displays the motd banner.
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>
clear ptp interface counters
The clear ptp interface counterscommand resets the Precision Time Protocol (PTP) packet counters.
Command Mode
Privileged EXEC
Command Syntax
clear ptp interface [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 parameter formats include number, number range, or comma-delimited list of numbers and ranges.
Example
- This command clears all PTP
counters.
switch#clear ptp counters switch#
clock set
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
Parameters
- hh:mm:ss is the current time (24-hour notation).
- date is the current date. Date formats include:
mm/dd/yy example: 05/15/2012
Monthdayyear example: May 15 2012
daymonthyear example: 15 May 2012
Example
- This command manually sets the switch
time.
switch#clock set 08:15:24 14 Jan 2013 Mon Jan 14 08:15:25 2013 timezone is US/Central
clock timezone
The 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.
Examples
- This command configures the switch for the United States Central
Time Zone.
switch(config)#clock timezone US/Central switch(config)#show clock Fri Jan 11 18:42:49 2013 timezone is US/Central switch(config)#
- To view the predefined time zone labels, enter clock
timezone with a question
mark.
switch(config)#clock timezone ? Africa/AbidjanAfrica/Accra Africa/Addis_AbabaAfrica/Algiers Africa/Asmara Africa/Asmera Africa/Bamako Africa/Bangui W-SUW-SU timezone WET WET timezone ZuluZulu timezone switch(config)#clock timezone
- This command displays all time zone labels that start with
America.
switch(config)#clock timezone AMERICA? America/AdakAmerica/Anchorage America/AnguillaAmerica/Antigua America/Araguaina America/Argentina/Buenos_Aires America/VirginAmerica/Whitehorse America/WinnipegAmerica/Yakutat America/Yellowknife switch(config)#clock timezone AMERICA
dns domain
The 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
Parameters
- string domain name (text string)
Example
- This command configures aristanetworks.com as the switchs
domain
name.
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
- This command places the switch in email client configuration
mode.
switch(config)#email switch(config)#
event-monitor backup max-size
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
Parameters
- file_quantitymaximum number of backup files. Value ranges from 1 to 200. Default is 10.
Examples
- These commands configure the switch to back up the event buffer
to a series of files named sw-event.log. The switch can store a maximum of four
files.
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.
event-monitor backup path
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
- URL_FILE path and file name of the backup
file
- path_string specified path is appended to /mnt/flash/
- file: path_string specified path is appended to /
- flash: path_string specified path is appended to /mnt/flash/
switch(config)#event-monitor backup path eventmon_backup_dir/event.log
switch(config)#
bash-4.3# ls /mnt/flash/eventmon_backup_dir/
arpevent.log.1lacpevent.log.1neighborevent.log.1routeevent.log.1
igmpsnoopingevent.log.1macevent.log.1 route6event.log.1
stpunstableevent.log.1
event-monitor buffer max-size
The 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
- This command configures a buffer size of 48
Kb.
switch(config)#event-monitor buffer max-size 48 switch(config)#
event-monitor clear
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
- This command clears the contents of the event monitor
buffer.
switch#event-monitor clear switch#
event-monitor interact
The event-monitor interact command replaces the CLI prompt with an SQLite prompt. The event monitor buffer and all backup logs are synchronized into a single SQLite file and loaded for access from the prompt.
- To access help from the SQLite prompt, enter .help
- To exit SQLite and return to the CLI prompt, enter .quit or .exit
Command Mode
Privileged EXEC
Command Syntax
event-monitor interact
Examples
- This command replaces the eos CLI prompt with an SQLite
prompt.
switch#event-monitor interact sqlite>
- This command exits SQLite and returns to the eos CLI
prompt.
sqlite> .quit switch#
event-monitor sync
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
- This command synchronizes the buffer and backup logs into a single SQLite
file.
switch(config)#event-monitor sync switch(config)#
event-monitor
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.
Beginning with release eos-4.20.5F, event-monitor is not enabled by default. Use the event-monitor command to explicitly enable event-monitor.
- The no event-monitor all command disables the event monitor.
- The no event-monitor command, followed by a log type parameter, disables event recording for the specified type.
- The event-monitor and default event-monitor commands enable the specified event logging type by removing the corresponding no event-monitor command from running-config.
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
- LOG_TYPE specifies the
event logging type. Options include:
- all all event logging types.
- arp changes to ARP table.
- backup backed up log files.
- buffer changes to the local buffer settings.
- igmpsnooping changes to IGMP snooping table.
- lacp changes to the LACP table events.
- mac changes to MAC address table.
- mroute changes to multicast routing table.
- neighbor changes to the neighbor routing table.
- route changes to IP routing table.
- route6 changes to IP route6 table.
- stpunstable events that cause STP instability.
Related commands
Examples
- This command disables the event monitor for all types of
events.
switch(config)#no event-monitor all switch(config)#
- This command enables the event monitor for routing table
changes.
switch(config)#event-monitor route switch(config)#
hostname
The hostname command assigns a text string as the switchs 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 switchs host name to the default value of localhost.
Command Mode
Global configuration
Command Syntax
hostname string
no hostname
default hostname
Parameters
- string host name assigned to the switch.
Example
- This command assigns the string main-host as the switchs
host
name.
switch(config)#hostname main-host main-host(config)#
The prompt was previously configured to display the host name.
ip domain lookup
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
Parameters
- VRF_INSTANCE specifies the
VRF instance being modified.
- <no parameter> changes are made to the default VRF.
- vrf vrf_name changes are made to the specified VRF.
- INTF_NAME name of source
interface to be used for DNS requests. Options include:
- ethernet e_num ethernet interface specified by e_num.
- loopback l_num Loopback interface specified by l_num.
- management m_num Management interface specified by m_num.
- port-channel p_num Port-channel interface specified by p_num.
- vlan v_num VLAN interface specified by v_num.
Examples
- This command specifies VLAN 5 as the source interface for DNS
requests originating from the default
VRF.
switch(config)#ip domain lookup source-interface Vlan5 switch(config)#
- This command specifies VLAN 10 as the source interface for DNS
requests originating from VRF
purple.
switch(config)#ip domain lookup vrf purple source-interface Vlan10 switch(config)#
ip domain-list
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]
Parameters
- IP_DOMAIN_NAME specifies the IP domain name.
Examples
- This command specifies foo.com as the IP domain name to add to
the IP domain
list.
switch(config)#ip domain-list foo.com switch(config)#
- This command removes foo.com and returns the IP domain list to
its default
state.
switch(config)#no ip domain-list foo.com switch(config)#
ip host
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.
The no ip host and default ip host commands removes hostname-IP address maps by deleting the corresponding ip host command from running-config, as specified by command parameters:
- no parameters: command removes all hostname-IP address maps.
- hostname parameter: command removes all IP address maps for the specified hostname.
- hostname and IP address parameters: command removes specified hostname-IP address maps.
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]
Parameters
- hostname hostname (text).
- hostadd_N IPv4 address associated with hostname (dotted decimal notation).
Related commands
Examples
- This command associates the hostname test_lab with the IP addresses 10.24.18.5 and 10.24.16.3.
switch(config)#ip host test_lab 10.24.18.5 10.24.16.3
- This command removes all IP address maps for the hostname production_lab.
switch(config)#no ip host production_lab switch(config)#
ip name-server
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]
Parameters
- VRF_INSTANCE specifies the VRF instance
containing the addresses.
- <no parameter> default VRF.
- vrf vrf_name a user-defined VRF.
- SERVER_X IP address of the name server
(dotted decimal notation). Options include:
- ipv4_addr (A.B.C.D)
- ipv6_addr (A:B:C:D:E:F:G:H)
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.
Examples
- This command adds two name servers to the
configuration.
switch(config)#ip name-server 172.0.14.21 3:4F21:1902:: switch(config)#
- This command attempts to add a name server when the configuration already lists
three
servers.
switch(config)#ip name-server 172.1.10.22 % Maximum number of nameservers reached. '172.1.10.22' not added switch(config)#
ipv6 host
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.
The no ipv6 host and default ipv6 host commands remove hostname-IP address maps by deleting the corresponding ipv6 host command from running-config, as specified by command parameters:
- <no parameters>: command removes all hostname-IPv6 address maps.
- hostname parameter: command removes all IPv6 address maps for the specified hostname.
- hostname and IP address parameters: command removes specified hostname-IP address maps.
Command Mode
Global configuration
Command Syntax
ipv6 host hostname hostadd_1 [hostadd_2] ...[hostadd_X]
no ipv6 host [hostname] [hostadd_1 [hostadd_2] [hostadd_X]
default ipv6 host [hostname] [hostadd_1 [hostadd_2] [hostadd_X]
Parameters
- hostname hostname (text).
- hostadd_N IPv6 addresses associated with hostname (dotted decimal notation).
Related commands
Example
switch(config)#ipv6 host support_lab 2001:0DB8:73:ff:ff:26:fd:90
switch(config)#
logging format sequence-numbers
The logging format sequence-numbers command causes the sequence numbers of syslog messages to be visible when the messages are displayed.
The no logging format sequence-numbers and default logging format sequence-numbers commands remove the logging format sequence-numbers command from running-config.
Command Mode
Global configuration
Command Syntax
logging format sequence-numbers
no logging format sequence-numbers
default logging format sequence-numbers
Examples
- This command enables sequence numbering that can been seen when syslog messages are displayed.
switch(config)#logging format sequence-numbers switch(config)#
- To display the sequence numbers, issue the show logging command.
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#
logging repeat-messages
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
Examples
- This command repeats syslog messages instead of summarizing the count of
repeats.
switch(config)#logging repeat-messages switch(config)#
- This command displays the status of logging repeat messages
command.
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 SeverityEffective Severity -------------------- ------------- ------------------ aaadebugging debugging accounting debugging debugging switch(config)#
no event-monitor
The no event-monitor and default event-monitor commands remove the specified event-monitor configuration statements from running-config, returning the switch to the specified default state.
- no event-monitor <with no parameters> restores all default setting states:
- event monitor is enabled.
- buffer backup is disabled.
- no event-monitor backup disables the backup.
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
- PARAMETER the event
monitor property that is returned to the default state.
- <no parameter> all event monitor properties.
- backup event monitor buffer backup is disabled.
Example
- This command removes all event monitor configuration statements
from
running-config.
switch(config)#no event-monitor switch(config)#
ntp authenticate
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
Examples
- This command enables NTP authentication on the
switch.
switch(config)#ntp authenticate switch(config)#
- This command disables NTP authentication on the
switch.
switch(config)#no ntp authenticate switch(config)#
ntp authentication-key
The ntp authentication-key command creates an authentication key for use in authenticating incoming NTP packets. For the key to be used in authentication:
- It must be configured as a trusted key using the ntp trusted-key command.
- NTP authentication must be enabled on the switch using the ntp authenticate command.
- The same key must be configured on the NTP server.
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-key key_idENCRYPT_TYPE password_text
no ntp authentication-key key_id
default ntp authentication-key key_id
Parameters
- key_id key ID number. Value ranges from 1 to 65534.
- ENCRYPT_TYPE encryption
method. Values include:
- md5 key_text is MD5 encrypted.
- sha1 key_text is SHA-1 encrypted.
- password_text the authentication-key password.
Example
- This command creates an NTP authentication key with ID 234 and
password timeSync using MD5 encryption.
switch(config)#ntp authentication-key 234 md5 timeSync
Running-config stores the password as plain text.
- This command removes NTP authentication key 234.
switch(config)#no ntp authentication-key 234
ntp local-interface
The ntp local-interface command configures an interface as the source of NTP updates. That interfaces IP address is then used as the source address for all NTP packets sent to all destinations unless a server-specific source interface has been specified using the source option of the ntp server command.
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
Parameters
- VRF_INSTANCE the VRF
instance to be used for connection to the specified server.
- <no parameter> connects using the default VRF.
- vrf vrf_name connects using the specified user-defined VRF.
- INT_PORT the interface
port that specifies the NTP local interface. Settings include:
- ethernet e_range ethernet interface list.
- loopback l_range loopback interface list.
- management m_range management interface list.
- port-channel c_range port channel interface list.
- vlan v_range VLAN interface list.
Examples
- This command configures VLAN interface 25 as the source of NTP
update
packets.
switch(config)#ntp local-interface vlan 25 switch(config)#
- This command removes the ntp local-interface command from
the
configuration.
switch(config)#no ntp local-interface switch(config)#
ntp serve all
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
Example
- This command configures the switch to accept incoming NTP
requests.
switch(config)#ntp serve all switch(config)#
- This command configures the switch to deny incoming NTP
requests.
switch(config)#no ntp serve all switch(config)#
ntp serve
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
Example
- These commands configure ethernet interface 5 to accept incoming NTP requests
regardless of global
settings.
switch(config)#interface ethernet 5 switch(config-if-Et5)#ntp serve switch(config-if-Et5)#
- These commands configure ethernet interface 5 to deny incoming NTP requests
regardless of global
settings.
switch(config)#interface ethernet 5 switch(config-if-Et5)#no ntp serve switch(config-if-Et5)#
- These commands configure ethernet interface 5 to use global settings in
responding to incoming NTP
requests.
switch(config)#interface ethernet 5 switch(config-if-Et5)#default ntp serve switch(config-if-Et5)#
ntp server
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 will be 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.
Parameters
- VRF_INSTANCE the VRF instance to be
used for connection to the specified server.
- <no parameter> connects using the default VRF.
- vrf vrf_name connects using the specified user-defined VRF.
- SERVER_NAME NTP server location.
Options include:
- IP address in dotted decimal notation
- an FQDN host name
- PREFERENCE indicates priority of
this server when the switch selects a synchronizing server.
- <no parameter> server has no special priority.
- prefer server has priority when the switch selects a synchronizing server.
- NTP_VERSION specifies the NTP
version. Settings include:
- <no parameter> sets NTP version to 4 (default).
- version number, where number ranges from 1 to 4.
- IP_SOURCE specifies the source
interface for NTP updates for the specified NTP server. This option overrides
global settings created by the ntp local-interface command.
Options include:
- <no parameter> sets the source interface to the global default.
- source ethernet e_num ethernet interface specified by e_num.
- source loopback l_num loopback interface specified by l_num.
- source management m_num management interface specified by m_num.
- source port-channel p_num port-channel interface specified by p_num.
- source vlan v_num VLAN interface specified by v_num.
- burst indicates that when the NTP server is reached, the switch sends packets to the server in bursts of eight instead of the usual one. Recommended only for local servers. Off by default.
- iburst indicates that the switch sends packets to the server in bursts of eight instead of the usual one until the server is reached. Recommended for general use to speed synchronization. Off by default.
- AUTH_KEY the authentication key to use in
authenticating NTP packets from the server.
- <no parameter> no authentication key is specified.
- key <1 to 65534> switch will use the specified key to authenticate NTP packets from the server.
- MAX_POLL_INT specifies the maximum
polling interval for the server (as the base-2 logarithm of the interval in
seconds). Settings include:
- <no parameter> sets the maximum polling interval to 10 (1,024 seconds, the default).
- maxpoll number, where number is the base-2 logarithm of the interval in seconds. Values range from 3 (8 seconds) to 17 (131,072 seconds, approximately 36 hours).
- MIN_POLL_INT specifies the minimum
polling interval for the server (as the base-2 logarithm of the interval in
seconds). Settings include:
- <no parameter> sets the minimum polling interval to 6 (64 seconds, the default).
- minpoll number, where number is the base-2 logarithm of the interval in seconds. Values range from 3 (8 seconds) to 17 (131,072 seconds, approximately 36 hours).
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.
Examples
- This command configures the switch to update its time with the NTP server at
address 172.16.0.23 and designates it as a preferred NTP
server.
switch(config)#ntp server 172.16.0.23 prefer
- This command configures the switch to update its time through an NTP server named
local-nettime.
switch(config)#ntp server local-nettime
- This command configures the switch to update its time through a version 3 NTP
server.
switch(config)#ntp server 171.18.1.22 version 3
- These commands reconfigure the switch to access the above NTP servers through VRF
magenta.
switch(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)#
ntp trusted-key
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
Parameters
- 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
- This command configures the switch to trust authentication keys
234 and 237 for authentication of NTP
packets.
switch(config)#ntp trusted-key 234,237 switch(config)#
prompt
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
The prompt supports these control sequences:
- %s – space character
- %t – tab character
- %% – percent character
- %D – time and date
- %D{f_char} – time and date, format specified by the BSD strftime (f_char) time conversion function.
- %H – host name
- %h – host name up to the first ‘.’
- %P – extended command mode
- %p – command mode
- %r 1 – redundancy status on modular systems
- %R 2 – extended redundancy status on modular systems – includes status and slot number
Table 1 displays Command Mode and Extended Command Mode prompts for various modes.
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.
Examples
- This command creates a prompt that displays system 1 and
the command
mode.
host-name.dut103(config)#prompt system%s1%P system 1(config) #
- This command creates a prompt that displays the command
mode.
host-name.dut103(config)#prompt %p (config)#
- These equivalent commands create the default
prompt.
% prompt %H%P host-name.dut103(config)#
% no prompt host-name.dut103(config)#
show banner
The show banner command displays the specified banner.
Command Mode
Privileged EXEC
Command Syntax
show banner BANNER_TYPE
Parameters
- BANNER_TYPE banner that
the command displays. Options include
- login command displays login banner.
- motd command displays message of the day banner.
Example
- These commands configure and display the message of the day
banner.
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)#
show clock
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
- This command displays the current system clock time and configured time
zone.
switch>show clock Wed Nov2 10:29:32 2011 timezone is America/Los_Angeles switch>
show event-monitor arp
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.
Parameters
- GROUP used with aggregate
functions to group results. Analogous to SQL group
by command.
- <no parameter> results are not grouped.
- group-by interface results are grouped by interface.
- group-by ip results are grouped by IP address.
- group-by mac results are grouped by MAC address.
- group-by vrf results are grouped by VRF.
- MESSAGES number of
messages returned from query. Analogous to SQL limit command.
- <no parameter> result-set size is not limited.
- limit msg_quantity number of results that are displayed. Values range from 1 to 15,000.
- INTERFACE restricts
result-set to events that include specified interface (SQL Like command).
- <no parameter> result-set not restricted by interface.
- match-interface ethernet e_range ethernet interface list.
- match-interface loopback l_range loopback interface list.
- match-interface management m_range management interface list.
- match-interface port-channel c_range port channel interface list.
- match-interface tunnel t_range tunnel interface list.
- match-interface vxlan vx_range VXLAN interface list.
- match-interface port-channel c_range port channel interface list.
- IP restricts result-set to
events that include specified IP address (SQL Like command).
- <no parameter> result-set not restricted to specific IP addresses.
- match-ip ip_address_rex IP address, as represented by regular expression.
- MAC restricts result-set
to events that include specified MAC address (SQL Like command).
- <no parameter> result-set not restricted to specific MAC addresses.
- match-mac mac_address_rex MAC address, as represented by regular expression.
- TIME restricts result-set
to events generated during specified period.
- <no parameter> result-set not restricted by time of event.
- match-time last-minute includes events generated during last minute.
- match-time last-day includes events generated during last day.
- match-time last-hour includes events generated during last hour.
- match-time last-week includes events generated during last week.
- VRF restricts result-set
to events that include a specific VRF.
- <no parameter> result-set not restricted by time of event.
-
match-vrf vrf_name the VRF name.
Example
- This command displays ARP table events listed in the event
monitor
database.
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#
show event-monitor igmpsnooping
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]
Parameters
- GROUP used with aggregate functions to
group results. Analogous to SQL group by command.
- <no parameter> results are not grouped.
- group-by interface results are grouped by interface.
- group-by mac results are grouped by MAC address.
- group-by vlan results are grouped by VLAN.
- MESSAGES number of messages returned from
query. Analogous to SQL limit command.
- <no parameter> result-set size is not limited.
- limit msg_quantity number of results that are displayed. Values range from 1 to 15,000.
- MAC restricts result-set to events that
include specified MAC address (SQL Like command).
- <no parameter> result-set not restricted to specific MAC addresses.
- match-mac mac_address_rexMAC address, as represented by regular expression.
- INTERFACE restricts result-set to events
that include specified interface (SQL Like command).
- <no parameter> result-set not restricted by interface.
- match-interface ethernet e_range ethernet interface list.
- match-interface loopback l_range loopback interface list.
- match-interface management m_range management interface list.
- match-interface port-channel c_range port channel interface list.
- match-interface vlan v_range VLAN interface list.
- match-interface tunnel t_range tunnel interface list.
- match-interface vxlan vx_range VXLAN interface list.
- TIME restricts result-set to events with
specified period.
- <no parameter> result-set not restricted by time of event.
- match-time last-minute includes events generated during last minute.
- match-time last-day includes events generated during last day.
- match-time last-hour includes events generated during last hour.
- match-time last-week includes events generated during last week.
- VLAN restricts result-set to events that
include a specific VLAN (SQL Like command).
- <no parameter> result-set not restricted by time of event.
-
match-vlan vlan VLAN interface number.
switch#show event-monitor igmpsnooping
switch#
show event-monitor mac
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.
Parameters
- GROUP used with aggregate
functions to group results. Analogous to SQL group
by command.
- <no parameter> results are not grouped.
- group-by interface results are grouped by interface.
- group-by mac results are grouped by MAC address.
- MESSAGES number of
messages returned from query. Analogous to SQL limit command.
- <no parameter> result-set size is not limited.
- limit msg_quantity number of results that are displayed. Values range from 1 to 15,000.
- INTERFACE restricts
result-set to events that include specified interface (SQL Like command).
- <no parameter> result-set not restricted by interface.
- match-interface ethernet e_range ethernet interface list.
- match-interface loopback l_range loopback interface list.
- match-interface management m_range management interface list.
- match-interface port-channel c_range port channel interface list.
- match-interface vlan v_range VLAN interface list.
- match-interface tunnel t_range tunnel interface list.
- match-interface vxlan vx_range VXLAN interface list.
- MAC restricts result-set
to events that include specified MAC address (SQL Like command).
- <no parameter> result-set not restricted to specific MAC addresses.
- match-mac mac_address_rex MAC address, as represented by regular expression.
- TIME restricts result-set
to events with specified period.
- <no parameter> result-set not restricted by time of event.
- match-time last-minute includes events generated during last minute.
- match-time last-day includes events generated during last day.
- match-time last-hour includes events generated during last hour.
- match-time last-week includes events generated during last week.
Examples
- This command displays all events triggered by MAC address table
events.
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|0
- This command displays events triggered by MAC address table
changes.
switch#show event-monitor mac match-mac 08:08:08:% 2012-01-19 13:57:55|1|0808.0808.0808|ethernet1|configuredStaticMac|added|0
show event-monitor mroute
The 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.
Parameters
- GROUP used with aggregate
functions to group results. Analogous to SQL group
by command.
- <no parameter> results are not grouped.
- group-by interface results are grouped by interface.
- group-by ip6 results are grouped by IPv6 address.
- group-by mac results are grouped by MAC address.
- group-by vrf results are grouped by VRF.
- MESSAGES number of
messages returned from query. Analogous to SQL limit command.
- <no parameter> result-set size is not limited.
- limit msg_quantity number of results that are displayed. Values range from 1 to 15,000.
- IP restricts result-set to
events that include specified IP address (SQL Like command).
- <no parameter> result-set not restricted to specific IP addresses.
- match-ipv6 ip_address_rex IP address, as represented by regular expression.
- INTERFACE restricts
result-set to events that include specified interface (SQL Like command).
- <no parameter> result-set not restricted by interface.
- match-interface ethernet e_range ethernet interface list.
- match-interface loopback l_range loopback interface list.
- match-interface management m_range management interface list.
- match-interface port-channel c_range port channel interface list.
- match-interface vlan v_range VLAN interface list.
- match-interface tunnel t_range tunnel interface list.
- match-interface vxlan vx_range VXLAN interface list.
- SRC_IP restricts
result-set to events that include specified Source IP address (SQL Like
command).
- <no parameter> result-set not restricted to specific IP addresses.
- match-ip ip_address_rex IP address, as represented by regular expression.
- TIME restricts result-set
to events with specified period.
- <no parameter> result-set not restricted by time of event.
- match-time last-minute includes events generated during last minute.
- match-time last-day includes events generated during last day.
- match-time last-hour includes events generated during last hour.
- match-time last-week includes events generated during last week.
Examples
- This command displays neighbor table events listed in the event
monitor
database.
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|39
show event-monitor neighbor
The 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.
Parameters
- GROUP used with aggregate
functions to group results. Analogous to SQL group
by command.
- <no parameter> results are not grouped.
- group-by interface results are grouped by interface.
- group-by ip6 results are grouped by IPv6 address.
- group-by mac results are grouped by MAC address.
- group-by vrf results are grouped by VRF.
- MESSAGES number of
messages returned from query. Analogous to SQL limit command.
- <no parameter> result-set size is not limited.
- limit msg_quantity number of results that are displayed. Values range from 1 to 15,000.
- INTERFACE restricts
result-set to events that include specified interface (SQL Like command).
- <no parameter> result-set not restricted by interface.
- match-interface ethernet e_range ethernet interface list.
- match-interface loopback l_range loopback interface list.
- match-interface management m_range management interface list.
- match-interface port-channel c_range port channel interface list.
- match-interface vlan v_range VLAN interface list.
- match-interface tunnel t_range tunnel interface list.
- match-interface vxlan vx_range VXLAN interface list.
- IP6 restricts result-set
to events that include specified IP address (SQL Like command).
- <no parameter>result-set not restricted to specific IP addresses.
- match-ipv6 ip6_address_rex IPv6 address, as represented by regular expression.
- MAC restricts result-set
to events that include specified MAC address (SQL Like command).
- <no parameter> result-set not restricted to specific MAC addresses.
- match-mac mac_address_rex MAC address, as represented by regular expression.
- TIME restricts result-set
to events with specified period.
- <no parameter> result-set not restricted by time of event.
- match-time last-minute includes events generated during last minute.
- match-time last-day includes events generated during last day.
- match-time last-hour includes events generated during last hour.
- match-time last-week includes events generated during last week.
- VRF restricts result-set
to events that include a specific VRF (SQL Like command).
- <no parameter> result-set not restricted by time of event.
- match-vrf vrf_name VRF name, as represented by a regular expression.
Examples
- This command displays neighbor table events listed in the event
monitor
database.
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|10
show event-monitor route6
The 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.
Parameters
- GROUP used with aggregate
functions to group results. Analogous to SQL group
by command.
- <no parameter> results are not grouped.
- group-by interface results are grouped by interface.
- group-by ip6 results are grouped by IPv6 address.
- group-by mac results are grouped by MAC address.
- group-by vrf results are grouped by VRF.
- MESSAGES number of
messages returned from query. Analogous to SQL limit command.
- <no parameter> result-set size is not limited.
- limit msg_quantity number of results that are displayed. Values range from 1 to 15,000.
- IP6 restricts result-set
to events that include specified IP address (SQL Like command).
- <no parameter> result-set not restricted to specific IP addresses.
- match-ipv6 ip6_address_rex IPv6 address, as represented by regular expression.
- TIME restricts result-set
to events with specified period.
- <no parameter> result-set not restricted by time of event.
- match-time last-minute includes events generated during last minute.
- match-time last-day includes events generated during last day.
- match-time last-hour includes events generated during last hour.
- match-time last-week includes events generated during last week.
Examples
- This command displays neighbor table events listed in the event
monitor
database.
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#
show event-monitor route
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.
Parameters
- GROUP used with aggregate
functions to group results. Analogous to SQL group
by command.
- <no parameter> results are not grouped.
- group-by ip results are grouped by IPv4 address.
- MESSAGES number of
messages returned from query. Analogous to SQL limit command.
- <no parameter> result-set size is not limited.
- limit msg_quantity number of results that are displayed. Values range from 1 to 15,000.
- IP restricts result-set to
events that include specified IP address (SQL Like command).
- <no parameter> result-set not restricted to specific IP addresses.
- match-ip ip_address_rex IP address, as represented by regular expression.
- TIME restricts result-set
to events with specified period.
- <no parameter> result-set not restricted by time of event.
- match-time last-minute includes events generated during last minute.
- match-time last-day includes events generated during last day.
- match-time last-hour includes events generated during last hour.
- match-time last-week includes events generated during last week.
Example
- This command displays 10 routing table events listed in the event
monitor
database.
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#
show event-monitor sqlite
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
Parameters
- statement SQLite statement.
Example
- This command displays all entries from the route
table.
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#
show event-monitor stpunstable
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.
Parameters
- MESSAGES number of messages returned from
query. Analogous to SQL limit command.
- <no parameter> result-set size is not limited.
- limit msg_quantity number of results that are displayed. Values range from 1 to 15,000.
- TIME restricts result-set to events with
specified period.
- <no parameter> result-set not restricted by time of event.
- match-time last-minute includes events generated during last minute.
- match-time last-day includes events generated during last day.
- match-time last-hour includes events generated during last hour.
- match-time last-week includes events generated during last week.
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#
show hostname
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
- This command displays the hostname and FQDN of the
switch.
switch>show hostname Hostname: switch_1 FQDN: switch_1.aristanetworks.com switch>
show hosts
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
- This command displays the switchs IP domain
name:
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_LABIPV410.24.18.6 PRODUCTION_LABIPV410.24.18.7 SUPPORT_LAB IPV62001:0DB8:73:ff:ff:26:fd:90 switch>
show ip domain-name
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
- This command displays the switchs IP domain
name:
switch>show ip domain-name aristanetworks.com switch>
show ip name-server
The 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
- This command displays the IP address of name servers that the switch is
configured to
access.
switch>show ip name-server 172.22.22.10 172.22.22.40 switch>
show local-clock time-properties
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
Examples
- This command shows the PTP clock
properties.
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#
show ntp associations
The show ntp associations command displays the status of connections to NTP servers.
Command Mode
EXEC
Command Syntax
show ntp associations
Display Values
- refid (reference ID): the reference ID of the configured NTP server’s time source.The reference ID is either the IPv4 address of the source or (if the source has an IPv6 address) the first four octets of the MD5 hash of the IPv6 address.
- st (stratum): number of steps between the switch and the reference clock.
- t (transmission type): u unicast; b broadcast; l local.
- when: interval since reception of last packet (seconds unless unit is provided).
- poll: interval between NTP poll packets. Maximum (1024) reached as server and client syncs.
- reach: octal number that displays status of last eight NTP messages (377 - all messages received).
- delay: round trip delay of packets to selected reference clock.
- offset: difference between local clock and reference clock.
- jitter: maximum error of local clock relative to reference clock.
Example
- This command displays the status of the switch’s NTP
associations.
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#
show ntp status
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.
In eos releases prior to 4.23.2, this command identified system peers with IPv6 addresses by their reference IDs (the first four octets of the MD5 hash of the IPv6 address).In later releases, this command always shows the IP address of the system peer (whether IPv4 or IPv6).
Command Mode
EXEC
Command Syntax
show ntp status
Example
- This command displays the switch’s NTP
status.
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>