Cisco Nexus 5000 Series Installation manual

Cisco Nexus 5000 Series Interfaces Command Reference
First Published: 2016-04-20
Last Modified: --
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]
800 553-NETS (6387)
Fax: [phone]

©2016 Cisco Systems, Inc. All rights reserved.

CONTENTS
Preface Preface vii
Preface vii
Audience vii
Document Conventions vii
Related Documentation x
Obtaining Documentation and Submitting a Service Request x
CHAPTER 1 B Commands 1
bandwidth (interface) 2
beacon (interface) 4
CHAPTER 2 C Commands 5
carrier-delay 6
cdp 8
cdp enable 10
channel-group (Ethernet) 12
clear lacp counters 16
clear mac access-list counters 17
CHAPTER 3 D Commands 19
delay (interface) 20
description (interface) 21
duplex 23
CHAPTER 4 E Commands 25
errdisable detect cause 26
errdisable recovery cause 27
Cisco Nexus 5000 Series Interfaces Command Reference
iii

errdisable recovery interval 29
CHAPTER 5 F Commands 31
feature adapter-fex 32
feature lldp 34
feature poe 36
feature udld 37
CHAPTER 6 H Commands 39
hardware multicast hw-hash 40
high-performance host-netio (virtual Ethernet interface) 42
CHAPTER 7 I Commands 43
interface ethernet 44
interface ethernet (Layer 3) 46
interface loopback 49
interface mgmt 51
interface port-channel 53
CHAPTER 8 L Commands 57
lacp graceful-convergence 58
lacp port-priority 60
lacp rate fast 62
lacp suspend-individual 64
lacp system-priority 66
link debounce 67
load-interval 69
CHAPTER 9 M Commands 71
management 72
CHAPTER 10 N Commands 73
no switchport 74
CHAPTER 11 P Commands 77
Cisco Nexus 5000 Series Interfaces Command Reference
iv
Contents

peer-switch 78
port 79
port-channel load-balance ethernet 81
CHAPTER 12 R Commands 85
resync-database 86
CHAPTER 13 S Commands 87
shutdown 88
shutdown (virtual Ethernet interface) 90
system default switchport shutdown 91
CHAPTER 14 Show Commands 93
show cdp all 95
show cdp entry 97
show cdp global 99
show cdp interface 100
show cdp neighbors 101
show cdp traffic 105
show interface brief 107
show interface capabilities 111
show interface debounce 113
show interface ethernet 115
show interface loopback 120
show interface mac-address 124
show interface mgmt 126
show interface port-channel 128
show interface status err-disabled 130
show interface switchport 132
show interface switchport backup 137
show interface transceiver 139
show lacp 141
show port-channel capacity 143
show port-channel compatibility-parameters 144
show port-channel database 146
Cisco Nexus 5000 Series Interfaces Command Reference
v
Contents

show port-channel load-balance 148
show port-channel summary 152
show port-channel traffic 154
show port-channel usage 156
show port-security 157
show resource 159
show running-config 161
show running-config backup 162
show running-config interface 164
show running-config poe 166
show startup-config backup 167
show running-config interface 169
show tech-support 171
show tech-support poe 174
show udld 175
show vpc brief 178
CHAPTER 15 U and V Commands 181
udld (Ethernet) 182
vpc domain 184
vpc orphan-port suspend 186
Cisco Nexus 5000 Series Interfaces Command Reference
vi
Contents

Preface
•Preface, page vii
Preface
This preface describes the audience, organization, and conventions of the Book Title. It also provides
information on how to obtain related documentation.
This chapter includes the following topics:
Audience
This publication is for experienced network administrators who configure and maintain Cisco NX-OS on
Cisco Nexus 5000 Series Platform switches.
Document Conventions
Note •As part of our constant endeavor to remodel our documents to meet our customers' requirements,
we have modified the manner in which we document configuration tasks. As a result of this, you
may find a deviation in the style used to describe these tasks, with the newly included sections of
the document following the new format.
•The Guidelines and Limitations section contains general guidelines and limitations that are applicable
to all the features, and the feature-specific guidelines and limitations that are applicable only to the
corresponding feature.
Command descriptions use the following conventions:
DescriptionConvention
Bold text indicates the commands and keywords that you enter literally
as shown.
bold
Cisco Nexus 5000 Series Interfaces Command Reference
vii

DescriptionConvention
Italic text indicates arguments for which the user supplies the values.
Italic
Square brackets enclose an optional element (keyword or argument).[x]
Square brackets enclosing keywords or arguments separated by a vertical
bar indicate an optional choice.
[x | y]
Braces enclosing keywords or arguments separated by a vertical bar
indicate a required choice.
{x | y}
Nested set of square brackets or braces indicate optional or required
choices within optional or required elements. Braces and a vertical bar
within square brackets indicate a required choice within an optional
element.
[x {y | z}]
Indicates a variable for which you supply values, in context where italics
cannot be used.
variable
A nonquoted set of characters. Do not use quotation marks around the
string or the string will include the quotation marks.
string
Examples use the following conventions:
DescriptionConvention
Terminal sessions and information the switch displays are in screen font.screen font
Information you must enter is in boldface screen font.boldface screen font
Arguments for which you supply values are in italic screen font.
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.
!, #
This document uses the following conventions:
Means reader take note. Notes contain helpful suggestions or references to material not covered in the
manual.
Note
Cisco Nexus 5000 Series Interfaces Command Reference
viii
Preface
Document Conventions

