3.9 Command-Line Interface Commands
Mode Navigation Commands
alias
bash
daemon
enable
end
exit
File Transfer Commands
File Management Commands
dir
pwd
Modular Switch Platform Commands
CLI Scheduling Commands
Event Handler Commands
delay
Terminal Parameter Commands
Display and Comment Commands
action bash
The action bash command specifies a Bash shell command to be run when an event handler is triggered. When an event handler is triggered, execution of the associated shell command is delayed by a configurable period set by the delay command. Only a single Bash command may be configured for an event handler, but the command may have multiple arguments. If more than one Bash command must be executed in response to a trigger, create a script containing the desired commands and enter the file path to the script as the argument of the action bash command.
To specify the event that will trigger the action, use the trigger command.
If the event handler uses an on-intf trigger, the following environment variables are passed to the action and can be used as arguments to the Bash command:
$INTF     interface name.
$OPERSTATE     current operational status of the specified interface.
$IP-PRIMARY     current primary IP address of the specified interface.
Command Mode
Event-Handler Configuration
Command Syntax
action bash command
Parameters
command     Bash shell command to be executed when the event handler is triggered.
Example
This command configures the event handler “onStartup” to run a script on the flash drive.
switch(config-handler-onStartup)#action bash /mnt/flash/myScript1
switch(config-handler-onStartup)#
This command configures the event handler “eth_4” to send email to the specified address when there is a change in the operational status of Ethernet interface 4.
switch(config-event-eth_4)#action bash email x@yz.com -s "Et4 $OPERSTATE"
switch(config-event-eth_4)#
The above action uses the $OPERSTATE variable to include the current operational state (“linkup” or “linkdown”) in the subject of the email. Note that the action will only function if email has been configured on the switch.
alias
The alias command creates an alias for a CLI command. Entering the alias in the CLI executes the corresponding command. Once created, an alias is accessible in all modes and all user sessions, but is subject to all the restrictions of the original command.
When using a command alias, no tokens may precede the alias except the no and default keywords. However, an alias can incorporate positional parameters.
In online help, aliases are preceded by an asterisk (*) in this format:
*alias_name=command_name
The no alias and default alias commands remove the specified alias.
Command Mode
Global Configuration
Command Syntax
alias alias_name command_name
no alias alias_name
default alias alias_name
Parameters
alias_name     the string which is to be substituted for the original command. The string can include letters, numbers, and punctuation, but no spaces. If the alias_name string is identical to an existing command, the alias will supercede the original command.
command_name     the command which is to be executed when the alias is entered in the CLI. If the original command requires additional parameters, they must be included in the command_name string in the following manner:
Positional parameters are of the form “%n” and must be whitespace-delimited. The first parameter is represented by “%1” and any additional parameters must be numbered sequentially. When executing the alias a value must be entered for each parameter or the CLI will display the error “% incomplete command”.
Examples
This command makes e an alias for the command enable.
switch(config)#alias e enable
This command makes srie an alias for the command show running-config interface ethernet 1-6.
switch(config)#alias srie show running-config interface ethernet 1-6
These commands make ss an alias for the command show interfaces ethernet <range> status with a positional parameter for the port range, then use the alias to display the status of ports 4/1-4/5.
switch(config)#alias ss show interfaces ethernet %1 status
switch(config)#ss 4/1-4/5
Port      Name            Status       Vlan       Duplex  Speed Type
Et4/1                     connected    in Po1       full  10000 10GBASE-SRL
Et4/2                     notconnect   in Po1       full  10000 10GBASE-SRL
Et4/3                     notconnect   1            full  10000 10GBASE-SRL
Et4/4                     notconnect   1            full  10000 10GBASE-SRL
Et4/5                     notconnect   1            full  10000 10GBASE-SRL
bash
The bash command starts the Linux Bash shell. The Bash shell gives you access to the underlying Linux operating system and system extensions.
To exit the Bash, type logout, exit, or Ctrl-D at the Bash prompt.
Command Mode
Privileged EXEC
Command Syntax
bash
Examples
This command starts the Bash shell.
switch#bash
 
Arista Networks EOS shell
 
[admin@switch ~]$
This command, executed within Bash, exits the Bash shell.
[admin@switch ~]$ logout
switch#
comment (various configuration modes)
The comment command adds a comment for the active configuration mode to running-config. Comments cannot be modified, but can be replaced by entering the comment command again and entering new text. To append to an existing comment, enter !! followed by additional comment text. To display comments, use the comment option of the show (various configuration modes) command.
The no comment and default comment commands remove the comment from running-config.
Comments cannot be added to the global configuration mode through the EOS.
Command Mode
All configuration modes except Global Configuration
Command Syntax
comment comment_text EOF
no comment
default comment
!! comment_text
Parameters
comment_text     To create a comment, enter a message when prompted. The message may span multiple lines.
EOF     To end a comment, type EOF on its own line (case sensitive) and press enter.
Example
This command adds a comment to the active configuration mode.
switch(config-sg-radius-RAD-SV1)#comment
Enter TEXT message. Type 'EOF' on its own line to end.
Consult Thomas Morton before making changes to the RADIUS configuration.
EOF
switch(config-sg-radius-RAD-SV1)#
This command appends a line to the comment for the active configuration mode.
switch(config-sg-radius-RAD-SV1)#!! x3452
switch(config-sg-radius-RAD-SV1)#
configure (configure terminal)
The configure command places the switch in the Global Configuration mode to configure features at the system level. You can move to Interface Configuration mode and protocol-specific mode from the Global Configuration mode. The command may also be entered as configure terminal.
Command Mode
Privileged EXEC
Command Syntax
configure [terminal]
Example
This command places the switch in the Global Configuration mode.
switch>enable
switch#configure
switch(config)#
configure checkpoint
The configure checkpoint command saves the running configuration to a checkpoint file. This checkpoint file can be used for restoring the current running configuration in future, if required.
Command Mode
Privileged EXEC
Command Syntax
configure checkpoint {restore checkpoint_name | save [checkpoint_name]}
Parameters
restore checkpoint_name     restores the running configuration from the specified checkpoint file.
save checkpoint_name     saves running configuration to the specified checkpoint file.
Guidelines
If the filename already exists, EOS overwrites the filename. If the command is entered without a checkpoint name, the switch automatically saves the checkpoint under the name ckp-date-number where date is the date in YYYYMMDD format and number increments by one for each automatically named checkpoint file.
Examples
This command saves running-config to the ca_test checkpoint file.
switch#configure checkpoint save ca_test
This command restores the running-config from the ca_test checkpoint file.
switch#configure checkpoint restore ca_test
! Preserving static routes. Use 'no ip routing delete-static-routes' to clear
them.
This command saves running-config to the 13Aug2018 checkpoint file. The dir command shows the contents of the checkpoint directory.
switch#configure checkpoint save
switch#dir checkpoint:
Directory of checkpoint:/
 
       -rw-        7426           Aug 13 12:00  ckp-20180813-17
       -rw-        7588           Aug 13 12:10  ckp-20180813-18
       -rw-        8499           Aug 13 12:13  ckp-20180813-19
       -rw-        8499           Aug 13 12:13  ckp-20180813-20
