E Commands
This chapter describes the Cisco Nexus 1000V commands that begin with the letter, E.
echo
To echo an argument back to the terminal screen, use the echo command.
echo [ backslash-interpret ] [ text ]
Syntax Description
-e |
(Optional) Interprets any character following a backslash character (\) as a formatting option. |
backslash-interpret |
(Optional) Interprets any character following a backslash character (\) as a formatting option. |
text |
(Optional) Text string to display. The text string is alphanumeric, case sensitive, can contain spaces, and has a maximum length of 200 characters. The text string can also contain references to CLI variables. |
Defaults
Displays a blank line.
Command Modes
Any
network-admin
Command History
|
|
4.0(4)SV1(1) |
This command was introduced. |
Usage Guidelines
You can use this command in a command script to display information while the script is running.
Table 5-1 lists the formatting keywords that you can insert in the text when you include the -e or backslash-interpret keyword.
Table 5-1 Formatting Options for the echo Command
|
|
\b |
Back spaces. |
\c |
Removes the new line character at the end of the text string. |
\f |
Inserts a form feed character. |
\n |
Inserts a new line character. |
\r |
Returns to the beginning of the text line. |
\t |
Inserts a horizontal tab character. |
\v |
Inserts a vertical tab character. |
\\ |
Displays a backslash character. |
\ nnn |
Displays the corresponding ASCII octal character. |
Examples
This example shows how to display a blank line at the command prompt:
This example shows how to display a line of text at the command prompt:
n1000v# echo Script run at $(TIMESTAMP).
Script run at 2008-08-12-23.29.24.
This example shows how to use a formatting option in the text string:
n1000v# echo backslash-interpret This is line #1. \nThis is line #2.
Related Commands
|
|
run-script |
Runs command scripts. |
encapsulation dot1q vlan id bridge-domain
Creates a VLAN-VXLAN mapping on the service module.
encapsulation dot1q vlan id bridge-domain[bd-name]
Syntax Description
vlan id |
The range is from 1 - 4094. |
bd-name |
Name of the bridge-domain. |
Command Modes
Port-profile configuration (config-port-prof-srv)
network-admin
Command History
|
|
4.2(1)SV2(2.1) |
This command was introduced. |
Usage Guidelines
Use this command to create a VLAN-VXLAN mapping on an attached service module.
Examples
This example shows how to create mappings:
n1000v(config)# port-profile type vethernet Uplink-All-VXGW
n1000v(config-port-prof)# switchport mode access
n1000v(config-port-prof)# switchport access bridge-domain bd-701
n1000v(config-port-prof)# service instance 10
n1000v(config-port-prof-srv)# encapsulation dot1q 600 bridge-domain bd-600
n1000v(config-port-prof-srv)# encapsulation dot1q 601 bridge-domain bd-601
n1000v(config-port-prof-srv)# encapsulation dot1q 602 bridge-domain bd-602
n1000v(config-port-prof-srv)# no shutdown
n1000v(config-port-prof-srv)# state enabled
n1000v(config-port-prof)# end
This example shows how to remove mappings:
n1000v(config)# port-profile type vethernet Uplink-All-VXGW
n1000v(config-port-prof)# switchport mode access
n1000v(config-port-prof)# switchport access bridge-domain bd-701
n1000v(config-port-prof)# service instance 10
n1000v(config-port-prof-srv)# no encapsulation dot1q 600 bridge-domain bd-600
n1000v(config-port-prof-srv)# no encapsulation dot1q 601 bridge-domain bd-601
n1000v(config-port-prof-srv)# no encapsulation dot1q 602 bridge-domain bd-602
n1000v(config-port-prof-srv)# no shutdown
n1000v(config-port-prof-srv)# state enabled
n1000v(config-port-prof)# end
end
To exit a configuration mode and return to Privileged EXEC mode, use the end command.
end
Syntax Description
This command has no arguments or keywords.
Command Modes
Any
network-admin
network-operator
Command History
|
|
4.0(4)SV1(1) |
This command was introduced. |
Usage Guidelines
This command differs from the exit command in that the exit command returns you to the configuration mode you were previously in. The end command always takes you completely out of configuration mode and places you in privileged EXEC mode.
Examples
This example shows how to end the session in Global Configuration mode and return to privileged EXEC mode:
This example shows how to end the session in Interface Configuration mode and return to privileged EXEC mode:
Related Commands
|
|
exit |
Exits the current command mode and returns you to the previous command mode. |
errdisable detect cause
To detect the reason an interface is error-disabled, use the errdisable detect cause command. To stop error detection, use the no form of this command.
errdisable detect cause { acl-exception | all | link-flap | loopback | arp-inspection | dhcp-rate-limit | qos-exception}
no errdisable detect cause { acl-exception | all | link-flap | loopback | arp-inspection | dhcp-rate-limit | qos-exception}
Syntax Description
acl- exception |
Enables error-disabled detection for access-list installation failures. |
all |
Enables error-disabled detection on all causes. |
link-flap |
Enables error-disabled disable detection on link-state flapping. |
loopback |
Enables error-disabled detection on a loopback. |
arp-inspection |
Enables error-disabled detection on arp-inspection. |
dhcp-rate-limit |
Enables error-disabled detection on dhcp-rate-limit. |
qos-exception |
Enables error-disabled detection on qos-exception. |
Command Modes
Global configuration (config)
network-admin
Command History
|
|
4.0(4)SV1(2) |
This command was introduced. |
Usage Guidelines
The error-disabled state is an operational state that is similar to the link-down state. You must enter the shutdown command and then the no shutdown command to recover an interface manually from the error-disabled state.
Examples
This example shows how to detect the cause of the error-disabled state for all applications:
n1000v(config)# errdisable detect cause all
Related Commands
|
|
shutdown |
Brings the port down administratively. |
no shutdown |
Brings the port up administratively. |
show interface status err-disabled |
Displays the interfaces currently in the error-disabled state. |
errdisable recovery cause
To enable the automatic recovery from the error-disabled (errdisable) state for an application, use the errdisable recovery cause command. To return to the default setting, use the no form of this command.
errdisable recovery cause { all | arp-inspection | bpduguard | dhcp-rate-limit | link-flap | failed-port-state | psecure-violation | security-violation | storm-control | udld | vpc-peerlink }
no errdisable recovery cause { all | arp-inspection | bpduguard | dhcp-rate-limit | link-flap | psecure-violation | security-violation | storm-control | udld | vpc-peerlink }
Syntax Description
all |
Enables automatic recovery from all causes for the error-disabled state. |
arp-inspection |
Enables automatic recovery from the ARP inspection error state. |
bpduguard |
Enables automatic recovery from BPDU Guard error-disabled state. |
dhcp-rate-limit |
Enables automatic recovery from the DHCP rate-limit error state. |
link-flap |
Enables automatic recovery from link-state flapping. |
failed-port-state |
Enables timer automatic recovery from the Spanning Tree Protocol (STP) set port state failure. |
psecure-violation |
Enables timer automatic recovery from the psecure violation disable state. |
security-violation |
Enables automatic recovery from the 802.1X violation disable state. |
storm-control |
Enables automatic recovery from the storm control error-disabled state. |
udld |
Enables automatic recovery from the UDLD error-disabled state. |
vpc-peerlink |
Enables automatic recovery from an inconsistent virtual port channel (vPC) peer-link error-disabled state. |
Command Modes
Global configuration (config)
network-admin
Command History
|
|
4.0(4)SV1(2) |
This command was introduced. |
Usage Guidelines
Use the errdisable recovery cause command to enable automatic recovery on the interface from the error-disabled state for an application. This command tries to bring the interface out of the error-disabled state and retry operation once all the causes have timed out. The interface automatically tries to come up again after 300 seconds. To change this interval, use the errdisable recovery interval command.
Examples
This example shows how to automatically recover from the error-disabled state for link flapping after you have enabled the recovery timer:
n1000v(config)# errdisable recovery cause link-flap
Related Commands
|
|
errdisable recovery interval |
Enables the recovery timer. |
show interface status err-disabled |
Displays the interface error-disabled state. |
errdisable recovery interval
To enable the recovery timer, use the errdisable recovery interval command.
errdisable recovery interval interval
Syntax Description
interval |
Error detection for access-list installation failures. The range is from 30 to 65535. |
Command Default
300 seconds
Command Modes
Global configuration (config)
network-admin
Command History
|
|
4.0(4)SV1(2) |
This command was introduced. |
Usage Guidelines
Use the errdisable recovery interval command to configure the recovery timer.
Examples
This example shows how to configure the recovery timer:
n1000v(config)# errdisable recovery interval 32
Related Commands
|
|
errdisable recovery cause |
Enables the error-disabled recovery for an application. |
show interface status err-disabled |
Displays the interface error-disabled state. |
erspan-id
To add an Encapsulated Remote Switch Port Analyzer (ERSPAN) ID to the session configuration and save it in the running configuration, use the erspan-id command.
erspan-id flow_id
Syntax Description
flow_id |
Flow ID to be assigned to the ERSPAN session. The range is 1–1023. |
Command Modes
CLI ERSPAN source configuration (config-erspan-src)
network-admin
Command History
|
|
4.0(4)SV1(1) |
This command was introduced. |
Usage Guidelines
The session ERSPAN ID is added to the ERSPAN header of the encapsulated frame and can be used at the termination box to differentiate between various ERSPAN streams of traffic.
Examples
This example shows how to add ERSPAN ID 51 to the session configuration and save it in the running configuration:
n1000v(config)# monitor session type erspan-source
n1000v(config-erspan-src)# erspan_id 51
n1000v(config-erspan-src)#
Related Commands
|
|
monitor session type erspan-source |
Creates a session with the given session number and puts you in the CLI ERSPAN source configuration mode. |
source |
For the specified session, configures the source and the direction of traffic to monitor, and saves this information in the running configuration. |
filter vlan |
For the specified ERSPAN session, configures the VLANs, VLAN lists, or VLAN ranges to be monitored. |
ip ttl |
Specifies the IP time-to-live value for the packets in the ERSPAN traffic. |
ip prec |
Specifies the IP precedence value for the packets in the ERSPAN traffic. |
mtu |
Specifies a maximum transmission unit (MTU) size for the ERSPAN traffic. |
show monitor session |
Displays the ERSPAN session configuration as it exists in the running configuration. |
ethanalyzer local read
To decode and display packet information from a file, use the ethanalyzer local read command.
ethanalyzer local read filename
Syntax Description
filename |
Specifies the file name. |
Command Modes
Global configuration (config)
network-admin
Command History
|
|
4.2(1)SV1(4.0) |
This command was introduced. |
Examples
This example shows how to capture and display packets from a file:
1000v# ethanalyzer local read bootflash:packet.log
2010-06-08 16:06:20.791442 00:50:56:b5:00:3b -> ff:ff:ff:ff:ff:ff LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
2010-06-08 16:06:20.793056 00:02:3d:40:71:41 -> 00:50:56:b5:00:3b LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
2010-06-08 16:06:20.793130 00:02:3d:40:71:03 -> 00:50:56:b5:00:3b LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
2010-06-08 16:06:20.793243 00:50:56:b5:00:3b -> 00:02:3d:40:71:41 LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
2010-06-08 16:06:20.793292 00:50:56:b5:00:3b -> 00:02:3d:40:71:03 LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
2010-06-08 16:06:20.811147 00:50:56:b5:00:3b -> ff:ff:ff:ff:ff:ff LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
2010-06-08 16:06:21.279679 00:15:c6:49:2f:32 -> 01:00:0c:cc:cc:cd STP Conf. Root = 32818/00:0b:45:b6:e2:00 Cost = 6
2010-06-08 16:06:21.781290 00:50:56:b5:00:3b -> ff:ff:ff:ff:ff:ff LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
2010-06-08 16:06:21.782961 00:02:3d:40:71:41 -> 00:50:56:b5:00:3b LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
2010-06-08 16:06:21.782965 00:02:3d:40:71:03 -> 00:50:56:b5:00:3b LLC U, func=UI; SNAP, OUI 0x00000C (Cisco), PID 0x0132
Related Commands
|
|
ethanalyzer local sniff-interface |
Captures packet on a given interface. |
ethanalyzer local sniff-interface
To capture packets on a given interface, use the ethanalyzer local sniff-interface command.
ethanalyzer local sniff-interface {control | inband | management| ha-primary|ha-secondary} [capture-filter | detailed-dissection |display-filter| dump-pkt| limit-captured-frames| limit-frame-size| write filename ]
Syntax Description
control |
The packets are captured on the control interface. |
inband |
The packets are captured on the packet interface. |
management |
The packets are captured on the management interface. |
ha-primary |
The packets are captures on the primary HA interface. |
ha-secondary |
The packets are captures on the secondary HA interface. |
capture-filter |
Filters the types of packets to capture. |
detailed-dissection |
Displays detailed protocol information |
display-filter |
Filters the types of captured packets to display. |
dump-pkt |
Dump the packet in HEX/ASCII |
limit-captured-frames |
Limits the number of frames to capture. |
limit-frame-size |
Limits the length of the frame to capture. |
write filename |
Saves the captured data to a file. |
Command Modes
Global configuration (config)
network-admin
Command History
|
|
4.2(1)SV1(4.0) |
This command was introduced. |
Examples
This example shows how to capture and decode packets:
n1000v# ethanalyzer local sniff-interface control write bootflash:packet.log
Related Commands
|
|
ethanalyzer local read |
Captures and diaplayes packet information from a file. |
exec-timeout
To configure the length of time, in minutes, that an inactive Telnet or SSH session remains open before it is automatically shut down, use the exec-timeout command. To remove an exec timeout setting, use the no form of this command.
exec-timeout time
no exec-timeout [ time ]
Syntax Description
time |
Timeout time, in minutes. The range of valid values is 0 to 525600. If a session remains inactive longer than this specified time period, then it is automatically closed. |
Defaults
No timeout is configured.
Command Modes
Console configuration (config-console)
network-admin
Command History
|
|
4.0(4)SV1(1) |
This command was introduced. |
Usage Guidelines
When you set time to 0, exec timeout is disabled.
Examples
This example shows how to configure an inactive session timeout for the console port:
n1000v# configure terminal
n1000v(config)# line console
n1000v(config-com1)# exec-timeout 20
This example shows how to configure an inactive session timeout for the virtual terminal:
n1000v# configure terminal
n1000v(config-line)# exec-timeout 20
This example shows how to remove an exec timeout on the console port:
n1000v# configure terminal
DocTeamVSM(config)# line console
n1000v(
config-console)#
no exec-timeout
Related Commands
|
|
show terminal |
Displays the terminal configuration, including the timeout value. |
show users |
Displays the currently active user sessions. |
exit
To exit a configuration mode or exit the CLI, use the exit command.
exit
Syntax Description
This command has no arguments or keywords.
Command Modes
Any
network-admin
network-operator
Command History
|
|
4.0(4)SV1(1) |
This command was introduced. |
Examples
This example shows how to exit global configuration mode. The CLI returns you to the EXEC mode.
This example shows how to exit interface configuration mode. The CLI returns you to the global configuration mode.
This example shows how to exit the CLI.
Related Commands
|
|
end |
Returns to the EXEC command mode. |
exporter
To add an existing flow exporter to a specific flow monitor and save it in the running configuration, use the exporter command. To remove the flow exporter for a specific flow monitor, use the no form of this command.
exporter name
no exporter name
Syntax Description
name |
Name of the flow exporter to be added for the flow monitor. |
Command Modes
CLI flow monitor configuration (config-flow-monitor)
network-admin
Command History
|
|
4.0(4)SV1(1) |
This command was introduced. |
Examples
This example shows how to add the flow exporter called Exportv9 and save it in the running configuration:
n1000v(config)# flow monitor MonitorTest
n1000v(config-flow-monitor)# exporter Exportv9
n1000v(config-flow-monitor)#
This example shows how to remove the flow exporter called Exportv9:
n1000v(config)# flow monitor MonitorTest
n1000v(config-flow-monitor)# no exporter Exportv9
n1000v(config-flow-monitor)#
Related Commands
|
|
flow monitor |
Creates a flow monitor, by name, saves it in the running configuration, and then puts you in the CLI flow monitor configuration mode. |
description |
Adds a descriptive string for the specified flow monitor and saves it in the running configuration. |
exporter |
Adds an existing flow exporter for the specified monitor and saves it in the running configuration. |
record |
Adds an existing flow record for the specified monitor and saves it in the running configuration. |
timeout |
Specifies, for the specified monitor, an aging timer and its value for aging entries from the cache, and saves them in the running configuration. |
cache |
Specifies the cache size for the specified monitor and saves it in the running configuration. |