Cisco Nexus 5500 Series Operating manual

1
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
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
bars.
string A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.

2
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter
Screen examples use these conventions:
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
screen font Terminal sessions and information that the switch displays are in screen font.
boldface screen
font
Information you must enter is in boldface screen font.
italic screen font Arguments for which you supply values are in italic 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.

3
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
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 nexu[email protected]. 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.

4
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter

17
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
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. •B Commands
•C Commands
•D Commands
•I Commands
•M Commands
•S Commands
•Show Commands

18
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter

11
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
B Commands
This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with B.

12
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter B Commands
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]}
Syntax Description
Command Default 1000000 kbps
Command Modes Interface configuration mode
Subinterface configuration mode
Command History
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)#
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.
Release Modification
5.2(1)N1(1) This command was introduced.

13
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter B Commands
bandwidth (interface)
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.

14
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter B Commands
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
Command History
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
Release Modification
5.2(1)N1(1) This command was introduced.
Command Description
show interface Displays configuration information for an interface.

15
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter B Commands
bind (virtual Ethernet interface)
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
Syntax Description
Command Default Disabled
Command Modes Virtual Ethernet interface configuration mode
Command History
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
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.
Release Modification
6.0(2)N1(2) Support for the QSFP+ GEM.
5.2(1)N1(1) This command was introduced.
Command Description
interface vethernet Configures a virtual Ethernet interface.
show interface
ethernet
Displays information about Ethernet interfaces.

16
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter B Commands
bind (virtual Ethernet interface)
show interface
vethernet
Displays the specified virtual Ethernet interface, attributes, and status.
show running-config
interface
Displays the running configuration of an interface.
Command Description

17
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
C Commands
This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with C.

18
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter C Commands
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
Syntax Description
Command Default None
Command Modes Virtual Ethernet interface configuration mode
Command History
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
iscsi-multipath Configure an iSCSI multipath profile.
Release Modification
5.2(1)N1(1) This command was introduced.
Command Description
interface vethernet Configures a virtual Ethernet interface.
show interface
vethernet
Displays the specified virtual Ethernet interface, attributes, and status.
show running-config
interface
Displays the running configuration of an interface.

19
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter C Commands
carrier-delay
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 {delay-seconds | msec milliseconds}
no carrier-delay
Syntax Description
Command Default None
Command Modes Interface configuration mode
Command History
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)#
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.
Release Modification
5.2(1)N1(1) This command was introduced.

110
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter C Commands
carrier-delay
Related Commands Command Description
show running-config
interface
Displays the running configuration information for an interface.

111
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
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
Command Default None
Command Modes Global configuration mode
Command History
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
advertise {v1 | v2} Configures the version to use to send CDP advertisements. Version-2 is the
default state.
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
name, as the CDP device ID. This is the default.
holdtime seconds Specifies the amount of time a receiver should hold CDP information before
discarding it. The range is from 10 to 255 seconds; the default is 180
seconds.
timer seconds Sets the transmission frequency of CDP updates in seconds. The range is
from 5 to 254; the default is 60 seconds.
Release Modification
5.2(1)N1(1) This command we introduced.

112
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter C Commands
cdp
Related Commands Command Description
show cdp Displays Cisco Discovery Protocol (CDP) information.

113
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter C Commands
cdp enable
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
Command History
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
Release Modification
5.2(1)N1(1) This command was introduced.

114
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter C Commands
cdp enable
Related Commands Command Description
show cdp Displays Cisco Discovery Protocol (CDP) information.
show interface Displays the interface configuration information.