configure convert
The configure convert command converts the current configuration syntax to the specified syntax.
Command Mode
Privileged EXEC
Command Syntax
configure convert new-syntax
Parameter
new-syntax     converts running-config to the current version of EOS.
Example
This command converts running-config to the current version of EOS.
switch#configure convert new-syntax
 
WARNING!
Converting existing configuration to new syntax will lose backward compatibility.
Make sure you won't downgrade to releases that only support the old syntaxes.
 
Proceed [ y/n ]
configure network
The configure network command is deprecated. Use the copy <url> running-config command to configure the switch from a local file or network location.
copy running-config
The current operating configuration of the switch is stored in a virtual file called running-config. The copy running-config command saves the contents of the running-config virtual file to a new location.
Command Mode
Privileged EXEC
Command Syntax
copy running-config DESTINATION
Parameters
DESTINATION     destination for the contents of the running-config file. Values include:
startup-config     the configuration file that the switch loads when it boots.
The copy running-config startup-config and write commands are equivalent.
file:     a file in the switch file directory.
flash:     a file in flash memory.
url     any valid URL.
The copy running-config url and write network url commands are equivalent.
Examples
This command copies running-config to the startup-config file.
switch#copy running-config startup-config
switch#
This command copies running-config to a file called rc20110617 in the dev subdirectory of the switch directory.
switch#copy running-config file:dev/rc20110617
switch#
daemon
The daemon command accesses daemon configuration mode for adding or removing external daemons and scripts, which are then managed by ProcMgr.
The no daemon and default daemon commands delete the deamon by removing the corresponding daemon command from running-config.
Command Mode
Global Configuration
Command Syntax
daemon daemon_name
no daemon daemon_name
default daemon daemon_name
Parameters
daemon_name     label that references the daemon configuration mode.
Examples
These commands enters daemon configuration mode and initiates the daemon script.
switch(config)#daemon process1
switch(config-daemon-process1)#command process-script -i -m
switch(config-daemon-process1)#
delay
The delay command specifies the time in seconds the system will delay between a triggering event and the execution of an event handler action. The default delay is 20 seconds.
Command Mode
Event-Handler Configuration
Command Syntax
delay seconds
Parameters
seconds     number of seconds to delay before executing the action. The default is 20.
Example
This command configures the event handler Eth5 to delay 10 seconds before executing.
switch(config-handler-Eth5)#delay 10
switch(config-handler-Eth5)#
dir
The dir command displays a list of files on a file system.
Command Mode
Privileged EXEC
Command Syntax
dir [SCOPE][FILE TYPE]
Parameters
SCOPE     the files to display. Options include
<no parameter>     lists normal files in current directory.
/all     list all files, including hidden files
/recursive     list files recusively
FILE TYPE     The options include:
<no parameter>     lists undeleted files
all_filesystems      list files on all filesystems including deleted files, undeleted files, and files with errors
extensions     directory or file name
file     directory or file name
flash     directory or file name
supervisor-peer     directory or file name
system     directory or file name
usb1     directory or file name
Example
This command displays the flash directory.
switch# dir flash:
Directory of flash:/
 
       -rwx   293409892           Oct 23 08:55  EOS-4.11.0.swi
       -rwx   221274543            Sep 6 13:37  EOS-4.7.5.swi
       -rwx   271453650            Sep 4 19:13  EOS_4.10.1-SSO.swi
       -rwx      135168           Dec 31  1979  FSCK0000.REC
       -rwx          26           Oct 23 13:51  boot-config
       -rwx        8570           Sep 10 12:22  cfg_sso_mst
       -rwx        5642           Sep 20 10:35  config.reset
       drwx        4096           Oct 23 13:59  debug
       -rwx          12           Oct 23 13:56  kernel-params
       drwx        4096           Oct 23 14:59  persist
       drwx        4096            Sep 6 14:50  schedule
       -rwx        5970           Oct 23 13:53  startup-config
