E Commands

This chapter describes the Cisco Nexus 1000V commands that begin with 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

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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

Formatting Option
Description

\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:

n1000v# echo
 

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.
This is line #1.
This is line #2.
 

 
Related Commands

Command
Description

run-script

Runs command scripts.

ecp max retries

To configure the number of times ECP retries sending an upper layer protocol message, use the ecp max retries command. Use the no form of this command to revert to the default value.

ecp max retries < value>

[no] ecp max retries

 
Syntax Description

<value>

The range is from 1-7. The no form of this command resets this value to the default.

 
Defaults

The default value is 3.

 
Command Modes

Any

 
Supported User Roles

network-admin

 
Command History

Release
Modification

4.2(1)SV2(2.2)

This command was introduced.

 
Usage Guidelines

This command is optional. Use this command only if you want to reconfigure the number of times ECP should retry sending a protocol message to a non default value.

 
Related Commands

Command
Description

ecp retransmission-timer-exponent

Configures the exponential value of the interval for which ECP waits before trying to retransmit the packet.

evb resource-wait-delay

Configures the resource wait delay used by VDP to calculate the time it waits before concluding that a request has timed out.

evb reinit-keep-alive

Configures the interval at which VDP refreshes the VSI state with in the bridge by sending a VDP associate refresh.

ecp retransmission-timer-exponent

To configure the exponential value of the interval for which ECP waits before trying to retransmit a packet, use the ecp retransmission-timer-exponent command. U se the no form of this command to revert to the default value.

ecp retransmission-timer-exponent command < value>

[no] ecp retransmission-timer-exponent command

 
Syntax Description

<value>

The range is from 10-20. The no form of this command resets this value to to the default.

 
Defaults

The default value is 14.

 
Command Modes

Any

 
Supported User Roles

network-admin

 
Command History

Release
Modification

4.2(1)SV2(2.2)

This command was introduced.

 
Usage Guidelines

This command is optional. Use this command only if you want to specify a non-default value for the ecp retransmission timer.

 
Related Commands

Command
Description

ecp max-retries

Configures the number of times ECP retries to send an upper layer protocol message.

evb resource-wait-delay

Configures the resource wait delay used by VDP to calculate the time it waits before concluding that a request has timed out.

evb reinit-keep-alive

Configures the interval at which VDP refreshes the VSI state with in the bridge by sending a VDP associate refresh.

enable l3sec

To enable feature l3security in Layer 3, use the enable l3sec command.

enable l3sec

 
Syntax Description

Command to enable Layer 3 security.

 
Defaults

None

 
Command Modes

svs-domain

 
Supported User Roles

network-admin

 
Command History

Release
Modification

5.2(1)SV3(1.1)

This command was introduced.

 
Usage Guidelines

None.

Examples

This example shows how to enable feature l3security in Layer 3:

switch(config)# svs-domain
switch(config-svs-domain)# enable l3sec
Enabling l3sec enables stronger security for VSM-VEM communication.But all vems will get disconnect and connect back. Do you really want to proceed(yes/no)? [no] yes
switch(config-svs-domain)#
 

 
Related Commands

Command
Description

no enable l3sec

Command to disable Layer 3 security.

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.

 
Defaults

None.

 
Command Modes

Port-profile configuration (config-port-prof-srv)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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 t
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 t
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
 

 
Related Commands

None.

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.

 
Defaults

None

 
Command Modes

Any

 
Supported User Roles

network-admin
network-operator

 
Command History

Release
Modification

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:

n1000v(config)# end
n1000v#
 

This example shows how to end the session in Interface Configuration mode and return to privileged EXEC mode:

n1000v(config-if)# end
n1000v#
 

 
Related Commands

Command
Description

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 Default

Disabled

 
Command Modes

Global configuration (config)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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
n1000v(config)#

 
Related Commands

Command
Description

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 Default

Disabled

 
Command Modes

Global configuration (config)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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
n1000v(config)#

 
Related Commands

Command
Description

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)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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
n1000v(config)#

 
Related Commands

Command
Description

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.

 
Defaults

None

 
Command Modes

CLI ERSPAN source configuration (config-erspan-src)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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 t
n1000v(config)# monitor session type erspan-source
n1000v(config-erspan-src)# erspan_id 51
n1000v(config-erspan-src)#

 
Related Commands

