Cisco Nexus 5500 Series Command Reference Manual

Preface

This preface describes the audience, organization, and conventions of the Cisco Nexus 5500 Series
NX-OS Layer 2 Interfaces Command Reference. It also provides information on how to obtain related

documentation.

This preface includes the following sections:

• Audience, page 1

• Document Conventions, page 1

• Related Documentation, page 2

• Obtaining Documentation and Submitting a Service Request, page 3

Audience

This publication is for experienced users who configure and maintain Cisco NX-OS devices.

Document Conventions

Command descriptions use these conventions:

Convention Description

boldface font Commands and keywords are in boldface.

italic font Arguments for which you supply values are in italics.

[ ] Elements in square brackets are optional.

{x | y | z} Alternative keywords are grouped in braces and separated by vertical bars.

[ x | y | z ] Optional alternative keywords are grouped in brackets and separated by vertical

string A nonquoted set of characters. Do not use quotation marks around the string or

OL-27880-02

bars.

the string will include the quotation marks.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

1

Chapter

Screen examples use these conventions:

screen font Terminal sessions and information that the switch displays are in screen font.

boldface screen

font

italic screen font Arguments for which you supply values are in italic screen font.

Information you must enter is in boldface screen font.

< > Nonprinting characters, such as passwords, are in angle brackets.

[ ] Default responses to system prompts are in square brackets.

!, # An exclamation point (!) or a pound sign (#) at the beginning of a line of code

indicates a comment line.

This document uses the following conventions:

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the

manual.

Caution Means reader be careful. In this situation, you might do something that could result in equipment damage

or loss of data.

Related Documentation

Documentation for Cisco Nexus 5000 Series Switches and Cisco Nexus 2000 Series Fabric Extenders is
available at the following URL:

http://www.cisco.com/en/US/products/ps9670/tsd_products_support_series_home.html

The documentation set includes the following types of documents:

• Licensing Information Guide

• Release Notes

• Installation and Upgrade Guides

• Configuration Guides

• Configuration Examples and TechNotes

• Programming Guides

• Operations Guides

• Error and System Message Guides

• Field Notices

• Security Advisories, Responses and Notices

• Troubleshooting Guide

• Command References

• MIB Reference Guide

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

2

OL-27880-02

Chapter

Obtaining Documentation and Submitting a Service Request

Documentation Feedback

To provide technical feedback on this document or to report an error or ommission, please send your
comments to [e-mail]. We appreciate your feedback.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a
service request, and gathering additional information, see What’s New in Cisco Product Documentation
at: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html.

Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised
Cisco technical documentation as an RSS feed and delivers content directly to your desktop using a
reader application. The RSS feeds are a free service.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

3

Chapter

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

4

OL-27880-02

New and Changed Information

This chapter provides release-specific information for each new and changed feature in the Cisco Nexus
5500 Series NX-OS Layer 2 Interfaces Command Reference. The latest version of this document is

available at the following Cisco website:

http://www.cisco.com/en/US/products/ps9670/prod_command_reference_list.html

To check for additional information about this Cisco NX-OS Release, see the Cisco Nexus 6000 Series
NX-OS Release Notes, Release 6.0 available at the following Cisco website:

http://www.cisco.com/en/US/products/ps9670/prod_release_notes_list.html

New and Changed Information for Cisco NX-OS Releases

This section includes the following topics:

• New and Changed Information for Cisco NX-OS Release 6.0(2)N1(2), page 17

New and Changed Information for Cisco NX-OS Release 6.0(2)N1(2)

Table 1 summarizes the new and changed features for Cisco NX-OS Release 6.0(2)N1(2) and tells you

where they are documented.

Table 1 New and Changed Information for Release 6.0(2)N1(2)

Feature Description Where Documented

QSFP+ GEM This feature was introduced.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

OL-27880-02

• B Commands

• C Commands

• D Commands

• I Commands

• M Commands

• S Commands

• Show Commands

17

Chapter

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

18

OL-27880-02

B Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with B.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

11

bandwidth (interface)

bandwidth (interface)

To set the inherited and received bandwidth values for an interface, use the bandwidth command. To
restore the default values, use the no form of this command.

bandwidth {kbps | inherit [kbps]}

no bandwidth {kbps | inherit [kbps]}

Chapter B Commands

Syntax Description

kbps Informational bandwidth in kilobits per second. Valid values are from 1 to

10000000.

inherit (Optional) Specifies that the bandwidth be inherited from the parent

interface.

Command Default 1000000 kbps

Command Modes Interface configuration mode

Subinterface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines The bandwidth command sets an informational parameter to communicate only the current bandwidth

to the higher-level protocols; you cannot adjust the actual bandwidth of an interface using this command.

The bandwidth inherit command controls how a subinterface inherits the bandwidth of its main
interface.

The no bandwidth inherit command enables all subinterfaces to inherit the default bandwidth of the
main interface, regardless of the configured bandwidth. If a bandwidth is not configured on a
subinterface, and you use the bandwidth inherit command, all subinterfaces will inherit the current
bandwidth of the main interface. If you configure a new bandwidth on the main interface, all
subinterfaces will use this new value.

If you do not configure a bandwidth on the subinterface and you configure the bandwidth inherit
command on the main interface, the subinterfaces will inherit the specified bandwidth.

In all cases, if an interface has an explicit bandwidth setting configured, then that interface will use that
setting, regardless of whether the bandwidth inheritance setting is in effect.

Examples This example shows how to configure the badwidth for a Layer 2 interface:

switch(config)# interface ethernet 1/5
switch(config-if)# bandwidth 1000
switch(config-if)#

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

12

OL-27880-02

Chapter B Commands

This example shows how to configure subinterfaces to inherit the bandwidth from the parent routed
interface:

switch(config)# interface ethernet 1/5
switch(config-if)# no switchport
switch(config-if)# bandwidth inherit 30000
switch(config-if)# interface ethernet 1/1.1
switch(config-subif)#

Related Commands Command Description

show interface Displays the interface configuration information.

bandwidth (interface)

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

13

beacon (interface)

beacon (interface)

To turn on the beacon LED for a port of an interface, use the beacon command. To turn off the beacon
LED for the interface, use the no form of this command.

beacon

no beacon

Syntax Description This command has no arguments or keywords.

Command Default None

Command Modes Interface configuration mode

Chapter B Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Use the beacon command to toggle the port LED of an interface to easily identify each time a beacon is

sent to check for pending packets on the interface.

Examples This example shows how to turn on the locator beacon LED for a specific interface:

switch(config)# interface ethernet 2/1
switch(config-if)# beacon

This example shows how to turn off the locator beacon LED for a specific interface:

switch(config)# interface ethernet 2/1
switch(config-if)# no beacon

Related Commands

Command Description

show interface Displays configuration information for an interface.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

14

OL-27880-02

Chapter B Commands

bind (virtual Ethernet interface)

To bind an interface to a virtual Ethernet interface, use the bind command. To remove the binding of an
interface, use the no form of this command.

bind interface ethernet slot/[QSFP-module/]port channel number

no bind interface ethernet slot/[QSFP-module/]port channel number

bind (virtual Ethernet interface)

Syntax Description

interface ethernet Specifies that the virtual Ethernet interface be bound to a specified

Ethernet interface.

slot/[QSFP-module/]port Ethernet interface slot number and port number. The slot number is from

1 to 255. The QSFP-module number is from 1 to 4. The port number is
from 1 to 128.

Note The QSFP-module number applies only to the QSFP+ Generic

Expansion Module (GEM).

channel Specifies that the virtual Ethernet interface be bound to a specified

EtherChannel interface.

number EtherChannel number. The range is from 1 to 65535.

Command Default Disabled

Command Modes Virtual Ethernet interface configuration mode

Command History

Release Modification

6.0(2)N1(2) Support for the QSFP+ GEM.

5.2(1)N1(1) This command was introduced.

Examples This example shows how to bind a virtual Ethernet interface 10 to an Ethernet interface:

switch(config)# interface vethernet 10
switch(config-if)# bind interface ethernet 1/1 channel 101
switch(config-if)#

Related Commands

Command Description

interface vethernet Configures a virtual Ethernet interface.

show interface
ethernet

OL-27880-02

Displays information about Ethernet interfaces.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

15

bind (virtual Ethernet interface)

Command Description

show interface
vethernet

show running-config
interface

Chapter B Commands

Displays the specified virtual Ethernet interface, attributes, and status.

Displays the running configuration of an interface.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

16

OL-27880-02

C Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with C.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

17

capability (virtual Ethernet interface)

capability (virtual Ethernet interface)

To set a profile capability for a virtual Ethernet interface, use the capability command. To remove the
profile capability of an interface, use the no form of this command.

profile capability iscsi-multipath

no profile capability iscsi-multipath

Chapter C Commands

Syntax Description

iscsi-multipath Configure an iSCSI multipath profile.

Command Default None

Command Modes Virtual Ethernet interface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Examples This example shows how to set the profile capability for a specific virtual Ethernet interface:

switch# configure terminal
switch(config)# interface vethernet 1
switch(config-if)# capability iscsi-multipath
switch(config-if)#

Related Commands

Command Description

interface vethernet Configures a virtual Ethernet interface.

show interface

Displays the specified virtual Ethernet interface, attributes, and status.

vethernet

show running-config

Displays the running configuration of an interface.

interface

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

18

OL-27880-02

Chapter C Commands

carrier-delay

To set the carrier delay on a serial interface, use the carrier-delay command. To return to the default
carrier delay value, use the no form of this command.

carrier-delay

carrier-delay {delay-seconds | msec milliseconds}

no carrier-delay

Syntax Description

delay-seconds Time, in seconds, to wait for the system to change states. Enter an integer

in the range 0 to 60.

msec Specifies the delay time in milliseconds.

milliseconds Time, in milliseconds, to wait for the system to change states. Enter an

integer in the range 0 to 1000.

Command Default None

Command Modes Interface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines You can use this command on a VLAN interface.

If a link goes down and comes back up before the carrier delay timer expires, the down state is effectively
filtered, and the rest of the software on the switch is not aware that a link-down event occurred.
Therefore, a large carrier delay timer results in fewer link-up/link-down events being detected. Setting
the carrier delay time to 0 means that every link-up/link-down event is detected.