switch#
disable
The disable command exchanges the session’s current command mode with the specified privilege level.
Command Mode
Privileged EXEC
Command Syntax
disable [PRIVILEGE_LEVEL]
Parameters
PRIVILEGE_LEVEL    Session’s new privilege level. Value ranges from 0 to 15. Levels 2 through 15 place the switch in Privileged EXEC mode. Values of 0 or 1 leave the switch in EXEC mode.
<no parameter>     Session is assigned default level of 1.
<0 to 15>     Specifies session level.
Restrictions
New privilege level must be less than the session’s current level.
Examples
This command exits Privileged EXEC mode level of 15 to enter EXEC mode level 1.
switch# disable
switch>
enable
The enable command places the switch in Privileged EXEC mode. If an enable password is set, the CLI displays a password prompt when a user enters the enable command. If the user enters an incorrect password three times, the CLI displays the EXEC mode prompt.
To set a local enable password, use the enable password command.
Command Mode
EXEC
Command Syntax
enable [PRIVILEGE_LEVEL]
Parameters
PRIVILEGE_LEVEL    Session’s privilege level. Values range from 0 to 15. Values of 0 or 1 places the switch in EXEC mode. Any level above 1 leaves the switch in Privileged EXEC mode.
<no parameter>     Session is assigned default level of 15.
<0 to 15>     Specifies session level.
Example
This command places the switch in Privileged EXEC mode with the default privilege level of 15.
switch>enable
switch#
end
The end command exits to Privileged Exec mode from any Configuration mode. If the switch is in a group-change mode (such as ACL-Configuration mode or MST-Configuration mode), the end command also saves all pending changes made in that mode to running-config.
Command Mode
All configuration modes
Command Syntax
end
Example
This command exits to Privileged Exec mode.
switch(config-if-Et25)#end
switch#
event-handler
An event handler executes a Linux Bash shell command in response to a specific system event. An event handler consists of a Bash command, a trigger and a delay; when the trigger event occurs, the action is scheduled to run after delay seconds.
The event-handler command places the switch in event-handler configuration mode for the specified event handler. If the named event handler does not already exist, this command creates it. Event-handler configuration mode is a group change mode that configures event handlers.
Changes made in a group change mode are saved by leaving the mode through the exit command or by entering another configuration mode.
These commands are available in event-handler configuration mode:
delay
The no event-handler and default event-handler commands delete the specified event handler by removing it from running config.
Command Mode
Global Configuration
Command Syntax
event-handler name
no event-handler name
default event-handler name
Parameters
name     name of the event handler to be configured. If the named event handler does not already exist, this command will create it.
Example
This command places the switch in event-handler configuration mode for an event handler called “Eth_5”.
switch(config)#event-handler Eth_5
switch(config-handler-Eth_5)#
event-handler DropCountersHandler
The event-handler DropCountersHandler command enables the adverse drop counters monitor with event handlers. The DropCountersHandler event handler is enabled by default, and can be customized for duration of time window and threshold levels.
The no event-handler DropCountersHandler command disables the adverse drop counters monitor with event handlers. The default event-handler DropCountersHandler command resets the DropCountersHandler event handler to the system default.
Command Mode
Global Configuration
Command Syntax
event-handler DropCountersHandler
no event-handler DropCountersHandler
default event-handler DropCountersHandler
Examples
These commands customize the delay, polling interval, and condition for width (-w), violation count (-c), and threshold (-t) of this event handler. Each parameter may be customized separately, with all other parameters remaining unchanged.
switch(config)#event-handler DropCountersHandler
switch(config-DropCountersHandler)#action bash DropCounterLog.py -l
switch(config-DropCountersHandler)#delay 0
switch(config-DropCountersHandler)#trigger on-counters
switch(config-DropCountersHandler-counters)#poll interval 60
switch(config-DropCountersHandler-counters)#condition bashCmd."DropCounterMonitor.py" -w 800" > 0
switch(config-DropCountersHandler-counters)#condition bashCmd."DropCounterMonitor.py" -c 5" > 0
switch(config-DropCountersHandler-counters)#condition bashCmd."DropCounterMonitor.py" -t 200" > 0
switch(config-DropCountersHandler-counters)#
This command disables this event handler.
switch(config)#no event-handler DropCountersHandler
switch(config)#
exit
The exit command places the switch in the parent of the command mode from which the exit command was entered.
When used in Global configuration, the switch enters Privileged EXEC mode.
When used in EXEC or Privileged EXEC mode, the exit command terminates the user session.
When the command is used in a group-change mode (such as ACL-Configuration mode or MST-Configuration mode), the exit command also applies all pending changes made in that mode.
Command Mode
All modes
Command Syntax
exit
Example
This command exits Global Configuration mode to Privileged EXEC mode.
switch(config)#exit
switch#
This command terminates the user session.
switch#exit
ip ftp client source-interface
By default, the FTP (File Transfer Protocol) source IP address is selected by the switch (the IP address of the source interface if one is assigned). The ip ftp client source-interface command allows the user to override the default FTP source address.
The ip ftp client source-interface and ip ftp source-interface commands are functionally equivalent. In each case, ip ftp client source-interface is stored in running-config
The no ip ftp client source-interface and default ip ftp client source-interface commands restore default behavior by removing the ip ftp client source-interface statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip ftp [client] source-interface INTERFACE [vrf vrf_name]
no ip ftp [client] source-interface
default ip ftp [client] source-interface
Parameters
client     Parameter has no functional effect.
INTERFACE    Interface providing the IP address. 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.
tunnel t_num     Tunnel interface specified by t_num.
vlan v_num     VLAN interface specified by v_num.
vrf vrf_name     Uses the specified user-defined VRF.
Examples
These commands configure the 10.10.121.15 as the source IP address the switch uses when communicating with FTP servers.
switch(config)#interface ethernet 17
switch(config-if-Et17)#ip address 10.10.121.15/24
switch(config-if-Et17)#ip ftp client source-interface ethernet 17
switch(config)#
This command configures the switch to use interface tunnel 45 and vrf vrf01 when communicating with FTP servers.
switch(config)#ip ftp client source-interface tunnel 45 vrf vrf01
switch(config)#
ip http client local-interface
The ip http client local-interface command specifies the source IP address for hypertext transfer protocol (HTTP) connections. By default, the source IP address is selected by the switch when this command is not configured or when the specified interface is not assigned an IP address.
The no ip http client local-interface and default ip http client local-interface commands restore default behavior by removing the ip http client local-interface statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip http client local-interface INTERFACE [vrf vrf_name]
no ip http client local-interface
default ip http client local-interface
Parameters
INTERFACE    Interface providing the IP address. 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.
vrf vrf_name     Uses the specified user-defined VRF.
Examples
These commands configure the 10.15.17.9 as the source IP address the switch uses when communicating with HTTP servers.
switch(config)#interface vlan 10
switch(config-if-Vl10)#ip address 10.15.17.9/24
switch(config-if-Vl10)#ip http client local-interface vlan 10
switch(config)#
This command configures the switch to use interface tunnel 45 and vrf vrf01 when communicating with HTTP servers.
switch(config)#ip http client local-interface tunnel 45 vrf vrf01
switch(config)#
ip ssh client source-interface
The ip ssh client source-interface command specifies the source IP address for secure shell (SSH) connections. By default, the source IP address is selected by the switch when this command is not configured or when the specified interface is not assigned an IP address.
The ip ssh client source-interface and ip ssh source-interface commands are functionally equivalent. In each case, ip ssh client source-interface is stored in running-config
The no ip ssh client source-interface and default ip ssh client source-interface commands restore default behavior by removing the ip ssh client source-interface statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip ssh [client] source-interface INTERFACE [vrf vrf_name]
no ip ssh [client] source-interface
default ip ssh [client] source-interface
Parameters
client     Parameter has no functional effect.
INTERFACE    Interface providing the IP address. 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.
vrf vrf_name     Uses the specified user-defined VRF.
Examples
These commands configure the 10.17.17.9 as the source IP address the switch uses when communicating with SSH servers.
switch(config)#interface vlan 10
switch(config-if-Vl10)#ip address 10.17.17.9/24
switch(config-if-Vl10)#ip ssh client source-interface vlan 10
switch(config)#
This command configures the switch to use interface tunnel 45 and vrf vrf01 when communicating with SSH servers.
switch(config)#ip ssh client source-interface tunnel 45 vrf vrf01
switch(config)#
ip tftp client source-interface
The ip tftp client source-interface command specifies the source IP address for Trivial File Transfer Protocol (TFTP) connections. By default, the source IP address is selected by the switch when this command is not configured or when the specified interface is not assigned an IP address.
The ip tftp client source-interface and ip tftp source-interface commands are functionally equivalent. In each case, ip tftp client source-interface is stored in running-config
The no ip tftp client source-interface and default ip tftp client source-interface commands restore default behavior by removing the ip tftp client source-interface statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip tftp [client] source-interface INTERFACE [vrf vrf_name]
no ip tftp [client] source-interface
default ip tftp [client] source-interface
Parameters
client     Parameter has no functional effect.
INTERFACE    Interface providing the IP address. 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.
vrf vrf_name     Uses the specified user-defined VRF.
Examples
These commands configure the 10.15.17.9 as the source IP address the switch uses when communicating with TFTP servers.
switch(config)#interface vlan 10
switch(config-if-Vl10)#ip address 10.15.17.9/24
switch(config-if-Vl10)#ip tftp client source-interface vlan 10
switch(config)#
This command configures the switch to use interface tunnel 45 and vrf vrf01 when communicating with TFTP servers.
switch(config)#ip tftp client source-interface tunnel 45 vrf vrf01
switch(config)#
platform arad lag mode
The platform arad lag mode command allows configuration of LAGs with more than 16 members.
Command Mode
Global Configuration
Command Syntax
platform arad lag mode [1024x16 | 256x64 | 512x32]
Examples
This command configures 1024 LAGs with 16 members each.
switch(config)# platform arad lag mode 1024x16
! Change will take effect only after switch reboot.
switch(config)#
This command configures 256 LAGs with 64 members each.
switch(config)# platform arad lag mode 256x64
! Change will take effect only after switch reboot.
switch(config)#
This command configures 512 LAGs with 32 members each.
switch(config)# platform arad lag mode 512x32
! Change will take effect only after switch reboot.
switch(config)#
 