Means reader be careful. In this situation, you might do something that could result in equipment damage
or loss of data.
Caution
Cisco Nexus 5000 Series Interfaces Command Reference
ix
Preface
Document Conventions

Related Documentation
Documentation for Cisco Nexus 5000 Series Switches is available at the following URL:
•Configuration Guides
http://www.cisco.com/c/en/us/support/switches/nexus-5000-series-switches/
products-installation-and-configuration-guides-list.html
•Command Reference Guides
http://www.cisco.com/c/en/us/support/switches/nexus-5000-series-switches/
products-command-reference-list.html
•Release Notes
http://www.cisco.com/c/en/us/support/switches/nexus-5000-series-switches/
products-release-notes-list.html
•Install and Upgrade Guides
http://www.cisco.com/c/en/us/support/switches/nexus-5000-series-switches/
products-installation-guides-list.html
•Licensing Guide
http://www.cisco.com/c/en/us/support/switches/nexus-5000-series-switches/
products-licensing-information-listing.html
Documentation for Cisco Nexus 5000 Series Switches and Cisco Nexus 2000 Series Fabric Extenders is
available at the following URL:
http://www.cisco.com/c/en/us/support/switches/nexus-2000-series-fabric-extenders/
products-installation-and-configuration-guides-list.html
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.
To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the What's
New in Cisco Product Documentation RSS feed. RSS feeds are a free service.
Cisco Nexus 5000 Series Interfaces Command Reference
x
Preface
Related Documentation

B Commands
•bandwidth (interface), page 2
•beacon (interface), page 4
Cisco Nexus 5000 Series Interfaces Command Reference
1

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 Informational bandwidth in kilobits per second. Valid
values are from 1 to 10000000.
kbps
(Optional) Specifies that the bandwidth be inherited
from the parent interface.
inherit
Command Default 1000000 kbps
Command Modes Interface configuration mode
Subinterface configuration mode
Command History ModificationRelease
This command was introduced.4.0(0)N1(1a)
Support for Layer 3 interfaces was added.5.0(3)N1(1)
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.
Cisco Nexus 5000 Series Interfaces Command Reference
2
B Commands
bandwidth (interface)

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)#
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 DescriptionCommand
Displays the interface configuration information.show interface
Cisco Nexus 5000 Series Interfaces Command Reference
3
B Commands
bandwidth (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 ModificationRelease
This command was introduced.4.0(1a)N2(1)
5.1(3)N1(1)
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 DescriptionCommand
Displays configuration information for an interface.show interface
Cisco Nexus 5000 Series Interfaces Command Reference
4
B Commands
beacon (interface)

C Commands
•carrier-delay, page 6
•cdp, page 8
•cdp enable, page 10
•channel-group (Ethernet), page 12
•clear lacp counters, page 16
•clear mac access-list counters, page 17
Cisco Nexus 5000 Series Interfaces Command Reference
5

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 Time, in seconds, to wait for the system to change
states. Enter an integer in the range 0 to 60.
delay-seconds
Specifies the delay time in milliseconds.msec
Time, in milliseconds, to wait for the system to
change states. Enter an integer in the range 0 to 1000.
milliseconds
Command Default None
Command Modes Interface configuration mode
Command History ModificationRelease
This command was introduced.5.1(3)N1(1)
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
Cisco Nexus 5000 Series Interfaces Command Reference
6
C Commands
carrier-delay

switch(config)# interface vlan 5
switch(config-if)# no carrier-delay
switch(config-if)#
Related Commands DescriptionCommand
Displays the running configuration information for
an interface.
show running-config interface
Cisco Nexus 5000 Series Interfaces Command Reference
7
C Commands
carrier-delay

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 Configures the version to use to send CDP
advertisements. Version-2 is the default state.
advertise {v1 |v2 }
Enables CDP for all Ethernet interfaces.enable
Configures the format of the CDP device ID.format device-id
Uses the MAC address as the CDP device ID.mac-address
Uses the serial number as the CDP device ID.serial-number
Uses the system name, which can be expressed as a
fully qualified domain name, as the CDP device ID.
This is the default.
system-name
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.
holdtime seconds
Sets the transmission frequency of CDP updates in
seconds. The range is from 5 to 254; the default is 60
seconds.
timer seconds
Command Default None
Command Modes Global configuration mode
Command History ModificationRelease
This command was introduced.4.0(0)N1(1a)
Cisco Nexus 5000 Series Interfaces Command Reference
8
C Commands
cdp

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
Related Commands DescriptionCommand
Displays Cisco Discovery Protocol (CDP)
information.
show cdp
Cisco Nexus 5000 Series Interfaces Command Reference
9
C Commands
cdp

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 modeVirtual Ethernet interface configuration mode
Command History ModificationRelease
This command was introduced.4.0(0)N1(1a)
Support was added for virtual Ethernet (vEth) interfaces.5.1(3)N1(1)
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
Cisco Nexus 5000 Series Interfaces Command Reference
10
C Commands
cdp enable