This command does not require a license.

Examples This example shows how to change the carrier delay to 10 seconds:

switch# configure terminal
switch(config)# interface vlan 5
switch(config-if)# carrier-delay 10
switch(config-if)#

This example shows how to revert to the default carrier delay value:

switch# configure terminal
switch(config)# interface vlan 5
switch(config-if)# no carrier-delay
switch(config-if)#

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

19

carrier-delay

Related Commands Command Description

show running-config

Displays the running configuration information for an interface.

interface

Chapter C Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

110

OL-27880-02

Chapter C Commands

cdp

cdp

To enable the Cisco Discovery Protocol (CDP) and configure CDP attributes, use the cdp command. To
disable CDP or reset CDP attributes, use the no form of this command.

cdp {advertise {v1 | v2} | enable | format device-id {mac-address | serial-number |

system-name} | holdtime seconds | timer seconds}

no cdp {advertise | enable | format device-id {mac-address | serial-number | system-name} |

holdtime seconds | timer seconds}

Syntax Description

advertise {v1 | v2} Configures the version to use to send CDP advertisements. Version-2 is the

enable Enables CDP for all Ethernet interfaces.

format device-id Configures the format of the CDP device ID.

mac-address Uses the MAC address as the CDP device ID.

serial-number Uses the serial number as the CDP device ID.

system-name Uses the system name, which can be expressed as a fully qualified domain

holdtime seconds Specifies the amount of time a receiver should hold CDP information before

timer seconds Sets the transmission frequency of CDP updates in seconds. The range is

Command Default None

Command Modes Global configuration mode

default state.

name, as the CDP device ID. This is the default.

discarding it. The range is from 10 to 255 seconds; the default is 180
seconds.

from 5 to 254; the default is 60 seconds.

Command History

Release Modification

5.2(1)N1(1) This command we introduced.

Examples This example shows how to enable CDP on all Ethernet interfaces:

switch# configure terminal
switch(config)# cdp enable

This example shows how to configure the MAC address as the CDP device ID:

switch# configure terminal
switch(config)# cdp format device-id mac-address

This example shows how to disable CDP on all Ethernet interfaces:

switch# configure terminal
switch(config)# no cdp enable

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

111

cdp

Related Commands Command Description

show cdp Displays Cisco Discovery Protocol (CDP) information.

Chapter C Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

112

OL-27880-02

Chapter C Commands

cdp enable

To enable the Cisco Discovery Protocol (CDP) on an interface, use the cdp enable command. To disable
CDP on the interface, use the no form of this command.

cdp enable

no cdp enable

Syntax Description This command has no arguments or keywords.

Command Default None

Command Modes Interface configuration mode

Virtual Ethernet interface configuration mode

cdp enable

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines You can use this command on the following interfaces:

• Ethernet interface

• Management interface

• Virtual Ethernet interface

Examples This example shows how to enable CDP on an Ethernet interface:

switch# configure terminal
switch(config)# interface ethernet 1/1
switch(config-if)# cdp enable

This example shows how to enable CDP on a specific virtual Ethernet interface:

switch# configure terminal
switch(config)# interface vethernet 1
switch(config-if)# cdp enable

This example shows how to disable CDP on a specific virtual Ethernet interface:

switch# configure terminal
switch(config)# interface vethernet 1
switch(config-if)# no cdp enable

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

113

cdp enable

Related Commands Command Description

show cdp Displays Cisco Discovery Protocol (CDP) information.

show interface Displays the interface configuration information.

Chapter C Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

114

OL-27880-02

Chapter C Commands

channel-group (Ethernet)

To assign and configure a physical interface to an EtherChannel, use the channel-group command. To
remove the channel group configuration from the interface, use the no form of this command.

channel-group number [force] [mode {active | on | passive}]

no channel-group [number]

channel-group (Ethernet)

Syntax Description

number Number of channel group. The number range is from 1 to 4096. Cisco

NX-OS creates the EtherChannel associated with this channel group if the
EtherChannel does not already exist.

force (Optional) Specifies that the LAN port be forcefully added to the channel

group.

mode (Optional) Specifies the EtherChannel mode of the interface.

active Specifies that when you enable the Link Aggregation Control Protocol

(LACP), this command enables LACP on the specified interface. The
interface is in an active negotiating state, in which the port initiates
negotiations with other ports by sending LACP packets.

on This is the default channel mode. Specifies that all EtherChannels that are

not running LACP remain in this mode. If you attempt to change the channel
mode to active or passive before enabling LACP, the switch returns an error
message.

After you enable LACP globally, by using the feature lacp command, you
enable LACP on each channel by configuring the channel mode as either
active or passive. An interface in this mode does not initiate or respond to
LACP packets. When an LACP attempts to negotiate with an interface in the
on state, it does not receive any LACP packets and becomes an individual
link with that interface; it does not join the channel group.

The default mode is on.

passive Specifies that when you enable LACP, this command enables LACP only if

an LACP device is detected. The interface is in a passive negotiation state,
in which the port responds to LACP packets that it receives but does not
initiate LACP negotiation.

Command Default None

Command Modes Interface configuration mode

Command History

OL-27880-02

Release Modification

5.2(1)N1(1) This command was introduced.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

115

Chapter C Commands

channel-group (Ethernet)

Usage Guidelines Use this command to create a channel group that includes the interface that you are working on and to

add or remove specific interfaces from the channel group. Use this command to move a port from one
channel group to another. You enter the channel group that you want the port to move to; the switch
automatically removes the specified port from its present channel group and adds it to the specified
channel group.

Use the force keyword to force the addition of the interface into the specified channel group.

After you enable LACP globally, by using the feature lacp command, you enable LACP on each channel
by configuring the channel mode as either active or passive. An EtherChannel in the on channel mode
is a pure EtherChannel and can aggregate a maximum of eight ports. The EtherChannel does not run
LACP.

You cannot change the mode for an existing EtherChannel or any of its interfaces if that EtherChannel
is not running LACP; the channel mode remains as on. The system returns an error message if you
attempt to change the mode.

Use the no form of this command to remove the physical interface from the EtherChannel. When you
delete the last physical interface from an EtherChannel, the EtherChannel remains. To delete the
EtherChannel completely, use the no form of the interface port-channel command.

The compatibility check includes the following operational attributes:

• Port mode

• Access VLAN

• Trunk native VLAN

• Tagged or untagged

• Allowed VLAN list

• Switched Port Analyzer (SPAN) (cannot be SPAN source or destination port)

• Storm control

Use the show port-channel compatibility-parameters command to see the full list of compatibility
checks that Cisco NX-OS uses.

You can only add interfaces configured with the channel mode set to on for static EtherChannels, that
is, without a configured aggregation protocol. You can only add interfaces configured with the channel
mode as active or passive to EtherChannels that are running LACP.

You can configure these attributes on an individual member port. If you configure a member port with
an incompatible attribute, Cisco NX-OS suspends that port in the EtherChannel.

When the interface joins an EtherChannel, some of its individual parameters are overridden with the
values on the EtherChannel, as follows:

• MAC address

• Spanning Tree Protocol (STP)

• Service policy

• Quality of service (QoS)

• Access control lists (ACLs)

Interface parameters, such as the following, remain unaffected when the interface joins or leaves a
EtherChannel:

• Description

• Cisco Discovery Protocol (CDP)

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

116

OL-27880-02

Chapter C Commands

channel-group (Ethernet)

• LACP port priority

• Debounce

• Rate mode

• Shutdown

• SNMP trap

If interfaces are configured for the EtherChannel interface and a member port is removed from the
EtherChannel, the configuration of the EtherChannel interface is not propagated to the member ports.

Any configuration changes that you make in any of the compatibility parameters to the EtherChannel
interface are propagated to all interfaces within the same channel group as the EtherChannel (for
example, configuration changes are also propagated to the physical interfaces that are not part of the
EtherChannel but are part of the channel group).

Examples This example shows how to add an interface to LACP channel group 5 in active mode:

switch(config)# interface ethernet 1/1
switch(config-if)# channel-group 5 mode active
switch(config-if)#

This example shows how to forcefully add an interface to the channel group 5:

switch(config)# interface ethernet 1/1
switch(config-if)# channel-group 5 force
switch(config-if)#

Related Commands Command Description

show interface
port-channel

Displays information about the traffic on the specified EtherChannel
interface.

show lacp Displays LACP information.

show port-channel

Displays information on the EtherChannels.

summary

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

117

clear lacp counters

clear lacp counters

To clear the Link Aggregation Control Protocol (LACP) counters, use the clear lacp counters command.

clear lacp counters [interface port-channel channel-num]

Chapter C Commands

Syntax Description

interface (Optional) Clears the LACP counters of a specific interface.

port-channel

(Optional) Specifies a port channel interface. The range is from 1 to 4096.

channel-num

Command Default None

Command Modes EXEC mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines This command does not require a license.

Examples This example shows how to clear all LACP counters:

switch# clear lacp counters

Related Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

118

This example shows how to clear the LACP on a port channel:

switch# clear lacp counters interface port-channel 100

Command Description

show lacp Displays LACP information.

OL-27880-02

Chapter C Commands

clear mac access-list counters

To clear statistical information from the access list, use the clear mac access-list counters command.

clear mac access-list counters [name]

clear mac access-list counters

Syntax Description

name (Optional) Name of a specific counter to clear. The name can be a maximum

of 64 characters.

Command Default None

Command Modes EXEC mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Examples This example shows how to clear statistical information from the access list:

switch# clear mac access-list counters

Related Commands

Command Description

show mac access-lists Displays the information about the MAC address table.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

119

clear mac address-table dynamic

clear mac address-table dynamic

To clear the dynamic address entries from the MAC address table, use the clear mac address-table
dynamic command.

clear mac address-table dynamic [[address mac-addr] | [interface {ethernet

slot/[QSFP-module/]port | port-channel number}]] [vlan vlan-id]

Chapter C Commands

Syntax Description

Command Default None

address mac-addr (Optional) Specifies the MAC address to remove from the table.

interface (Optional) Specifies the interface for which MAC addresses