platform sand fabric mode (7500 and 7500E Series)
The platform sand fabric mode command specifies the fabric mode under which the switch operates after the next system reload. The command has no operational effect until the switch reloads.
The fabric mode determines the modular switch’s fabric performance capabilities and must be compatibile with the installed fabric modules. Fabric mode settings include:
fe600: Supports first-generation fabric modules.
fe1600: Supports E-Series fabric modules.
Important! Switches that reload in petraA forwarding compatibility mode ( platform sand forwarding mode (7500 and 7500E Series)) also reload in fe600 fabric mode regardless of the presence of a platform sand fabric mode statement in running-config.
The switch’s fabric mode setting must match the capabilities of its installed fabric modules. Reloading the switch in a different mode may be required after exchanging fabric modules for a different module type. The show module command displays the fabric modules in the switch.
Each fabric module is categorized as first-generation or E-Series:
First-generation fabric modules support all basic switch functions.
E-Series fabric modules support faster fabric link speeds, greater internal table capacities, and advanced encoding formatting.
E-series fabric modules can operate in fe600 mode, but are limited to first-generation fabric performance. First-generation modules cannot operate in fe1600 mode. Switches containing both types of modules must be set to fe600 mode. Best practice is to avoid switch configurations with mixed fabric modules.
When a switch reloads, fabric mode is determined by the following (in order of precedence):
Step 1 Switches reloading in petraA forwarding compability mode also reload in fe600 fabric mode .
Step 2 As specified by the platform sand fabric mode statement in running-config.
Step 3 The first fabric module that becomes operational as the switch reloads.
In switches with a homogeneous module set, the fabric mode matches its fabric modules. Switches with a mixed set of modules are typically reloaded in fe600 mode because first generation modules are usually operational before E-Series modules. However, the fabric mode in mixed module switches that are reloading cannot be guaranteed in the absence of the first two conditions.
The no platform sand fabric mode and default platform sand fabric mode commands remove the platform sand fabric mode command from running-config.
Command Mode
Global Configuration
Command Syntax
platform sand fabric mode [MODE_SETTING]
no platform sand fabric mode
default platform sand fabric mode
Parameters
MODE_SETTING     Specifies the switch’s fabric mode. Options include:
fe16000     E-Series fabric mode.
fe600     First-generation fabric mode.
Examples
This command configures the switch to reload in fe1600 fabric mode to support E-series fabric modules. After issuing this command, the switch should be reset only after exchanging all switch fabric modules to E-series modules.
switch(config)#platform sand fabric mode fe1600
switch(config)#exit
switch#show platform sand compatibility
                     Configuration        Status
