E Commands

encapsulation dot1Q

To enable IEEE 802.1Q encapsulation of traffic on a specified subinterface in a virtual LAN (VLAN), use the encapsulation dot1q command. To disable encapsulation, use the no form of this command.

encapsulation dot1Q vlan-id

no encapsulation dot1Q vlan-id

Syntax Description

vlan-id

VLAN to set when the interface is in access mode. The range is from 1 to 4094 except for the VLANs reserved for internal switch use.

Command Default

No encapsulation

Command Modes

Subinterface configuration mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

IEEE 802.1Q encapsulation is configurable on Ethernet interfaces. IEEE 802.1Q is a standard protocol for interconnecting multiple switches and routers and for defining VLAN topologies.

Use the encapsulation dot1q command in subinterface range configuration mode to apply a VLAN ID to the subinterface.

This command does not require a license.

Examples

This example shows how to enable dot1Q encapsulation on a subinterface for VLAN 30:

switch(config-subif)# encapsulation dot1q 30

errdisable detect cause

To enable error-disabled (errdisable) detection for an application, use the errdisable detect cause command. To return to the default setting, use the no form of this command.

errdisable detect cause {acl-exception | all | link-flap | loopback}

no errdisable detect cause {acl-exception | all | link-flap | loopback}

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 loopback.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use the errdisable detect cause command to enable error detection for an application.

A cause is defined as the reason why the error-disabled state occurred. When a cause is detected on an interface, the interface is placed in an error-disabled state. This 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.

This command does not require a license.

Examples

This example shows how to enable error-disabled detection on all cases:

switch(config)# errdisable detect cause all

errdisable recovery cause

To enable an 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 | bpduguard | link-flap | link-oam-discovery-timeout | link-oam-dying-gasp | loopback | failed-port-state | psecure-violation | security-violation | storm-control | udld | vpc-peerlink}

no errdisable recovery cause {all | bpduguard | link-flap | loopback failed-port-state | psecure-violation | security-violation | storm-control | udld | vpc-peerlink}

Syntax Description

all

Enables an automatic recovery from all causes.

bpduguard

Enables an automatic recovery from BPDU Guard error-disabled state.

loopback

Enables the timer to recover from loopback error-disabled state detected by UDLD.

failed-portstate

Enables a timer automatic recovery from the STP set port state failure.

link-flap

Enables an automatic recovery from link-state flapping.

link-oam-discovery-timeout

Enable timer to recover from Ethernet link OAM discovery timeout.

link-oam-dying-gasp

Enable timer to recover from Ethernet link OAM dying gasp.

psecure-violation

Enables a timer automatic recovery from the psecure violation disable state.

security-violation

Enables an automatic recovery from the 802.1X violation disable state.

storm-control

Enables an automatic recovery from the storm control error-disabled state.

udld

Enables an automatic recovery from the UDLD error-disabled state.

vpc-peerlink

Enables an automatic recovery from an inconsistent virtual port channel (vPC) peer-link error-disabled state.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(2)

Added the loopback keyword.

4.1(3)

Added the vpc-peerlink parameter.

4.0

This command was introduced.

Usage Guidelines

Use the errdisable recovery cause command to enable an 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.

This command does not require a license.

Examples

This example shows how to automatically recover from the error-disabled state for link flapping after you have enabled the recovery timer:

switch(config)# errdisable recovery cause link-flap

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 mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use the errdisable recovery interval command to configure the recovery timer.

This command does not require a license.

Examples

This example shows how to configure the recovery timer:

switch(config)# errdisable recovery interval 32

ethernet oam

To enable Ethernet Link OAM, with default values, on an interface and enter interface Ethernet OAM configuration mode, use the ethernet oam command in interface configuration mode. To disable Ethernet Link OAM, use the no form of this command.

ethernet oam

noethernet oam

This command has no keywords or arguments.

Command Default

None

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin

vdc‐--admin

network--‐operator

vdc-operator

Command History

Release Modification
7.3(0)D1(1)

This command was introduced.

Usage Guidelines

When you enable Ethernet Link OAM on an interface, the default Ethernet Link OAM values are applied to the interface. For the default Ethernet Link OAM values, see the related Ethernet Link OAM commands.

This command does not require a license.

Examples

This example shows how to configure the connection timeout value of an Ethernet OAM session:

switch# configure terminal
switch(config)# interface ethernet 2/19
switch(config-eoam)# ethernet oam
switch(config-if-eoam)#

ethernet oam profile

To create an Ethernet Operations, Administration and Maintenance (EOAM) profile and enter EOAM configuration mode, use the ethernet oam profile command in global configuration mode. To delete an EOAM profile, use the no form of this command.

ethernet oam profile profile-name

noethernet oam profile profile-name

Syntax Description

profile-name

Text string name of the OAM profile. The maximum length is 32 bytes.

Command Default

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin

vdc‐--admin

network--‐operator

vdc-operator

Command History

Release Modification

7.3(0)D1(1)

This command was introduced.

Usage Guidelines

Before you can delete an EOAM profile, you must remove the profile from all interfaces to which it is attached.

This command does not require a license.

Examples

This example shows how to create an Ethernet OAM profile and enter Ethernet OAM configuration mode:

switch(config)# ethernet oam profile Profile_1
switch(config-eoam)#