ethernet slot/[QSFP-module/]port (Optional) Specifies the Ethernet interface and the slot number

port-channel number (Optional) Specifies the EtherChannel for which MAC addresses

vlan vlan-id (Optional) Specifies the VLAN from which MAC addresses

Use the format EEEE.EEEE.EEEE.

should be removed from the table. The type can be either
Ethernet or EtherChannel.

and port number. The slot number is from 1 to 255. The
QSFP-module number is from 1 to 4. The port number is from 1
to 128.

Note The QSFP-module number applies only to the QSFP+

Generic Expansion Module (GEM).

should be removed from the table. Use the EtherChannel number.
The number range is from 1 to 4096.

should be removed from the table. The range is from 1 to 3967
and from 4049 to 4093.

Command Modes EXEC mode

Command History

Usage Guidelines Use the clear mac address-table dynamic command with no arguments to remove all dynamic entries

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

120

Release Modification

6.0(2)N1(1) Support for the QSFP+ GEM was added.

5.2(1)N1(1) This command was introduced.

from the table.

To clear static MAC addresses from the table, use the no mac address-table static command.

If the clear mac address-table dynamic command is entered with no options, all dynamic addresses are
removed. If you specify an address but do not specify an interface, the address is deleted from all
interfaces. If you specify an interface but do not specify an address, the switch removes all addresses on
the specified interfaces.

OL-27880-02

Chapter C Commands

clear mac address-table dynamic

Examples This example shows how to clear all the dynamic entries from the MAC address table:

switch# clear mac address-table dynamic

This example shows how to clear all the dynamic entries from the MAC address table for VLAN 2:

switch# clear mac address-table dynamic vlan 2

Related Commands Command Description

show mac

Displays the information about the MAC address table.

address-table

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

121

clear port-security dynamic

clear port-security dynamic

To clear port security information, use the clear port-security dynamic command.

clear port-security dynamic {address MAC-addr vlan vlan-ID | interface {ethernet

slot/[QSFP-module/]port [vlan vlan-ID] | port-channel channel-num [vlan vlan-ID]}}

Chapter C Commands

Syntax Description

address MAC-addr Clears all dynamically secured MAC address information. The

vlan vlan-ID Clears all dynamically secured VLAN information. The range is

interface Clears all dynamically secured addresses on a port.

ethernet slot/[QSFP-module/]port Clears all dynamically secured addresses from an Ethernet port.

port-channel channel-num Clears all dynamically secured addresses from an EtherChannel.

Command Default None

Command Modes EXEC mode

Command History

Release Modification

6.0(2)N1(1) Support for the QSFP+ GEM was added.

5.2(1)N1(1) This command was introduced.

MAC address can be in the format E.E.E.

from 1 to 4094.

The slot number is from 1 to 255. The QSFP-module number is
from 1 to 4. The port number is from 1 to 128.

Note The QSFP-module number applies only to the QSFP+

Generic Expansion Module (GEM).

The range is from 1 to 4096.

Usage Guidelines This command does not require a license.

Examples This example shows how to clear the dynamically secured MAC address information:

switch# clear port-security dynamic address 0050.3e8d.6400 vlan 1
switch#

Related Commands

Command Description

show port-security Displays the port security configuration information.

switchport
port-security

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

122

Configures the switchport parameters to establish port security.

OL-27880-02

Chapter C Commands

clear port-security dynamic

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

123

clear spanning-tree counters

clear spanning-tree counters

To clear the counters for the Spanning Tree Protocol (STP), use the clear spanning-tree counters
command.

clear spanning-tree counters [interface {ethernet slot/[QSFP-module/]port | port-channel

channel}] [vlan vlan-id]

Chapter C Commands

Syntax Description

interface (Optional) Specifies the interface type.

ethernet slot/[QSFP-module/]port Specifies the Ethernet interface slot and port number. The

port-channel channel Specifies the EtherChannel number. The number range is

vlan vlan-id (Optional) Specifies the VLAN. The range is from 1 to

Command Default None

Command Modes EXEC mode

Command History

Release Modification

6.0(2)N1(1) Support for the QSFP+ GEM was added.

5.2(1)N1(1) This command was introduced.

slot number is from 1 to 255. The QSFP-module number is
from 1 to 4. The port number is from 1 to 128.

Note The QSFP-module number applies only to the

QSFP+ Generic Expansion Module (GEM).

from 1 to 4096.

3967 and from 4049 to 4093.

Usage Guidelines You can clear all the STP counters on the entire switch, per VLAN, or per interface.

Examples This example shows how to clear the STP counters for VLAN 5:

switch# clear spanning-tree counters vlan 5

Related Commands

Command Description

show spanning-tree Displays information about the spanning tree state.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

124

OL-27880-02

Chapter C Commands

clear spanning-tree detected-protocol

To restart the protocol migration, use the clear spanning-tree detected-protocol command. With no
arguments, the command is applied to every port of the switch.

clear spanning-tree detected-protocol [interface {ethernet slot/[QSFP-module/]port |

port-channel channel}]

clear spanning-tree detected-protocol

Syntax Description

interface (Optional) Specifies the interface type.

ethernet slot/[QSFP-module/]port Specifies the Ethernet interface and the slot number and port

port-channel channel Specifies the EtherChannel number. The number range is from 1

Command Default None

Command Modes EXEC mode

Command History

Release Modification

6.0(2)N1(1) Support for the QSFP+ GEM was added.

5.2(1)N1(1) This command was introduced.

number. The slot number is from 1 to 255. The QSFP-module
number is from 1 to 4. The port number is from 1 to 128.

Note The QSFP-module number applies only to the QSFP+

Generic Expansion Module (GEM).

to 4096.

Usage Guidelines Rapid per VLAN Spanning Tree Plus (Rapid PVST+) and Multiple Spanning Tree (MST) have built-in

compatibility mechanisms that allow them to interact properly with other versions of IEEE spanning tree
or other regions. For example, a switch running Rapid PVST+ can send 802.1D bridge protocol data
units (BPDUs) on one of its ports when it is connected to a legacy device. An MST switch can detect
that a port is at the boundary of a region when it receives a legacy BPDU or an MST BPDU that is
associated with a different region.

These mechanisms are not always able to revert to the most efficient mode. For example, a Rapid PVST+
switch that is designated for a legacy 802.1D bridge stays in 802.1D mode even after the legacy bridge
has been removed from the link. Similarly, an MST port assumes that it is a boundary port when the
bridges to which it is connected have joined the same region.

To force a port to renegotiate with its neighbors, enter the clear spanning-tree detected-protocol
command.

Examples This example shows how to restart the protocol migration on a specific interface:

switch# clear spanning-tree detected-protocol interface ethernet 1/4

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

125

clear spanning-tree detected-protocol

Related Commands Command Description

show spanning-tree Displays information about the spanning tree state.

Chapter C Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

126

OL-27880-02

Chapter C Commands

clear vtp counters

To clear VLAN Trunking Protocol (VTP) counters, use the clear vtp counters command.

clear vtp counters

Syntax Description This command has no arguments or keywords.

Command Default None

Command Modes EXEC mode

clear vtp counters

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Use this command to clear the VTP statistics, such as the VTP requests, VTP advertisements, and

configuration revisions.

Examples This example shows how to clear the VTP counters:

switch# clear vtp counters
switch#

Related Commands

Command Description

show vtp counters Displays VTP counters.

show vtp status Displays VTP information.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

127

clock protocol

clock protocol

To set the synchronization protocol for the clock to a protocol, use the clock protocol command. To
remove the clock protocol, use the no form of this command.

clock protocol {none | ntp}

no clock protocol {none | ntp}

Chapter C Commands

Syntax Description

none Specifies that the clock can be set manually.

ntp Specifies that the clock be set to the Network Time Protocol (NTP).

Command Default None

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines This command does not require a license.

Examples This example shows how to set the synchronization protocol for the clock to NTP:

switch# configure terminal
switch(config)# clock protocol ntp
switch(config)#

Related Commands

Command Description

show running-config Displays the running system configuration information.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

128

OL-27880-02

Chapter C Commands

connect

To initiate a connection with a vCenter Server, use the connect command. To disconnect from a vCenter
Server, use the no form of this command.

connect

no connect

Syntax Description This command has no arguments or keywords.

Command Default No connection with a vCenter Server

Command Modes SVS connection configuration mode

connect

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines There can be only one active connection at a time.

This command does not require a license.

Examples This example shows how to connect to a vCenter Server:

switch# configure terminal
switch(config)# svs connection SVSConn
switch(config-svs-conn)# protocol vmware-vim
switch(config-svs-conn)# remote hostname vcMain
switch(config-svs-conn)# vmware dvs datacenter-name DemoDC
switch(config-svs-conn)# connect
switch(config-svs-conn)#

This example shows how to disconnect from a vCenter Server:

switch# configure terminal
switch(config)# svs connection SVSConn
switch(config-svs-conn)# no connect
switch(config-svs-conn)#

Related Commands

Command Description

show svs connections Displays SVS connection information.

svs connection Enables an SVS connection.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

129

connect

Chapter C Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

130

OL-27880-02

D Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with D.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

131

default shutdown (virtual Ethernet interface)

default shutdown (virtual Ethernet interface)

To enable default commands on a virtual Ethernet interface, use the default shutdown command.

default shutdown

Syntax Description This command has no arguments or keywords.

Command Default No description is added.

Command Modes Virtual Ethernet interface configuration

Chapter D Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines This command does not require a license.

Examples This example shows how to enable a virtual Ethernet interface:

switch# configure terminal
switch(config)# interface vethernet 1
switch(config-if)# default shutdown
switch(config-if)#

Related Commands

Command Description

show interface

Displays the virtual Ethernet interface configuration information.

vethernet

show running-config Displays the contents of the currently running configuration file.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

132

OL-27880-02

Chapter D Commands

delay (interface)

To set a delay value for an interface, use the delay command. To restore the default delay value, use the
no form of this command.

delay tens-of-microseconds

no delay

delay (interface)

Syntax Description

tens-of-microseconds Throughput delay in tens of microseconds. The range is from 1 to

16,777,215.

Command Default 10 microseconds

Command Modes Interface configuration mode