Forwarding mode      None                 Arad
Fabric mode          Fe1600               Fe600
switch#
platform sand forwarding mode (7500 and 7500E Series)
The platform sand forwarding mode command specifies the forwarding compatibility mode under which the switch operates after the next system reload. The command has no operational effect until the switch reloads.
Forwarding compatibility mode specifies switch forwarding capabilities and configures performance capacity of installed linecards. Forwarding compatibility modes settings include:
petraA: Supports first-generation fabric modules.
arad: Supports E-Series fabric modules.
Important! Switches that reload in petraA forwarding compatibility mode also reload in fe600 fabric mode regardless of the presence of a platform sand fabric mode (7500 and 7500E Series) statement in running-config.
This command may be required after exchanging a linecard for a different module type or in switches containing first-generation and E-series linecards. The show module command displays the linecard modules in the switch.
Each modular switch linecard module is categorized as first-generation or E-Series:
First-generation linecards support all basic switch functions.
E-Series linecards support provide faster data processing, greater internal table capacities, and advanced encoding formatting.
The forwarding compatibility mode determines the operational capacity of installed linecards. Table 3-5 lists the affect of the forwarding compatibility mode on all linecard module types.
Table 3-5  Linecard Module and Forwarding Mode Performance
Linecard Module Type
Forwarding Software Mode
Linecard Operating Capacity
First-generation
petraA
Linecard performs at first-generation performance capacity.
First-generation
arad
Linecard is powered-down.
E-Series
petraA
Linecard performs at first-generation performance capacity.
E-Series
arad
Linecard performs at E-series performance capacity.
Important! Linecards operate at E-Series performance capacities only on switches that contain E-Series fabric modules and have a fabric mode seting of fe1600 fabric mode ( platform sand fabric mode (7500 and 7500E Series)).
Without a platform sand forwarding mode command, forward compatibility mode is determined by the first linecard that becomes operational after reloading the switch. In a switch that is reloaded with a homogeneous module set, forwarding compatibility mode matches its linecards. Switches with a mixed set of modules are typically reloaded in petraA mode because first generation modules are usually operational before E-Series modules. However, forwarding compatibility mode in mixed module switches that are reloading is not guaranteed without a platform sand forwarding mode command.
The no platform sand forwarding mode and default platform sand forwarding mode commands restore the platform sand forwarding mode command from running-config.
Command Mode
Global Configuration
Command Syntax
platform sand forwarding mode [MODE_SETTING]
no platform sand forwarding mode
default platform sand forwarding mode
Parameters
MODE_SETTING     Specifies the switch’s software forwarding mode. Options include:
arad     the switch supports E-Series linecard capabilities.
petraA     the switch supports first-generation linecard capabilities.
Examples
This command changes the forwarding software mode to support E-series linecard modules. This command should be run only after exchanging all linecards to E-series modules.
switch(config)#platform sand forwarding mode arad
switch(config)#
platform sand lag hardware-only
The platform sand lag hardware-only command specifies that all LAGs will use hardware resources including single member LAGs. Hardware resource allocation and deallocation traffic disruption occurs on the first member addition or deletion, rather than the second member addition or deletion.
The no platform sand lag hardware-only and default platform sand lag hardware-only commands specify that LAGs are not required to be implemented in hardware, and therefore some LAGs may be implemented in software. Permitting both hardware and software LAGs may increase the total number of port-channels because we have no resource limit on the number of software LAGs.
Command Mode
Global Configuration
Command Syntax
platform sand lag hardware-only
no platform sand lag hardware-only
default platform sand lag hardware-only
Examples
This command configures all LAGs to use hardware resources. All existing one member LAGs will be allocated hardware resources, when available.
switch(config)#platform sand lag hardware-only
switch(config)#
This command allows certain LAGs (single member LAGs) to not consume hardware resources. All existing one member LAGs will release their hardware resources.
switch(config)#no platform sand lag hardware-only
switch(config)#
pwd
The pwd command displays the working directory.
Command Mode
Privileged EXEC
Command Syntax
pwd
Examples
This command shows that the working is Flash.
switch# pwd
flash:/
switch#
schedule
The schedule command facilitates the periodic execution of a specified CLI command. Command parameters configure the start time of periodic execution, the interval between consecutive execution instances, the maximum time allotted for command execution, and the maximum number of log files that can be created.
The no schedule and default schedule commands disable execution of the specified command.
Command Mode
Global Configuration
Command Syntax
schedule schedule_name PERIOD {max-log-files count | timeout timeout_interval} {command cmd | logging verbose | loglocation flash:}
no schedule schedule_name
default schedule schedule_name
Parameters
name     label associated with the scheduled command.
PERIOD     start time for execution and interval between consecutive execution instances. The interval ranges from 2 to 1440 minutes. The default interval while scheduling the show tech-support command is 60 minutes. Options include:
at     start time for execution. Options include:
hh:mm:ss interval interval     The command execution starts at the specified time and repeats at the specified interval.
hh:mm:ss mm/dd/yyyy interval interval     The command execution starts at the specified time on the specified day and repeats at the specified interval.
hh:mm:ss once     The command execution starts at the specified time and does not repeat.
hh:mm:ss mm/dd/yyyy once     The command execution starts at the specified time on the specified day and does not repeat.
hh:mm:ss yyyy-mm-dd interval interval     The command execution starts at the specified time on the specified day and repeats at the specified interval.
hh:mm:ss yyyy-mm-dd once     The command execution starts at the specified time on the specified day and does not repeat.
interval interval     The command execution starts immediately and repeats at the specified interval.
now interval interval     The command execution starts immediately and repeats at the specified interval.
max-log-files count     maximum number of log files command generates for command output. The count of maximum log files ranges from 1 to 10000. The default count of maximum log files while scheduling the show tech-support command is 100.
timeout timeout_interval     maximum time allotted for the script execution. The timeout interval ranges from 1 to 480 minutes. The default timeout is 30 minutes.
Note The command execution is terminated if it exceeds the specified timeout interval. The timeout allotted for the scheduled command must not be greater than the corresponding interval.
command cmd     The command that needs to be executed.
logging verbose     Sets the logging level to “verbose.” A syslog entry is added after the execution of the scheduled command, regardless of whether the scheduled command has succeeded or failed. In the absence of logging verbose, the syslog entry is added only if the execution of the scheduled command fails with an error.
loglocation destination     The flash destination for scheduled command output files.
Guidelines
Log files created by the command are stored in the flash:/schedule/scheduled_name/ directory. Empty log files are created for commands that do not generate any output.
Examples
This command saves the running configuration contents to the log file every hour with immediate effect and creates a maximum of 24 log files.
switch(config)#schedule backup-test interval 60 max-log-files 24 command show running-config
This command starts the script execution at 12:00:00 and repeats every 720 minutes. The script execution is terminated if it exceeds 20 minutes. It generates a maximum of one log file because the specified bash command does not have an output.
switch(config)#schedule ms1 at 12:00:00 interval 720 timeout 20 max-log-files 1 command bash /mnt/flash/myscript.sh
The show schedule command lists the commands currently scheduled for periodic execution and displays the summary of the specified scheduled command.
switch#show schedule summary
Maximum concurrent jobs  1
Prepend host name to logfile: Yes
Name  At time Last    Interval  Timeout   Max   Logfile Location      Status
              time    (mins)    (mins)    log    
                                         files