Command
Description

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.

 
Defaults

None.

 
Command Modes

Global configuration (config)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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
Port = 0x8093
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

Command
Description

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.

 
Defaults

None.

 
Command Modes

Global configuration (config)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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
Capturing on eth0
10
n1000v#
 

 
Related Commands

Command
Description

ethanalyzer local read

Captures and diaplayes packet information from a file.

evb mac

To add the DMAC information for the ECP packets originating from the VDP station to blade-switches such as the UCS-FI and other similar network devices, use the evb mac command. Use the no form of this command to remove the DMAC information.

evb mac <mac address>

[no] evb mac

 
Syntax Description[no] evb mac

<mac address>

The rmac address.

Mac address.

 
Defaults

None.

 
Command Modes

Any

 
Supported User Roles

network-admin

 
Command History

Release
Modification

4.2(1)SV2(2.2)

This command was introduced.

 
Usage Guidelines

None.

Examples

This example shows the evb segmentation information:

switch (config)# show evb
Edge Virtual Bridging
Role : VDP Station
VDP Mac Address : 0180.0000.0000
VDP Resource Wait Delay : 22(66 secs)

VDP Reinit Keep Alive : 21(20 secs

 
Related Commands

Command
Description

show evb

Displays the configured MAC addresses.

evb reinit-keep-alive

Configures the interval at which VDP refreshes the VSI state with in the bridge by sending a VDP associate refresh.

evb resource-wait-delay

To configure the resource wait delay used by VDP to calculate the time it waits before concluding that a request has timed out, use the evb-resource-wait-delay command. Use the no form of this command to revert to the default value.

evb resource-wait-delay < value>

[no] evb resource-wait-delay

 
Syntax Description

<value>

The range is from 20-31. The no form of this command resets this value to the default.

 
Defaults

The default value is 20.

 
Command Modes

Any

 
Supported User Roles

network-admin

 
Command History

Release
Modification

4.2(1)SV2(2.2)

This command was introduced.

 
Usage Guidelines

None.

 
Related Commands

Command
Description

ecp retransmission-timer-exponent

Configures the exponential value of the interval for which ECP waits before trying to retransmit the packet.

ecp max-retries

Configures the number of times ECP will retry sending an upper layer protocol message.

evb reinit-keep-alive

Configures the interval at which VDP refreshes the VSI state with in the bridge by sending a VDP associate refresh.

evb reinit-keep-alive

To configure the interval at which VDP refreshes the VSI state in the bridge by sending a VDP associate refresh, use the evb reinit-keep-alive command. Use the no form of this command to revert to the default value.

evb reinit-keep-alive < 20-31>

[no] evb reinit-keep-alive

 
Syntax Description

<value>

The range is from 20-31. The no form of this command resets this value to the default.

 
Defaults

The default value is 20.

 
Command Modes

Any

 
Supported User Roles

network-admin

 
Command History

Release
Modification

4.2(1)SV2(2.2)

This command was introduced.

 
Usage Guidelines

None.

 
Related Commands

Command
Description

ecp retransmission-timer-exponent

Configures the exponential value of the interval for which ECP waits before trying to retransmit the packet.

evb resource-wait-delay

Configures the resource wait delay used by VDP to calculate the time it waits before concluding that a request has timed out.

ecp max-retries

Configures the number of times ECP will retry sending an upper layer protocol message.

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)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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 vty
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
n1000v(config-console)#
 

 
Related Commands

Command
Description

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.

 
Defaults

None

 
Command Modes

Any

 
Supported User Roles

network-admin
network-operator

 
Command History

Release
Modification

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.

n1000v(config)# exit
n1000v#
 

This example shows how to exit interface configuration mode. The CLI returns you to the global configuration mode.

n1000v(config-if)# exit
n1000v(config)#
 

This example shows how to exit the CLI.

n1000v# exit
 

 
Related Commands

Command
Description

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.

 
Defaults

None

 
Command Modes

CLI flow monitor configuration (config-flow-monitor)

 
Supported User Roles

network-admin

 
Command History

Release
Modification

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 t
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 t
n1000v(config)# flow monitor MonitorTest
n1000v(config-flow-monitor)# no exporter Exportv9
n1000v(config-flow-monitor)#
 

 
Related Commands

Command
Description

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.