Subinterface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Examples This example shows how to set a delay of 30,000 microseconds on an interface:

switch(config)# interface ethernet 1/1
switch(config-if)# delay 30000
switch(config-if)#

This example shows how to set a delay of 1000 microseconds on a subinterface:

switch(config)# interface ethernet 1/1.1
switch(config-subif)# delay 1000
switch(config-subif)#

Related Commands

Command Description

interface ethernet
(Layer 3)

show interface Displays the interface configuration information.

OL-27880-02

Configures an Ethernet routed interface.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

133

description (interface)

description (interface)

To add a description to an interface configuration, use the description command. To remove the
description, use the no form of this command.

description description

no description

Chapter D Commands

Syntax Description

description String description of the interface configuration. This string is limited to 80

characters.

Command Default No description is added.

Command Modes Interface configuration mode

Subinterface configuration mode
Virtual Ethernet interface configuration

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines The description command is meant to provide a reminder in the configuration to describe what certain

interfaces are used for. The description appears in the output of the following commands such as show
interface and show running-config.

You can use this command on the following interfaces:

• Ethernet interface

• Management interface

• Subinterfaces

• Virtual Ethernet interface

Examples This example shows how to add a description for an interface:

switch# configure terminal
switch(config)# interface ethernet 1/1
switch(config-if)# description "10G Server Link"
switch(config-if)#

This example shows how to add a description for a virtual Ethernet interface:

switch# configure terminal
switch(config)# interface vethernet 1
switch(config-if)# description "Virtual interface"
switch(config-if)#

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

134

OL-27880-02

Chapter D Commands

Related Commands Command Description

show interface

Displays the interface configuration information.

ethernet

show interface

Displays the virtual Ethernet interface configuration information.

vethernet

show running-config Displays the contents of the currently running configuration file.

description (interface)

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

135

description (SPAN, ERSPAN)

description (SPAN, ERSPAN)

To add a description to an Ethernet Switched Port Analyzer (SPAN) or an Encapsulated Remote
Switched Port Analyzer (ERSPAN) session configuration, use the description command. To remove the
description, use the no form of this command.

description description

no description

Chapter D Commands

Syntax Description

description String description of the SPAN session configuration. This string is limited

to 80 characters.

Command Default No description is added.

Command Modes SPAN session configuration mode

ERSPAN session configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Use the description command to provide a reminder in the configuration to describe what certain SPAN

sessions are used for. The description appears in the output of the following commands such as show
monitor session and show running-config monitor.

Examples This example shows how to add a description for a SPAN session:

switch# configure terminal
switch(config)# monitor session 9 type local
switch(config-monitor)# description A Local SPAN session
switch(config-monitor)#

This example shows how to add a description for an ERSPAN session:

switch# configure terminal
switch(config)# monitor session 9 type erspan-source
switch(config-erspan-src)# description An ERSPAN session
switch(config-erspan-src)#

Related Commands

Command Description

destination (SPAN
session)

monitor session Creates a new SPAN session configuration.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

136

Configures a destination SPAN port.

OL-27880-02

Chapter D Commands

Command Description

show monitor session Displays SPAN session configuration information.

show running-config

Displays the running configuration information of a SPAN session.

monitor

source (SPAN session) Configures a source SPAN port.

description (SPAN, ERSPAN)

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

137

destination (ERSPAN)

destination (ERSPAN)

To configure an Encapsulated Remote Switched Port Analyzer (ERSPAN) destination IP address, use
the destination command. To remove the destination ERSPAN IP address, use the no form of this
command.

destination ip ip_address

no destination ip ip_address

Chapter D Commands

Syntax Description

ip Configures the remote IP address.

ip_address IPv4 address in the format A.B.C.D.

Command Default None

Command Modes ERSPAN session configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines You can configure only one destination IP address for an ERSPAN source session.

This command does not require a license.

Examples This example shows how to configure an ERSPAN destination IP address:

switch# configure terminal
switch(config)# monitor session 1 type erspan-source
switch(config-erspan-src)# destination ip 192.0.3.1
switch(config-erspan-src)#

Related Commands

Command Description

monitor session Creates a new SPAN session configuration.

show monitor session Displays SPAN session configuration information.

show running-config
monitor

source (SPAN session) Configures a source SPAN port.

source (ERSPAN
session)

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

138

Displays the running configuration information of a SPAN session.

Configures a source VLAN or VSAN interface.

OL-27880-02

Chapter D Commands

destination (SPAN session)

To configure a Switched Port Analyzer (SPAN) destination port, use the destination command. To
remove the destination SPAN port, use the no form of this command.

destination interface {ethernet slot/[QSFP-module/]port}

no source interface {ethernet slot/[QSFP-module/]port}

destination (SPAN session)

Syntax Description

interface Specifies the interface type to use as the destination SPAN port.

ethernet slot/[QSFP-module/]port Specifies the Ethernet interface to use as the destination SPAN

port. The slot number is from 1 to 255. The QSFP-module
number is from 1 to 4. The port number is from 1 to 128.

Note The QSFP-module number applies only to the QSFP+

Generic Expansion Module (GEM).

Command Default None

Command Modes SPAN session configuration mode

Command History

Release Modification

6.0(2)N1(1) Support for the QSFP+ GEM was added.

5.2(1)N1(1) This command was introduced.

Usage Guidelines Each local SPAN session destination session must have a destination port (also called a monitoring port)

that receives a copy of traffic from the source port.

The destination port can be any Ethernet physical port and must reside on the same switch as the source
port (for a local SPAN session). The destination port cannot be a source port, a port channel, or SAN
port channel group.

A destination port receives copies of sent and received traffic for all monitored source ports. If a
destination port is oversubscribed, it can become congested. This congestion can affect traffic
forwarding on one or more of the source ports.

Examples This example shows how to configure an Ethernet interface SPAN destination port and activate the SPAN

session:

switch# configure terminal
switch(config)# interface ethernet 1/5
switch(config-if)# switchport monitor
switch(config-if)# exit
switch(config)# monitor session 9 type local
switch(config-monitor)# description A Local SPAN session
switch(config-monitor)# source interface ethernet 1/1

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

139

destination (SPAN session)

switch(config-monitor)# destination interface ethernet 1/5
switch(config-monitor)# no shutdown
switch(config-monitor)#

Related Commands Command Description

source (SPAN session) Configures a source SPAN port.

monitor session Creates a new SPAN session configuration.

show monitor session Displays SPAN session configuration information.

show running-config

Displays the running configuration information of a SPAN session.

monitor

Chapter D Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

140

OL-27880-02

Chapter D Commands

duplex

duplex

To specify the duplex mode as full, half, or autonegotiate, use the duplex command. To return the system
to default mode, use the no form of this command.

duplex {full | half | auto}

no duplex {full | half | auto}

Syntax Description

full Specifies the duplex mode as full.

half Specifies the duplex mode as half.

Note This keyword is not supported on a management interface.

auto Specifies the duplex mode as autonegotiate.

Command Default None

Command Modes Interface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines The interface speed that you specify can affect the duplex mode used for an interface, so you should set

the speed before setting the duplex mode. If you set the speed for autonegotiation, the duplex mode is
automatically set to be autonegotiated. If you specify 10- or 100-Mbps speed, the port is automatically
configured to use half-duplex mode, but you can specify full-duplex mode instead. Gigabit Ethernet is
full duplex only. You cannot change the duplex mode on Gigabit Ethernet ports or on a
10/100/1000-Mbps port that is set for Gigabit Ethernet.

See the Cisco Nexus 6000 Series NX-OS Layer 2 Switching Configuration Guide, Release 6.0 for more
information on interface speed and duplex settings.

This command does not require a license.

Examples This example shows how to specify the duplex mode for full duplex:

switch# configure terminal
switch(config)# interface ethernet 1/5
switch(config-if)# duplex full
switch(config-if)#

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

141

duplex

Related Commands Command Description

show interface Displays information about the interface, which includes the duplex

parameter.

Chapter D Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

142

OL-27880-02

Chapter D Commands

dvs-name

dvs-name

To configure the Distributed Virtual Switch (DVS) name in the vCenter Server, use the dvs-name
command.

dvs-name name [name]

Syntax Description

name DVS name. The name can be a maximum of 80 alphanumeric characters.

Command Default None

Command Modes SVS connection configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines This command does not require a license.

Examples This example shows how to configure the DVS name in the vCenter Server:

switch# configure terminal
switch(config)# svs connection SVSConn
switch(config-svs-conn)# dvs-name vcWest
switch(config-svs-conn)#

Related Commands

Command Description

show svs connections Displays SVS connection information.

svs connection Enables an SVS connection.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

143

dvs-name

Chapter D Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

144

OL-27880-02

E Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with E.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

145

encapsulation dot1Q

encapsulation dot1Q

To enable IEEE 802.1Q encapsulation of traffic on a specified subinterface, use the encapsulation dot1q
command. To disable encapsulation, use the no form of this command.

encapsulation dot1Q vlan-id

no encapsulation dot1Q vlan-id

Chapter E Commands

Syntax Description

vlan-id VLAN to set when the interface is in access mode; valid values are from 1

to 4093, except for the VLANs reserved for internal switch use.

Command Default No encapsulation

Command Modes Subinterface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines IEEE 802.1Q encapsulation is configurable on Ethernet and EtherChannel 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.

Note This command is not applicable to loopback interfaces.

This command does not require a license.

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

switch(config)# interface ethernet 1/5.1
switch(config-subif)# encapsulation dot1q 30
switch(config-subif)#

Related Commands

Command Description

show vlan dot1Q Displays dot1Q encapsulation information for a VLAN.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

146

OL-27880-02

Chapter E Commands

errdisable detect cause

To enable error-disable (err-disabled) detection in an application, use the errdisable detect cause
command. To disable error disable detection, use the no form of this command.

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

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

errdisable detect cause

Syntax Description

all Enables error detection on all cases.

link-flap Enables error disable detection on linkstate-flapping.

loopback Enables error disable detection on loopback.

Command Default Enabled

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines When error disable detection is enabled and a cause is detected on an interface, the interface is placed

in an err-disabled state, which is an operational state that is similar to the link-down state.