---- ------- ------- --------- -------- ------ --------------------- -------
ms1   now     23:03    720       20        1    flash:/schedule/ms1   Success
switch#
schedule config
The schedule config command sets configuration parameters to the CLI scheduler.
The no schedule config max-concurrent-jobs and default schedule config max-concurrent-jobs commands reset the limit of maximum concurrent jobs to the default value of 1 by removing the corresponding schedule config max-concurrent-jobs statement from running-config.
The no schedule config prepend-hostname-logfile and default schedule config prepend-hostname-logfile commands reset the log filenames to the default state.
Command Mode
Global Configuration
Command Syntax
schedule config {max-concurrent-jobs limit | prepend-hostname-logfile}
no schedule config {max-concurrent-jobs limit | prepend-hostname-logfile}
default schedule config {max-concurrent-jobs limit | prepend-hostname-logfile}
Parameters
max-concurrent-job limit     specifies the maximum number of concurrent commands that can run on the switch. The maximum concurrent jobs ranges from 1 to 4. The default value is 1.
prepend-hostname-logfile     enables prepending hostnames to log filenames. By default, this option is enabled.
Examples
This command configures to concurrently run a maximum of three commands on the switch.
switch(config)#schedule config max-concurrent-jobs 3
switch(config)#show schedule summary
Maximum concurrent jobs  3
Prepend host name to logfile: No
Name            At time      Last    Interval   Timeout   Max     Logfile Location               Status
                             time     (mins)    (mins)    log
                                                         files
------------- ------------- ------- ---------- -------- -------- ------------------------------- ------
tech-support      now        00:29      60        30      100     flash:schedule/tech-support/   Success
thelp           12:02:00     00:02      60        40      100     flash:schedule/thelp/          Fail
                06/05/2018
switch(config)#
This command enables prepending the hostname to log filenames.
switch(config)#schedule config prepend-hostname-logfile
switch(config)#show schedule summary
Maximum concurrent jobs  3
Prepend host name to logfile: Yes
Name            At time      Last    Interval   Timeout   Max     Logfile Location               Status
                             time     (mins)    (mins)    log
                                                         files
------------- ------------- ------- ---------- -------- -------- ------------------------------- ------
tech-support      now        00:29      60        30      100     flash:schedule/tech-support/   Success
thelp           12:02:00     00:02      60        40      100     flash:schedule/thelp/          Fail
                06/05/2018
switch(config)#
show (various configuration modes)
The show command, when executed within a configuration mode, can display data in running-config for the active configuration mode.
Command Mode
All configuration modes except Global Configuration
Command Syntax
show [DATA_TYPE]
Parameters
DATA_TYPE     Specifies display contents. Values include:
active     Displays running-config settings for the configuration mode.
active all     Displays running-config plus defaults for the configuration mode.
active all detail     Displays running-config plus defaults for the configuration mode.
comment     Displays comment entered for the configuration mode.
Related Commands
The show commands in ACL-configuration mode and MST-configuration mode include the active and comment options along with additional mode-specific options.
Example
This command shows the server-group-TACACS+ configuration commands in running-config.
switch(config-sg-tacacs+-TAC-GR)#show active
   server TAC-1
   server 10.1.4.14
switch(config-sg-tacacs+-TAC-GR)#
show event-handler
The show event-handler command displays the contents and activation history of a specified event handler or all event handlers.
Command Mode
Privileged EXEC
Command Syntax
show event-handler [handler_name]
Parameters
handler_name     optional name of an event handler to display. If no parameter is entered, the command displays information for all event handlers configured on the system.
Example
This command displays information about an event handler called “eth_5”.
switch#show event-handler Eth_5
Event-handler Eth_5
Trigger: on-intf Ethernet5 on ip delay 20 seconds
Threshold Time Window: 0 Seconds, Event Count: 1 times
Action: :
Device-health Action: None
Action expected to finish in less than 10 seconds
Last Trigger Detection Time: 15 days 2 hours 19 minutes ago
Total Trigger Detections: 1
Last Trigger Activation Time: 15 days 2 hours 19 minutes ago
Total Trigger Activations: 1
Last Action Time: 15 days 2 hours 19 minutes ago
Total Actions: 1
switch#
show event-handler DropCountersHandler
The show event-handler command displays details of the DropCountersHandler event handler.
Command Mode
Privileged EXEC
Command Syntax
show event-handler DropCountersHandler
Example
This command displays details of this event handler.
switch(config)#show event-handler DropCountersHandler
Event-handler DropCountersHandler (BUILT-IN)
Trigger: on-counters delay 0 seconds
  Polling Interval: 60 seconds
  Condition: bashCmd."DropCounterMonitor.py" > 0
Threshold Time Window: 0 Seconds, Event Count: 1 times
Action: DropCounterLog.py -l
Action expected to finish in less than 20 seconds
Total Polls: 39
Last Trigger Detection Time: 38 minutes 22 seconds ago
Total Trigger Detections: 1
Last Trigger Activation Time: 38 minutes 22 seconds ago
Total Trigger Activations: 1
Last Action Time: Never
Total Actions: 1
 
switch(config)#
show module
The show module command displays information that identifies the supervisor, fabric, and linecard modules in a modular switch, including model number, serial number, hardware version number, software version (supervisors only), MAC address (supervisors and linecards), and operational status.
Command Mode
EXEC
Command Syntax
show module [MODULE_NAME]
Parameters
MODULE_NAME      Specifies modules for which data is displayed. Options include:
<no parameter>      All modules (identical to all option).
fabric fab_num      Specified fabric module. Number range varies with switch model.
linecard line_num      Linecard module. Number range varies with switch model.
supervisor super_num      Supervisor module. Number range varies with switch model.
mod_num      Supervisor (1 to 2) or linecard (3 to 18) module.
all      All modules.
Related Commands
show version displays model and serial numbers of modular system components.
Example
This command displays information about all installed modules on a DCS-7504 switch.
switch#show module
Module    Ports Card Type                            Model           Serial No.
--------- ----- ------------------------------------ --------------- -----------
1         2     DCS-7500 Series Supervisor Module    7500-SUP        JSH11440327
2         1     Standby supervisor                   Unknown         Unknown
3         48    48-port SFP+ 10GigE Linecard         7548S-LC        JSH10315938
4         48    48-port SFP+ 10GigE Linecard         7548S-LC        JSH11665247
5         48    48-port SFP+ 10GigE Linecard         7548S-LC        JSH11834614
6         48    48-port SFP+ 10GigE Linecard         7548S-LC        JSH11060688
Fabric1   0     DCS-7504 Fabric Module               7504-FM         JSH11244430
Fabric2   0     DCS-7504 Fabric Module               7504-FM         JSH11892120
Fabric3   0     DCS-7504 Fabric Module               7504-FM         JSH11941115
Fabric4   0     DCS-7504 Fabric Module               7504-FM         JSH11661618
Fabric5   0     DCS-7504 Fabric Module               7504-FM         JSH11757555
Fabric6   0     DCS-7504 Fabric Module               7504-FM         JSH11847728
 
Module    MAC addresses                          Hw      Sw      Status
--------- -------------------------------------- ------- ------- -------
1         00:1c:23:03:06:ac - 00:1c:23:03:06:ac  07.06   4.12.1  Active
2                                                        4.12.1  Standby
3         00:1c:23:03:80:44 - 00:1c:23:03:80:73  06.00           Ok
4         00:1c:23:03:e4:34 - 00:1c:23:03:e4:63  07.10           Ok
5         00:1c:23:12:0b:3f - 00:1c:23:12:0b:6e  07.30           Ok
6         00:1c:23:12:b6:3f - 00:1c:23:12:b6:6e  08.00           Ok
Fabric1                                          05.03           Ok
Fabric2                                          05.03           Ok
Fabric3                                          05.02           Ok
Fabric4                                          05.02           Ok
Fabric5                                          05.02           Ok
Fabric6                                          05.02           Ok
switch#
This command displays information about all installed modules on a DCS-7304 switch.
switch#show module
Module    Ports Card Type                            Model           Serial No.
--------- ----- ------------------------------------ --------------- -----------
1         3     Supervisor 7300X SSD                 DCS-7300-SUP-D  JAS13340024
3         128   32 port 40GbE QSFP+ LC               7300X-32Q-LC    JPE13440416
4         64    48 port 10GbE SFP+ & 4 port QSFP+ LC 7300X-64S-LC    JAS13310113
5         64    48 port 10GbE SFP+ & 4 port QSFP+ LC 7300X-64S-LC    JAS13340033
6         64    48 port 10GbE SFP+ & 4 port QSFP+ LC 7300X-64S-LC    JAS13310103
Fabric1   0     7304X Fabric Module                  7304X-FM        JAS13320077
Fabric2   0     7304X Fabric Module                  7304X-FM        JAS13350043
Fabric3   0     7304X Fabric Module                  7304X-FM        JAS13350050
Fabric4   0     7304X Fabric Module                  7304X-FM        JAS13350056
 
Module    MAC addresses                          Hw      Sw      Status
--------- -------------------------------------- ------- ------- -------
1         00:1c:73:36:4b:71 - 00:1c:73:36:4b:72  01.01   4.13.3F Active
3         00:1c:73:58:d4:68 - 00:1c:73:58:d4:87  03.04           Ok
4         00:1c:73:36:05:61 - 00:1c:73:36:05:94  02.02           Ok
5         00:1c:73:36:0a:e1 - 00:1c:73:36:0b:14  02.03           Ok
6         00:1c:73:36:02:e1 - 00:1c:73:36:03:14  02.02           Ok
Fabric1                                          00.00           Ok
Fabric2                                          00.00           Ok
Fabric3                                          00.00           Ok
Fabric4                                          00.00           Ok
switch#
show platform sand compatibility
The show sand platform compatibility command displays the fabric and forwarding modes. These modes determine switch forwarding capabilities and programs performance capacity of installed linecards
sinformation that identifies the supervisor, fabric, and linecard modules in the modular switch, including model number, serial number, hardware version number, software version (supervisors only), MAC address (supervisors and linecards), and operational status.
Command Mode
Privileged EXEC
Command Syntax
show platform sand compatibility
Related Commands
platform sand fabric mode (7500 and 7500E Series) specifes the fabric software mode.
platform sand forwarding mode (7500 and 7500E Series) specifes the forwarding software mode.
Example
This command indicates that the switch is in Fe600 fabric mode and PetraA forwarding mode.
switch#show platform sand compatibility
                     Configuration        Status
Forwarding mode      None                 PetraA
Fabric mode          None                 Fe600
switch#
show platform sand lag hardware-only
The show platform sand lag hardware-only command displays whether or not LAGs are hardware-only.
Command Mode
Privileged EXEC
Command Syntax
show platform sand lag hardware-only
Examples
This command indicates that LAGs are hardware-only.
switch(config)#platform sand lag hardware-only
switch(config)#exit
switch#show platform sand lag hardware-only
Hardware resources are used for all LAGs: True
switch#
This command indicates that LAGs are not hardware-only.
switch(config)#no platform sand lag hardware-only
switch(config)#exit
switch#show platform sand lag hardware-only
Hardware resources are used for all LAGs: False
switch#
show schedule
The show schedule command displays logging output on the terminal during the current terminal session. This command affects only the local monitor. The no terminal monitor command disables direct monitor display of logging output for the current terminal session.
The show schedule command displays the list of active scheduled commands and the summary of specified scheduled command.
Command Mode
Global Configuration
Command Syntax
show schedule {schedule_name | summary}
Parameters
schedule_name     displays the summary of the specified scheduled command
summary     displays the list of active scheduled commands
Examples
This command displays the summary of the “thelp” schedule.
switch(config)#show schedule thelp
The last CLI command failed with exit status 1
CLI command "show THelp" is scheduled next at "02:02:35 06/19/2018", interval is 60 minutes
Timeout is 40 minutes
Maximum of 100 log files will be stored
Verbose logging is off
100 log files currently stored in flash:/schedule/thelp
 