Examples This example shows how to enable the err-disabled detection on linkstate-flapping:

switch(config)# errdisable detect cause link-flap
switch(config)#

Related Commands

Command Description

errdisable recovery Configures recovery from the err-disabled state.

show interface status
err-disabled

OL-27880-02

Displays the interface error disabled state.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

147

errdisable recovery cause

errdisable recovery cause

To configure the application to bring the interface out of the error-disabled (err-disabled) state and retry
coming up, use the errdisable recovery cause command. To revert to the defaults, use the no form of
this command.

errdisable recovery cause {all | bpduguard | failed-port-state | link-flap-recovery |

pause-rate-limit | udld}

no errdisable recovery cause {all | bpduguard | failed-port-state | link-flap-recovery |

pause-rate-limit | udld}

Chapter E Commands

Syntax Description

all Enables a timer to recover from all causes.

bpduguard Enables a timer to recover from bridge protocol data unit (BPDU) Guard

failed-port-state Enables a timer to recover from a Spanning Tree Protocol (STP) set port

link-flap Enables a timer to recover from linkstate flapping.

pause-rate-limit Enables a timer to recover from the pause rate limit error disabled state.

udld Enables a timer to recover from the Unidirectional Link Detection (UDLD)

Command Default None

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

error disable state.

state failure.

error disabled state.

Usage Guidelines When error disable recovery is enabled, the interface automatically recovers from the err-disabled state,

and the device retries bringing the interface up.

Examples This example shows how to enable error disable recovery from linkstate-flapping:

switch(config)# errdisable recovery cause link-flap
switch(config)#

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

148

OL-27880-02

Chapter E Commands

Related Commands Command Description

errdisable detect cause Enables the error disabled (err-disabled) detection.

show interface status

Displays the interface error disabled state.

err-disabled

errdisable recovery cause

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

149

errdisable recovery interval

errdisable recovery interval

To configure the recovery time interval to bring the interface out of the error-disabled (err-disabled)
state, use the errdisable recovery interval command. To revert to the defaults, use the no form of this
command.

errdisable recovery interval time

no errdisable recovery interval

Chapter E Commands

Syntax Description

time Error disable recovery time interval. The range is from 30 to 65535 seconds.

Command Default Disabled

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines When error disable recovery is enabled, the interface automatically recovers from the err-disabled state,

and the device retries bringing the interface up.

The device waits 300 seconds to retry.

Examples This example shows how to enable error disable recovery time interval to 100 seconds:

switch(config)# errdisable recovery interval 100
switch(config)#

Related Commands

Command Description

errdisable recovery
cause

show interface status
err-disabled

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

150

Enables an error disabled recovery on an interface.

Displays the interface error disabled state.

OL-27880-02

Chapter E Commands

erspan-id

erspan-id

To configure the flow ID for an Encapsulated Remote Switched Port Analyzer (ERSPAN)) session, use
the erspan-id command. To remove the flow ID, use the no form of this command.

erspan-id flow_id

Syntax Description

flow_id ERSPAN flow ID. The range is from 1 to 1023.

Command Default None

Command Modes ERSPAN session configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines This command does not require a license.

Examples This example shows how to configure the flow ID for an ERSPAN session:

switch# configure terminal
switch(config)# monitor session 1 type erspan-source
switch(config-erspan-src)# erspan-id 100
switch(config-erspan-src)#

Related Commands

Command Description

ip dscp Configures the DSCP value of the packets in the ERSPAN traffic.

ip ttl Configures the IP time-to-live (TTL) value of the ERSPAN traffic.

mtu Sets the maximum transmission unit (MTU) size for SPAN packet.

vrf Configures the VRF for ERSPAN traffic forwarding.

monitor-session Enters the monitor configuration mode for configuring an ERSPAN or

OL-27880-02

SPAN session for analyzing traffic between ports.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

151

extension-key

extension-key

To configure the extension key to be used to connect to the vCenter Server, use the extension-key
command.

Chapter E Commands

extension-key extn-ID

Syntax Description

extn-ID Extension ID. The ID can be a maximum of 80 alphanumeric characters.

Command Default None

Command Modes SVS connection configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines This command does not require a license.

Examples This example shows how to configure the extension key for a vCenter Server:

switch# configure terminal
switch(config)# svs connection SVSConn
switch(config-svs-conn)# extension-key vckey
switch(config-svs-conn)#

Related Commands

Command Description

show svs connections Displays SVS connection information.

svs connection Enables an SVS connection.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

152

OL-27880-02

F Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with F.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

153

feature flexlink

feature flexlink

To enable Flex Links, use the feature flexlink command. To disable Flex Links, use the no form of this
command.

feature flexlink

no feature flexlink

Syntax Description This command has no arguments or keywords.

Command Default Disabled

Command Modes Global configuration mode

Chapter F Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Examples This example shows how to enable Flex Links on the switch:

switch(config)# feature flexlink

Related Commands

Command Description

show feature Displays the status of features enabled or disabled on the switch.

switchport backup
interface

Configures Flex Links, which are two interfaces that provide backup to each
other, on a Layer 2 interface.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

154

OL-27880-02

Chapter F Commands

feature interface-vlan

To enable the creation of VLAN interfaces, use the feature interface-vlan command. To disable the
VLAN interface feature, use the no form of this command.

feature interface-vlan

no feature interface-vlan

Syntax Description This command has no arguments or keywords.

Command Default VLAN interfaces are disabled.

Command Modes Global configuration mode

feature interface-vlan

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines You must use the feature interface-vlan command before you can create VLAN interfaces.

Examples This example shows how to enable the interface VLAN feature on the switch:

switch(config)# feature interface-vlan

Related Commands

Command Description

interface vlan Creates a VLAN interface.

show feature Displays the features that are enabled or disabled on the switch.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

155

feature lacp

feature lacp

To enable the Link Aggregation Control Protocol (LACP), which bundles a number of physical ports
together to form a single logical channel, use the feature lacp command. To disable LACP on the switch,
use the no form of this command.

feature lacp

no feature lacp

Syntax Description This command has no arguments or keywords.

Command Default LACP is disabled.

Command Modes Global configuration mode

Chapter F Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines You must remove all the LACP configuration parameters from all EtherChannels on the switch before

you can disable LACP.

Even after you enable LACP globally, you do not have to run LACP on all EtherChannels on the switch.
You enable LACP on each channel mode using the channel-group mode command.

Examples This example shows how to enable LACP EtherChannels on the switch:

switch(config)# feature lacp

Related Commands

Command Description

show lacp Displays information on LACP.

show feature Displays whether or not LACP is enabled on the switch.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

156

OL-27880-02

Chapter F Commands

feature lldp

The Link Layer Discovery Protocol (LLDP), which is a neighbor discovery protocol that is used for
network devices to advertise information about themselves to other devices on the network, is enabled
on the switch by default.

Command Default Enabled

feature lldp

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines You cannot enable or disable LLDP on a Cisco Nexus device. LLDP is enabled on the switch by default.

However, the feature lldp command shows as part of the running configuration on the switch, as shown
below:

switch# show running-config

!Command: show running-config
!Time: Wed Jan 30 12:36:03 2013

version 6.02N1(1)
feature telnet
feature lldp

username admin password 5 $1$d8lkfqC8$4VfRuOoZTKvCtTq8VAKbq/ role network-admin
no password strength-check
ip domain-lookup
hostname switch
class-map type qos class-fcoe
class-map type qos match-all c1
match cos 1
<--Output truncated-->
switch#

The Cisco Discovery Protocol (CDP) is a device discovery protocol that runs over Layer 2 (the data link
layer) on all Cisco-manufactured devices (routers, bridges, access servers, and switches). CDP allows
network management applications to automatically discover and learn about other Cisco devices
connected to the network.

To support non-Cisco devices and to allow for interoperability between other devices, the switch
supports the Link Layer Discovery Protocol (LLDP). LLDP is a neighbor discovery protocol that is used
for network devices to advertise information about themselves to other devices on the network. This
protocol runs over the data-link layer, which allows two systems running different network layer
protocols to learn about each other.

Related Commands

Command Description

lldp Configures the global LLDP options on the switch.

lldp (Interface) Configures the LLDP feature on an interface.

show feature Displays that LLDP is enabled on the switch.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

157

feature port-security

feature port-security

To enable port security on Layer 2 interfaces, use the feature port-security command. To disable port
security, use the no form of this command.

feature port-security

no feature port-security

Syntax Description This command has no arguments or keywords.

Command Default Disabled

Command Modes Global configuration mode

Chapter F Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Use the port security feature to secure a port by limiting and identifying the MAC addresses of the

switches that are allowed to access the port.

You can enable port security on a virtual port channel (vPC) port only if the following occurs:

• Port security is enabled on both the vPC peers

• Port security is enabled on the vPC port on both the vPC peers.

This command does not require a license.

Examples This example shows how to enable port security on the switch:

switch# configure terminal
switch(config)# feature port-security
switch(config)#

This example shows how to disable port security on the switch:

switch# configure terminal
switch(config)# no feature port-security
switch(config)#

Related Commands

Command Description

show feature Displays the features that are enabled or disabled on the switch.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

158

OL-27880-02

Chapter F Commands

Command Description

show port-security Displays the port security configuration information.

switchport

Configures the switchport parameters to establish port security.

port-security

feature port-security

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

159

feature private-vlan

feature private-vlan

To enable private VLANs, use the feature private-vlan command. To return to the default settings, use
the no form of this command.

feature private-vlan

no feature private-vlan

Syntax Description This command has no arguments or keywords.

Command Default Private VLANs are disabled.

Command Modes Global configuration mode

Chapter F Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines The private VLAN commands are not available until you enable the private VLAN feature.

You cannot disable the private VLANs if there are operational ports on the switch that are in private
VLAN mode.

Note A private VLAN-isolated port on a Cisco Nexus device running the current release of Cisco NX-OS does

not support IEEE 802.1Q encapsulation and cannot be used as a trunk port.

Examples This example shows how to enable private VLAN functionality on the switch:

switch(config)# feature private-vlan

Related Commands

Command Description

private-vlan Configures a VLAN as either a community, isolated, or primary private

VLAN.

show vlan private-vlan Displays information on private VLANs. If the feature is not enabled, this

command is not available.

show feature Displays whether or not private VLAN is enabled on the switch.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

160

OL-27880-02

Chapter F Commands

feature udld

To enable the Cisco-proprietary Unidirectional Link Detection (UDLD) protocol, which allows ports
that are connected through fiber optics or copper Ethernet cables to monitor the physical configuration
of the cables and detect when a unidirectional link exists, use the feature udld command. To disable
UDLD on the switch, use the no form of this command.

feature udld

no feature udld

Syntax Description This command has no arguments or keywords.

Command Default UDLD is disabled.

feature udld

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Examples This example shows how to enable UDLD on the switch:

switch(config)# feature udld

Related Commands

Command Description

show udld Displays the administrative and operational UDLD status.

show feature Displays whether or not UDLD is enabled on the switch.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

161

feature vmfex

feature vmfex

To enable the Cisco Virtual Machine Fabric Extender (VM-FEX), use the feature vmfex command. To
disable VM-FEX, use the no form of this command.

feature vmfex

no feature vmfex

Syntax Description This command has no arguments or keywords.

Command Default Disabled

Command Modes Global configuration mode

Chapter F Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Before you use this command, make sure that you install and enable the virtualization feature set using

the install feature-set virtualization and feature-set virtualization commands respectively.

If you attempt to disable the VM-FEX feature with virtual Ethernet interface or port profile
configurations enabled, the switch returns an error message.

This command requires an Enhanced Layer 2 license.

Examples This example shows how to enable VM-FEX on the switch:

switch# configure terminal
switch(config)# feature vmfex
switch(config)#

This example shows how to disable VM-FEX on the switch:

switch# configure terminal
switch(config)# no feature vmfex
switch(config)#

Related Commands

Command Description

feature-set
virtualization

interface vethernet Configures a virtual Ethernet interface.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

162

Enables the virtualization features.

OL-27880-02

Chapter F Commands

feature vmfex

Command Description

install feature-set

Installs the virtualization feature set on the switch.

virtualization

port-profile Configures a port profile.

show feature Displays the features that are enabled or disabled on the switch.

show feature-set Displays the status of the virtualization feature set.

switchport mode Configures the interface as a nontrunking nontagged single-VLAN Ethernet

interface.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

163

feature vtp

feature vtp

To enable VLAN Trunking Protocol (VTP), use the feature vtp command. To disable VTP, use the no
form of this command.

feature vtp

no feature vtp

Syntax Description This command has no arguments or keywords.

Command Default Disabled

Command Modes Global configuration mode

Chapter F Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Examples This example shows how to enable VTP on the switch:

switch(config)# feature vtp

Related Commands

Command Description

show vtp status Displays the VTP information.

vtp Configures VTP.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

164

OL-27880-02

Chapter F Commands

feature-set virtualization

To enable the Cisco Virtual Machine features on the switch, use the feature-set virtualization
command. To disable the virtualization feature, use the no form of this command.

feature-set virtualization

no feature-set virtualization

Syntax Description This command has no arguments or keywords.

Command Default None

Command Modes Global configuration mode

feature-set virtualization

Command History

Usage Guidelines

Note The Cisco virtual machine feature is supported only on the Cisco Nexus devices.

Note You must install the Cisco virtual machine feature set before you enable virtualization on the switch.

Release Modification

5.2(1)N1(1) This command was introduced.

Before you use this command, make sure that you install the virtualization feature set on the switch by
using the install feature-set virtualization command.

You cannot view or access any virtualization commands until you enable a Cisco virtual machine on the
switch.

Before you disable this feature on the switch, do the following:

• Remove all virtual Ethernet interface configurations on the switch.

• Remove all virtual network tag (VNTag) configurations on the switch.

• Remove all port profiles of type vethernet.

• Change the port mode to access by using the switchport mode access command.

This command requires an Enhanced Layer 2 license.

Examples This example shows how to enable the virtualization feature on the switch:

switch# configure terminal
switch(config)# feature-set virtualization

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

165

feature-set virtualization

switch(config)#

This example shows how to disable the virtualization feature on the switch:

switch# configure terminal
switch(config)# no feature-set virtualization
switch(config)#

Related Commands Command Description

feature vmfex Enables or disables Cisco Virtual Machine Fabric Extender (VM-FEX) on

the switch.

install feature-set

Installs the virtualization feature set on the switch.

virtualization

show feature-set Displays the status of the virtualization feature set.

Chapter F Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

166

OL-27880-02

H Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with H.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

167

hardware multicast hw-hash

hardware multicast hw-hash

To use hardware hashing for multicast traffic on an EtherChannel interface, use the hardware multicast
hw-hash command. To restore the defaults, use the no form of this command.

hardware multicast hw-hash

no hardware multicast hw-hash

Syntax Description This command has no arguments or keywords.

Command Default The software selection method is used for multicast traffic.

Command Modes Interface configuration mode

Chapter H Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines By default, ingress multicast traffic on any port in the switch selects a particular EtherChannel member

to egress the traffic. To reduce potential issues with the bandwidth and to provide effective load
balancing of the ingress multicast traffic, hardware hashing is used for multicast traffic.

Note Hardware hashing is not available on a Cisco Nexus 2000 Series Fabric Extender HIF port (downlink

port).

Examples This example shows how to set the hardware hashing for multicast traffic on an EtherChannel interface:

switch(config)# interface port-channel 21
switch(config-if)# hardware multicast hw-hash
switch(config-if)#

This example shows how to restore the default software selection method for multicast traffic on an
EtherChannel interface:

switch(config)# interface port-channel 21
switch(config-if)# hardware multicast hw-hash
switch(config-if)# no hardware multicast hw-hash
switch(config-if)#

Related Commands

Command Description

show interface
port-channel

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

168

Displays the status of the EtherChannel interface configuration.

OL-27880-02

Chapter H Commands

high-performance host-netio (virtual Ethernet interface)

high-performance host-netio (virtual Ethernet interface)

To turn on high performance on the host, use the high-performance host-netio command. To disable
high performance, use the no form of this command.

high-performance host-netio

no high-performance host-netio

Syntax Description This command has no arguments or keywords.

Command Default Disabled

Command Modes Virtual Ethernet interface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines This command does not require a license.

Examples This example shows how to enable high performance on the host:

switch# configure terminal
switch(config)# interface vethernet 1
switch(config-if)# high-performance host-netio
switch(config-if)#

Related Commands

Command Description

show interface

Displays virtual Ethernet interface configuration information.

vethernet

show running-config

Displays the running configuration information for an interface.

interface

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

169

high-performance host-netio (virtual Ethernet interface)

Chapter H Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

170

OL-27880-02

I Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with I.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

171

install certificate

install certificate

To install a certificate that is used to connect to a vCenter Server, use the install certificate command.
To remove a certificate, use the no form of this command.