Start time                 Size          Filename
----------------------- ---------------- ----------------------------------
Jun 19 2018 01:02       60.0 bytes       ro301_thelp_2018-06-19.0102.log.gz
Jun 19 2018 00:02       60.0 bytes       ro301_thelp_2018-06-19.0002.log.gz
Jun 18 2018 23:02       60.0 bytes       ro301_thelp_2018-06-18.2302.log.gz
Jun 18 2018 22:02       60.0 bytes       ro301_thelp_2018-06-18.2202.log.gz
Jun 18 2018 21:02       60.0 bytes       ro301_thelp_2018-06-18.2102.log.gz
<-------OUTPUT OMITTED FROM EXAMPLE--------> 
switch(config)#
This command displays the summary of scheduled commands.
switch(config)#show schedule summary
Maximum concurrent jobs  1
Prepend host name to logfile: Yes
Name            At time      Last    Interval   Timeout   Max     Logfile Location               Status
                             time     (mins)    (mins)    log
                                                         files
------------- ------------- ------- ---------- -------- -------- ------------------------------- ------
tech-support      now        00:29      60        30      100     flash:schedule/tech-support/   Success
thelp           12:02:00     00:02      60        40      100     flash:schedule/thelp/          Fail
                06/05/2018
switch(config)#
 
show version
The show version command displays information that identifies the switch, including its model number, serial number, and system MAC address. The command also provides hardware and software manufacturing information, along with the available memory and elapsed time from the most recent reload procedure.
Command Mode
EXEC
Command Syntax
show version [INFO_LEVEL]
Parameters
INFO_LEVEL     Specifies information the command displays. Options include
<no parameter>      Model and serial numbers, manufacturing data, uptime, and memory.
detail     Data listed <no parameter> option plus version numbers of internal components.
Related Commands
show module displays model and serial numbers of modular system components.
Examples
This command displays the switch’s model number, serial number, hardware and software manufacturing information, uptime, and memory capacity,
switch>show version
Arista DCS-7150S-64-CL-F
Hardware version:    01.01
Serial number:       JPE13120819
System MAC address:  001c.7326.fd0c
 
Software image version: 4.13.2F
Architecture:           i386
Internal build version: 4.13.2F-1649184.4132F.2
Internal build ID:      eeb3c212-b4bd-4c19-ba34-1b0aa36e43f1
 
Uptime:                 1 hour and 36 minutes
Total memory:           4017088 kB
Free memory:            1473280 kB
 
switch>
terminal length
The terminal length command overrides automatic pagination and sets pagination length for all show commands on a terminal. If the output of a show command is longer than the configured terminal length, the output will be paused after each screenful of output, prompting the user to continue.
To disable pagination for an SSH session, set terminal length to 0. By default, all console sessions have pagination disabled.
The no terminal length and default terminal length commands restore automatic pagination by removing the terminal length command from running-config.
The pagination setting is persistent if configured from Global Configuration mode. If configured from EXEC mode, the setting applies only to the current CLI session. Pagination settings may also be overridden when you adjust the size of the SSH terminal window, but can be reconfigured by running the terminal length command again.
Command Mode
EXEC
Command Syntax
terminal length lines
no terminal length
default terminal length
Parameters
lines     number of lines to be displayed at a time. Values range from 0 through 32767. A value of 0 disables pagination.
Example
This command sets the pagination length for the current terminal session to 10 lines.
switch#terminal length 10
Pagination set to 10 lines.
This command configures the switch to paginate terminal output automatically based on screen size for the current terminal session.
switch#no terminal length
These commands disable pagination globally.
switch#configure
switch(config)#terminal length 0
Pagination disabled.
terminal monitor
The terminal monitor command enables the display of logging output on the terminal during the current terminal session. This command affects only the local monitor. The no terminal monitor command disables direct monitor display of logging output for the current terminal session.
Command Mode
Privileged EXEC
Command Syntax
terminal monitor
no terminal monitor
default terminal monitor
Example
This command enables the display of logging to the local monitor during the current terminal session.
switch#terminal monitor
switch#
trigger
The trigger command specifies what event will trigger the event handler. Handlers can be triggered either by the system booting or by a change in a specified interface’s IP address or operational status.
To specify the action to be taken when the handler is triggered, use the action bash command.
Command Mode
Event-Handler Configuration
Command Syntax
trigger EVENT
Parameters
EVENT     event which will trigger the configuration mode event handler. Values include:
onboot     triggers when the system reboots, or when you exit event-handler configuration mode. This option takes no further arguments, and passes no environment variables to the action triggered.
on-intf INTERFACE CHANGE     triggers when a change is made to the specified interface.
on-startup-config     triggers when a change is made to the startup-config file.
vm-tracer vm     triggers when a virtual machine monitored by VM Tracer changes state.
INTERFACE     the triggering interface. Values include:
ethernet number     Ethernet interface specified by number.
loopback number     loopback interface specified by number.
management number     management interface specified by number.
port-channel number     channel group interface specified by number.
vlan numver     VLAN interface specified by number.
CHANGE     the change being watched for in the triggering interface. Values include:
ip     triggers when the IPv4 address of the specified interface is changed.
ip6     triggers when the IPv6 address of the specified interface is changed.
operstatus     triggers when the operational status of the specified interface changes.
Examples
This command configures the event handler “Eth5” to be triggered when there is a change in the operational status or IP address of Ethernet interface 5.
switch(config-handler-Eth5)#trigger on-intf Ethernet 5 operstatus ip
switch(config-handler-Eth5)#
This command configures the event handler “onStartup” to be triggered when the system boots, or on exiting event-handler configuration mode.
switch(config-handler-onStartup)#trigger onboot
switch(config-handler-onStartup)#