install certificate {bootflash:[//server/] | default}

no install certificate

Chapter I Commands

Syntax Description

bootflash:[//server/] Specifies the source or destination URL for boot flash memory to install the

certificate. The server argument value is module-1, sup-1, sup-active, or

sup-local.

default Specifies the default path.

Command Default None

Command Modes SVS connection configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines This command does not require a license.

Examples This example shows how to install a certificate to the boot flash memory:

switch# configure terminal
switch(config)# svs connection SVSConn
switch(config-svs-conn)# install certificate bootflash:///
switch(config-svs-conn)#

This example shows how to remove a certificate:

switch# configure terminal
switch(config)# svs connection SVSConn
switch(config-svs-conn)# no install certificate
switch(config-svs-conn)#

Related Commands

Command Description

show svs connections Displays SVS connection information.

svs connection Enables an SVS connection.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

172

OL-27880-02

Chapter I Commands

install feature-set virtualization

To install the Cisco virtual machine feature set on the switch, use the install feature-set virtualization
command. To remove the Cisco virtual machine feature set, use the no form of this command.

install feature-set virtualization

no install feature-set virtualization

Syntax Description This command has no arguments or keywords.

Command Default Disabled

Command Modes Global configuration mode

install feature-set virtualization

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines

Note The Cisco virtual machine feature is supported only on the Cisco Nexus 5500 Series switches.

This command requires an Enhanced Layer 2 license.

Examples This example shows how to install the Cisco virtual machine feature set on the switch:

switch# configure terminal
switch(config)# install feature-set virtualization
switch(config)#

Related Commands

Command Description

feature vmfex Enables or disables Cisco Virtual Machine Fabric Extender (VM-FEX) on

the switch.

feature-set

Enables the Cisco virtual machine feature set on the switch.

virtualization

show feature-set Displays the status of the virtualization feature set.

show running-config Displays the running system configuration information.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

173

instance vlan

instance vlan

To map a VLAN or a set of VLANs to a Multiple Spanning Tree instance (MSTI), use the instance vlan
command. To delete the instance and return the VLANs to the default instance (Common and Internal
Spanning Tree [CIST]), use the no form of this command.

Chapter I Commands

instance instance-id vlan vlan-id

no instance instance-id [vlan vlan-id]

Syntax Description

instance-id Instances to which the specified VLANs are mapped. The range is from 0 to

4094.

vlan vlan-id Specifies the number of the VLANs that you are mapping to the specified

MSTI. The VLAN ID range is from 1 to 4094.

Command Default No VLANs are mapped to any MST instance (all VLANs are mapped to the CIST instance).

Command Modes MST configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines The VLAN identifier is entered as a single value or a range.

The mapping is incremental, not absolute. When you enter a range of VLANs, this range is added to or
removed from the existing instances.

Any unmapped VLAN is mapped to the CIST instance.

Caution When you change the VLAN-to-MSTI mapping, the system restarts MST.

Examples This example shows how to map a range of VLANs to MSTI 4:

switch(config)# spanning-tree mst configuration
switch(config-mst)# instance 4 vlan 100-200

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

174

OL-27880-02

Chapter I Commands

Related Commands Command Description

show spanning-tree

Displays information about the MST protocol.

mst configuration

spanning-tree mst

Enters MST configuration mode.

configuration

instance vlan

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

175

interface ethernet

interface ethernet

To enter interface configuration mode for an Ethernet IEEE 802.3 interface, use the interface ethernet
command.

interface ethernet [chassis_ID/] slot/[QSFP-module/]port

Chapter I Commands

Syntax Description

chassis_ID (Optional) Specifies the Fabric Extender chassis ID. The chassis ID is from

slot Slot from 1 to 4. The following list defines the slots available:

QSFP-module

port Port number within a particular slot. The port number is from 1 to 128.

Command Default None

Command Modes Global configuration mode

Command History

Release Modification

6.0(2)N1(1) Support for the QSFP+ GEM was added.

5.2(1)N1(1) This command was introduced.

100 to 199.

Note This argument is not optional when addressing the host interfaces of

a Cisco Nexus 2000 Series Fabric Extender.

• Slot 1 is the fixed ports.

• Slot 2 to 4 are hot-swappable LEMs.

The QSFP-module number is 1 to 4.

Note The QSFP-module number applies only to the QSFP+ Generic

Expansion Module (GEM).

Examples This example shows how to enter configuration mode for Ethernet interface 1/4:

switch(config)# interface ethernet 1/4
switch(config-if)#

This example shows how to enter configuration mode for a host interface on a Fabric Extender:

switch(config)# interface ethernet 101/1/1
switch(config-if)#

Related Commands

Command Description

interface vethernet Configures a virtual Ethernet interface.

show fex Displays all configured Fabric Extender chassis connected to the switch.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

176

OL-27880-02

Chapter I Commands

Command Description

show interface

Displays various parameters of an Ethernet IEEE 802.3 interface.

ethernet

speed Sets the speed on the interface.

vtp (interface) Enables VLAN Trunking Protocol (VTP) on an interface.

interface ethernet

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

177

interface ethernet (Layer 3)

interface ethernet (Layer 3)

To configure a Layer 3 Ethernet IEEE 802.3 routed interface, use the interface ethernet command.

interface ethernet [chassis_ID/] {slot/[QSFP-module/]port[.subintf-port-no]}

Chapter I Commands

Syntax Description

chassis_ID (Optional) Specifies the Fabric Extender chassis ID. The chassis ID is from

slot

QSFP-module

port Port number within a particular slot. The port number is from 1 to 128.

. (Optional) Specifies the subinterface separator.

subintf-port-no (Optional) Port number for the subinterface. The range is from 1 to 48.

Command Default None

Command Modes Global configuration mode

Interface configuration mode

100 to 199.

Note This argument is not optional when addressing the host interfaces of

a Cisco Nexus 2000 Series Fabric Extender.

Slots from 1 to 4. The following list defines the slots available:

• Slot 1 are the fixed ports.

• Slots 2 to 4 are expansion modules.

The QSFP-module numbers are from 1 to 4.

Note The QSFP-module number applies only to the QSFP+ Generic

Expansion Module (GEM).

Command History

Release Modification

6.0(2)N1(1) Support for the QSFP+ GEM was added.

5.2(1)N1(1) This command was introduced.

Usage Guidelines You must use the no switchport command in the interface configuration mode to configure the interface

as a Layer 3 routed interface. When you configure the interface as a Layer 3 interface, all Layer 2 specific
configurations on this interface are deleted.

Use the switchport command to convert a Layer 3 interface into a Layer 2 interface. When you configure
the interface as a Layer 2 interface, all Layer 3 specific configurations on this interface are deleted.

Examples This example shows how to enter configuration mode for a Layer 3 Ethernet interface 1/5:

switch(config)# interface ethernet 1/5
switch(config-if)# no switchport
switch(config-if)# ip address 10.1.1.1/24
switch(config-if)#

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

178

OL-27880-02

Chapter I Commands

interface ethernet (Layer 3)

This example shows how to configure a Layer 3 subinterface for Ethernet interface 1/5 in the global
configuration mode:

switch(config)# interface ethernet 1/5.2
switch(config-if)# no switchport
switch(config-subif)# ip address 10.1.1.1/24
switch(config-subif)#

This example shows how to configure a Layer 3 subinterface in interface configuration mode:

switch(config)# interface ethernet 1/5
switch(config-if)# no switchport
switch(config-if)# interface ethernet 1/5.1
switch(config-subif)# ip address 10.1.1.1/24
switch(config-subif)#

This example shows how to convert a Layer 3 interface to a Layer 2 interface:

switch(config)# interface ethernet 1/5
switch(config-if)# no switchport
switch(config-if)# ip address 10.1.1.1/24
switch(config-if)# switchport
switch(config-if)#

Related Commands Command Description

bandwidth Sets the bandwidth parameters for an interface.

delay Configures the interface throughput delay value.

encapsulation Sets the encapsulation type for an interface.

ip address Sets a primary or secondary IP address for an interface.

inherit Assigns a port profile to an interface.

interface vethernet Configures a virtual Ethernet interface.

no switchport Configures an interface as a Layer 3 interface.

service-policy Configures a service policy for an interface.

show fex Displays all configured Fabric Extender chassis connected to the switch.

show interface

Displays various parameters of an Ethernet IEEE 802.3 interface.

ethernet

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

179

interface loopback

interface loopback

To create a loopback interface and enter interface configuration mode, use the interface loopback
command. To remove a loopback interface, use the no form of this command.

interface loopback number

no interface loopback number

Chapter I Commands

Syntax Description

number Interface number; valid values are from 0 to 1023.

Command Default None

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Use the interface loopback command to create or modify loopback interfaces.

From the loopback interface configuration mode, the following parameters are available:

• description—Provides a description of the purpose of the interface.

• ip—Configures IP features, such as the IP address for the interface, Address Resolution Protocol

(ARP) attributes, load balancing, Unicast Reverse Path Forwarding (RPF) or IP Source Guard.

• logging—Configure logging of events.

• shutdown—Shut down traffic on the interface.

This command does not require a license.

Examples This example shows how to create a loopback interface:

switch(config)# interface loopback 50
switch(config-if)# ip address 10.1.1.1/24
switch(config-if)#

Related Commands

Command Description

show interface
loopback

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

180

Displays information about the traffic on the specified loopback interface.

OL-27880-02

Chapter I Commands

interface mgmt

To enter the management interface configuration mode, use the interface mgmt command.

interface mgmt mgmt-intf-num

interface mgmt

Syntax Description

mgmt-intf-num Management interface number. The interface number is 0.

Command Default None

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Examples This example shows how to enter the management interface configuration mode:

switch# configure terminal
switch(config)# interface mgmt 0
switch(config-if)#

Related Commands

Command Description

show interface mgmt Displays information about the management interface.

cdp enable Enables the Cisco Discovery Protocol (CDP) on an interface.

description (interface) Adds a description to an interface configuration.

duplex Configures the duplex mode for an interface.

lldp (interface) Enables the reception or transmission of Link Layer Discovery Protocol

(LLDP) packets on an interface.

rate-limit cpu

Configures the packet per second (PPS) rate limit for an interface.

direction

snmp trap link-status Enables Simple Network Management Protocol (SNMP) link trap generation

on an interface.

speed Configures the transmit and receive speed for an interface.

vrf member Adds an interface to a virtual routing and forwarding (VRF) instance.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

181

interface port-channel

interface port-channel

To create an EtherChannel interface and enter interface configuration mode, use the interface
port-channel command. To remove an EtherChannel interface, use the no form of this command.

interface port-channel channel-number[.subintf-channel-no]

no interface port-channel channel-number[.subintf-channel-no]

Chapter I Commands

Syntax Description

channel-number Channel number that is assigned to this EtherChannel logical interface. The

range is from 1 to 4096.

. (Optional) Specifies the subinterface separator.

Note Applies to Layer 3 interfaces.

subintf-channel-no (Optional) Port number of the EtherChannel subinterface. The range is from

1 to 4093.

Note Applies to Layer 3 interfaces.

Command Default None

Command Modes Global configuration mode

Interface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines A port can belong to only one channel group.

When you use the interface port-channel command for Layer 2 interfaces, follow these guidelines:

• If you are using CDP, you must configure it only on the physical interface and not on the

EtherChannel interface.

• If you do not assign a static MAC address on the EtherChannel interface, a MAC address is

automatically assigned. If you assign a static MAC address and then later remove it, the MAC
address is automatically assigned.

• The MAC address of the EtherChannel is the address of the first operational port added to the

channel group. If this first-added port is removed from the channel, the MAC address comes from
the next operational port added, if there is one.

You must use the no switchport command in the interface configuration mode to configure the
EtherChannel interface as a Layer 3 interface. When you configure the interface as a Layer 3 interface,
all Layer 2 specific configurations on this interface are deleted.

Use the switchport command to convert a Layer 3 EtherChannel interface into a Layer 2 interface. When
you configure the interface as a Layer 2 interface, all Layer 3 specific configurations on this interface
are deleted.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

182

OL-27880-02

Chapter I Commands

interface port-channel

You can configure one or more subinterfaces on a port channel made from routed interfaces.

Examples This example shows how to create an EtherChannel group interface with channel-group number 50:

switch(config)# interface port-channel 50
switch(config-if)#

This example shows how to create a Layer 3 EtherChannel group interface with channel-group number
10:

switch(config)# interface port-channel 10
switch(config-if)# no switchport
switch(config-if)# ip address 192.0.2.1/24
switch(config-if)#

This example shows how to configure a Layer 3 EtherChannel subinterface with channel-group number
1 in interface configuration mode:

switch(config)# interface port-channel 10
switch(config-if)# no switchport
switch(config-if)# interface port-channel 10.1
switch(config-subif)# ip address 192.0.2.2/24
switch(config-subif)#

This example shows how to configure a Layer 3 EtherChannel subinterface with channel-group number

20.1 in global configuration mode:

switch(config)# interface port-channel 20.1
switch(config-subif)# ip address 192.0.2.3/24
switch(config-subif)#

Related Commands Command Description

encapsulation (Layer 3 interfaces) Sets the encapsulation type for an interface.

ip address (Layer 3 interfaces) Sets a primary or secondary IP address for an interface.

no switchport (Layer 3 interfaces) Configures an interface as a Layer 3 interface.

show interface Displays configuration information about interfaces.

show lacp Displays LACP information.

show port-channel

Displays information on the EtherChannels.

summary

vtp (interface) Enables VLAN Trunking Protocol (VTP) on an interface.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

183

interface vethernet

interface vethernet

To enter interface configuration mode for a virtual Ethernet (vEth) interface, use the interface vethernet
command. To remove a virtual Ethernet interface, use the no form of this command.

interface vethernet veth-id[, vethernet veth-id, ...]

no interface vethernet veth-id[, vethernet veth-id, ...]

Chapter I Commands

Syntax Description

veth-id Virtual Ethernet interface number. The range is from 1 to 1,048,575.

You can specify more than one virtual Ethernet interface. Make sure you use
the comma (,) separator.

Command Default None

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Before you use a virtual Ethernet interface, you must enable the Cisco Virtual Machine Fabric Extender

(VM-FEX) on the switch by using the feature vmfex command.

You must configure a virtual Ethernet interface on each switch. The configuration in the secondary
switch must be identical to that of the primary switch.

You can create a maximum of 1000 virtual Ethernet interfaces on a Cisco Nexus 5548 switch. Before
you disable Adapter-FEX on the switch, make sure that you delete these interfaces. After you delete a
virtual Ethernet interface, make sure that you save the running configuration of the switch to the startup
configuration file.

Examples This example shows how to enter configuration mode for virtual Ethernet interface 10:

switch# configure terminal
switch(config)# interface vethernet 10
switch(config-if)#

This example shows how to enter configuration mode for multiple virtual Ethernet interfaces:

switch# configure terminal
switch(config)# interface vethernet 10, vethernet 2
switch(config-if-range)#

This example shows how to bind an interface, configure a vEthernet access interface, assign the access
VLAN for that interface, and then assign a port profile named ppVEth, and a class of service (CoS) value
3 to a virtual Ethernet interface:

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

184

OL-27880-02

Chapter I Commands

switch# configure terminal
switch(config)# port-profile type vethernet ppVEth
switch(config-port-prof)# switchport mode access
switch(config-port-prof)# service-policy type qos input my_policy1
switch(config-port-prof)# exit
switch(config)# interface vethernet 10
switch(config-if)# bind interface ethernet 1/5 channel 10
switch(config-if)# inherit port-profile ppVEth
switch(config-if)# untagged cos 3
switch(config-if)#

This example shows how to remove a virtual Ethernet interface:

switch# configure terminal
switch(config)# no interface vethernet 2
switch(config)#

Related Commands Command Description

bind Binds an interface to a virtual Ethernet interface.

feature vmfex enables VM-FEX on the switch.

port-profile Configures a port profile.

show interface

Displays information about Ethernet interfaces.

ethernet

show interface

Displays various parameters of a virtual Ethernet interface.

vethernet

show running-config

Displays the running configuration of an interface.

interface

vethernet auto-create Sets the default policy to enable auto creation of virtual Ethernet interfaces.

interface vethernet

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

185

interface vlan

interface vlan

To create a VLAN interface and enter interface configuration mode, use the interface vlan command.
To remove a VLAN interface, use the no form of this command.

Chapter I Commands

interface vlan vlan-id

no interface vlan vlan-id

Syntax Description

vlan-id VLAN to set when the interface is in access mode; valid values are from 1

to 4094, except for the VLANs reserved for the internal switch use.

Command Default None

Command Modes Global configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Before you use this command, enable the interface-vlan feature by using the feature interface-vlan

command.

Use the interface vlan command to create or modify VLAN interfaces.

The VLAN interface is created the first time that you enter the interface vlan command for a particular
VLAN. The vlan-id argument corresponds to the VLAN tag that is associated with the data frames on
an IEEE 802.1Q-encapsulated trunk, or the VLAN ID that is configured for an access port.

This command does not require a license.

Examples This example shows how to create a VLAN interface for VLAN 50:

switch(config)# interface vlan 50
switch(config-if)#

Related Commands

Command Description

feature interface-vlan Enables the ability to create VLAN interfaces.

show interface vlan Displays information about the traffic on the specified VLAN interface.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

186

OL-27880-02

Chapter I Commands

ip igmp snooping (EXEC)

To enable Internet Group Management Protocol (IGMP), use the ip igmp snooping command. To
disable IGMP snooping, use the no form of this command.

ip igmp snooping

no ip igmp snooping

Syntax Description This command has no arguments or keywords.

Command Default IGMP snooping is enabled.

Note If the global setting is disabled, then all VLANs are treated as disabled, whether they are enabled or not.

ip igmp snooping (EXEC)

Command Modes EXEC mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Examples This example shows how to enable IGMP snooping:

switch# ip igmp snooping

Related Commands

Command Description

show ip igmp snooping Displays IGMP snooping information and configuration.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

187

ip igmp snooping (VLAN)

ip igmp snooping (VLAN)

To configure Internet Group Management Protocol (IGMP) on a VLAN, use the ip igmp snooping
command. To negate the command or return to the default settings, use the no form of this command

ip igmp snooping parameter

no ip igmp snooping parameter

Chapter I Commands

Syntax Description

parameter Parameter to configure. See the “Usage Guidelines” section for additional

information.

Command Default The default settings are as follows:

• explicit-tracking—enabled

• fast-leave—disabled for all VLANs

• last-member-query-interval seconds—1

• querier IP-address—disabled

• report-suppression—enabled

Command Modes VLAN configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Table 1 lists the valid values for parameter.

Table 1 IGMP Snooping Parameters

Keyword and Argument Description

explicit-tracking Enables tracking IGMPv3 membership reports for each port on a

fast-leave Enables IGMPv3 snooping fast-leave processing. The default is

last-member-query-interval

seconds

mrouter interface interface Configures a static connection to a multicast router. The specified

querier IP-address Configures a snooping querier. The IP address is used as the source

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

188

per-VLAN basis. The default is enabled on all VLANs.

disabled for all VLANs.

Removes the group if no hosts respond to an IGMP query message.
Valid value is from 1 to 25 seconds. The default is 1 second.

interface is Ethernet or EtherChannel.

in messages. The default is disabled.

OL-27880-02

Chapter I Commands

Table 1 IGMP Snooping Parameters (continued)

Keyword and Argument Description

report-suppression Limits the membership report traffic sent to multicast-capable

routers. When you disable report suppression, all IGMP reports are
sent as is to multicast-capable routers. The default is enabled.

static-group group-ip-addr
[source source-ip-addr]
interface interface

Configures an interface belonging to a VLAN as a static member of
a multicast group. The specified interface is Ethernet or
EtherChannel, or virtual Ethernet.

Examples This example shows how to configure IGMP snooping parameters for VLAN 5:

switch# configure terminal
switch(config)# vlan 5
switch(config-vlan)# ip igmp snooping last-member-query-interval 3
switch(config-vlan)# ip igmp snooping querier 192.168.2.106
switch(config-vlan)# ip igmp snooping explicit-tracking
switch(config-vlan)# ip igmp snooping fast-leave
switch(config-vlan)# ip igmp snooping report-suppression
switch(config-vlan)# ip igmp snooping mrouter interface ethernet 1/10
switch(config-vlan)# ip igmp snooping static-group 192.0.2.1 interface ethernet 1/10
switch(config-vlan)# ip igmp snooping static-group 192.0.2.12 interface vethernet 4/1
switch(config-vlan)#

ip igmp snooping (VLAN)

Related Commands

Command Description

show ip igmp snooping Displays the IGMP snooping information and configuration.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

189

ip igmp snooping (VLAN)

Chapter I Commands

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

190

OL-27880-02

L Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with L.

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

191

lacp graceful-convergence

lacp graceful-convergence

To configure port channel Link Aggregation Control Protocol (LACP) graceful convergence, use the
lacp graceful-convergence command. To disable graceful convergence on a port channel interface, use
the no form of this command.

lacp graceful-convergence

no lacp graceful-convergence

Syntax Description This command has no arguments or keywords.

Command Default Enabled

Command Modes Interface configuration mode

Chapter L Commands

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines You can use this command only on a port channel interface that is in an administratively down state. You

cannot configure (or disable) LACP graceful convergence on a port chanel that is in an administratively
up state. If you do so, you will see the following error message:

ERROR: Cannot set/reset lacp graceful-convergence for port-channel10 that is admin up

Note To avoid port suspension, we recommend that you disable graceful convergence on LACP ports on a peer

switch that is not running Cisco NX-OS.

This command does not require a license.

Examples This example shows how to enable LACP graceful convergence on a port channel:

switch# configure terminal
switch(config)# interface port-channel 100
switch(config-if)# shutdown
switch(config-if)# lacp graceful-convergence
switch(config-if)#

This example shows how to disable LACP graceful convergence on a port channel:

switch# configure terminal
switch(config)# interface port-channel 100
switch(config-if)# no lacp graceful-convergence
switch(config-if)#

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

192

OL-27880-02

Chapter L Commands

Related Commands Command Description

show lacp Displays LACP information.

show running-config Displays the running system configuration.

lacp graceful-convergence

OL-27880-02

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

193

lacp port-priority

lacp port-priority

To set the priority for the physical interfaces for the Link Aggregation Control Protocol (LACP), use the
lacp port-priority command. To return the port priority to the default value, use the no form of this
command.

lacp port-priority priority

no lacp port-priority

Chapter L Commands

Syntax Description

priority Priority for the physical interfaces. The range of valid numbers is from 1 to

65535.

Command Default System priority value is 32768.

Command Modes Interface configuration mode

Command History

Release Modification

5.2(1)N1(1) This command was introduced.

Usage Guidelines Each port configured to use LACP has an LACP port priority. You can configure a value between 1 and

65535. LACP uses the port priority in combination with the port number to form the port identifier. The
port priority is used with the port number to form the port identifier. The port priority is used to decide
which ports should be put into standby mode when there is a hardware limitation that prevents all
compatible ports from aggregating.

Note When setting the priority, note that a higher number means a lower priority.

Examples This example shows how to set the LACP port priority for the interface to 2000:

switch# configure terminal
switch(config)# interface ethernet 1/5
switch(config-if)# lacp port-priority 2000
switch(config-if)#

Related Commands

Command Description

show lacp Displays LACP information.

Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference

194

OL-27880-02