Feedback
Table Of Contents
show vpc statistics peer-keepalive
show vpc consistency-parameters
Vpc Commands
This chapter describes the Cisco NX-OS Vpc commands available on Cisco Nexus 5000 Series switches.
show running-config vpc
To display the running configuration information for virtual port channels (vPCs), use the show running-config vpc command.
show running-config vpc [all]
Syntax Description[
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to display the running configuration for a vPC:
switch (config)# show running-config vpcversion 4.1(3)N1(1)feature vpcvpc domain 1000role priority 9000peer-keepalive destination 10.193.183.56peer-config-check-bypassinterface port-channel1vpc peer-linkinterface port-channel3vpc 4096interface port-channel5vpc 4001interface port-channel12vpc 4000interface port-channel24vpc 2000interface port-channel41vpc 41interface port-channel48vpc 48Related Commands
show vpc brief
Displays information about vPCs. If the feature is not enabled, this command returns an error.
show startup-config vpc
To display virtual port-channel (vPC) configuration information in the startup-configuration, use the show startup-config vpc command.
show startup-config vpc [all]
Syntax Description[
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to display the vPC information in the startup configuration:
switch(config)# show startup-config vpcversion 4.1(3)N1(1)feature vpcvpc domain 1000peer-keepalive destination 10.193.183.56peer-config-check-bypassinterface port-channel1vpc peer-linkinterface port-channel3vpc 4096interface port-channel5vpc 4001interface port-channel12vpc 4000interface port-channel24vpc 2000Related Commands
show vpc brief
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command.
show tech-support vpc
To display detailed technical support information for virtual port-channel (vPC), use the show show tech-support vpc command.
show tech-support vpc
Syntax Description[
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to display the technical support information for virtual port-channel (vPC):
switch(config)# show tech-support vpcversion 4.1(3)N1(1)Cisco Nexus Operating System (NX-OS) SoftwareTAC support: http://www.cisco.com/tacCopyright (c) 2002-2010, Cisco Systems, Inc. All rights reserved.The copyrights to certain works contained herein are owned byother third parties and are used and distributed under license.Some parts of this software are covered under the GNU PublicLicense. A copy of the license is available athttp://www.gnu.org/licenses/gpl.html.SoftwareBIOS: version 1.3.0loader: version N/Akickstart: version 4.2(1)N1(1) [build 4.2(1)N1(0.318)]system: version 4.2(1)N1(1) [build 4.2(1)N1(0.318)]power-seq: version v1.2BIOS compile time: 09/08/09kickstart image file is: bootflash:/n5000-uk9-kickstart.4.2.1.N1.latest.binkickstart compile time: 4/7/2010 8:00:00 [04/07/2010 15:03:41]system image file is: bootflash:/n5000-uk9.4.2.1.N1.latest.binsystem compile time: 4/7/2010 8:00:00 [04/07/2010 16:14:32]Hardwarecisco Nexus5020 Chassis ("40x10GE/Supervisor")Intel(R) Celeron(R) M CPU with 2074284 kB of memory.Processor Board ID JAB1231025VDevice name: d14-switch-2bootflash: 1003520 kBKernel uptime is 0 day(s), 16 hour(s), 31 minute(s), 28 second(s)Last reset at 349684 usecs after Wed Apr 7 21:37:27 2010Reason: Reset Requested by CLI command reloadSystem version: 4.2(1)N1(1)Service:Related Commands
show vpc brief
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command.
show vpc brief
To display brief information about the virtual port channels (vPCs), use the show vpc brief command.
show vpc brief [vpc number]
Syntax Description
vpc number
(Optional) Displays the brief information for the specified vPC. The range is from 1 to 4096.
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
The show vpc brief command displays the vPC domain ID, the peer-link status, the keepalive message status, whether the configuration consistency is successful, and whether peer-link formed or the failure to form.
This command is not available if you have not enabled the vPC feature. See feature vpc for information on enabling vPCs.
You can display the track object, if you have configured a tracked object for running vPCs on a single module under the vpc-domain configuration mode. This command does not require a license.
Examples
This example shows how to display brief information about the vPCs:
switch(config)# show vpc briefLegend:(*) - local vpc is down, forwarding via vPC peer-linkvPC domain id : 10Peer status : peer adjacency formed okvPC keep-alive status : peer is aliveConfiguration consistency status: successvPC role : primaryNumber of vPC configured : 1vPC Peer-link status---------------------------------------------------------------------id Port Status Active vlans-- ---- ------ --------------------------------------------------1 Po10 up 1-100vPC status----------------------------------------------------------------------id Port Status Consistency Reason Active vlans-- ---- ------ ----------- -------------------------- ------------20 Po20 up success success 1-100This example also shows how to display brief information about the vPCs. In this example, the port channel failed the consistency check, and the device displays the reason for the failure:
switch(config)# show vpc briefLegend:(*) - local vpc is down, forwarding via vPC peer-linkvPC domain id : 10Peer status : peer adjacency formed okvPC keep-alive status : peer is aliveConfiguration consistency status: failedConfiguration consistency reason: vPC type-1 configuration incompatible - STP interface port type inconsistentvPC role : secondaryNumber of vPC configured : 1vPC Peer-link status---------------------------------------------------------------------id Port Status Active vlans-- ---- ------ --------------------------------------------------1 Po10 up 1-100vPC status----------------------------------------------------------------------id Port Status Consistency Reason Active vlans-- ---- ------ ----------- -------------------------- ------------20 Po20 up failed vPC type-1 configuration -incompatible - STPinterface port typeinconsistentThis example also shows how to display information about the tracked objects in the vPCs:
switch(config)# show vpc briefLegend:(*) - local vpc is down, forwarding via vPC peer-linkvPC domain id : 1Peer status : peer adjacency formed okvPC keep-alive status : peer is aliveConfiguration consistency status: successvPC role : secondaryNumber of vPC configured : 3Track object : 12vPC Peer-link status---------------------------------------------------------------------id Port Status Active vlans-- ---- ------ --------------------------------------------------1 Po10 up 1-100Related Commands
show tech-support vpc
Displays detailed technical support information for virtual port-channel (vPC).
show vpc peer-keepalive
To display the destination IP for the virtual port-channel (vPC) peer keepalive message and the status of the messages, use the show vpc peer-keepalive command.
show vpc peer-keepalive
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
The show vpc peer-keepalive command displays the destination IP of the peer keepalive message for the vPC. The command also displays the send and receive status as well as the last update from the peer in seconds and milliseconds
Note
We recommend that you create a separate VRF on the peer devices to send and receive the vPC peer keepalive messages. Do not use the peer link itself to send the vPC peer-keepalive messages.
This command does not require a license.
Examples
This example shows how to display information about the peer-keepalive message:
switch(config)# show vpc peer-keepalivevPC keep-alive status : peer is alive--Peer is alive for : (41024) seconds, (592) msec--Send status : Success--Last send at : 2010.04.08 14:53:00 976 ms--Sent on interface : mgmt0--Receive status : Success--Last receive at : 2010.04.08 14:53:01 5 ms--Received on interface : mgmt0--Last update from peer : (0) seconds, (818) msecvPC Keep-alive parameters--Destination : 10.193.183.56--Keepalive interval : 1000 msec--Keepalive timeout : 5 seconds--Keepalive hold timeout : 3 seconds--Keepalive vrf : management--Keepalive udp port : 3200--Keepalive tos : 192Related Commands
show vpc brief
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command.
show vpc role
To display information about the virtual port-channel (vPC) role of the peer device, use the show vpc role command.
show vpc role
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
The show vpc role command displays the following information about the vPC status:
•
•
•
•
•
•
This command is not available if you have not enabled the vPC feature. See feature vpc for information on enabling vPCs.
This command does not require a license.
Examples
This example shows how to display the vPC role information of the device that you are working on:
switch (config)# show vpc rolevPC Role status----------------------------------------------------vPC role : secondaryDual Active Detection Status : 0vPC system-mac : 00:23:04:ee:c1:e8vPC system-priority : 32667vPC local system-mac : 00:0d:ec:a3:9d:bcvPC local role-priority : 9000Related Commands
show vpc brief
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command.
show vpc statistics peer-keepalive
To display virtual port-channel (vPC) statistics, use the show vpc statistics peer-keepalive command.
show vpc statistics peer-keepalive
Syntax Description[
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
This command does not require a license.
Examples
This example shows how to display statistics about the peer-keepalive message:
switch# show vpc statistics peer-keepalivevPC keep-alive status : peer is aliveVPC keep-alive statistics----------------------------------------------------peer-keepalive tx count: 1036peer-keepalive rx count: 1028average interval for peer rx: 995Count of peer state changes: 1This example shows how to display statistics about the peer-link message:Related Commands
show vpc statistics
To display virtual port-channel (vPC) statistics, use the show vpc statistics command.
show vpc statistics {vpc <vpc_num> | peer-link}
Syntax Description[
peer-link
Displays statistics about the peer link.
the peer-keepalive message.
vpc_num
Displays statistics about the specified vPC. The range is from 1 to 4096.
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
The peer-link parameter displays the same information as the show interface port-channel channel number command for the vPC peer-link port channel.
This command does not require a license.
Examples
This example shows how to display statistics about the peer-link message:d14-switch-2# show vpc statistics peer-linkport-channel1 is upHardware: Port-Channel, address: 000d.eca3.9da5 (bia 000d.eca3.9da5)MTU 1500 bytes, BW 160000000 Kbit, DLY 10 usec,reliability 255/255, txload 1/255, rxload 1/255Encapsulation ARPAPort mode is trunkfull-duplex, 10 Gb/sBeacon is turned offInput flow-control is off, output flow-control is offSwitchport monitor is offMembers in this channel: Eth1/1, Eth1/2, Eth1/3, Eth1/4, Eth1/21, Eth1/22, Eth1/23, Eth1/24, Eth1/25, Eth1/26, Eth1/27, Eth1/28, Eth1/29, Eth1/30, Eth1/31, Eth1/32Last clearing of "show interface" counters never30 seconds input rate 2645539776 bits/sec, 4842090 packets/sec30 seconds output rate 1184009112 bits/sec, 2177802 packets/secLoad-Interval #2: 5 minute (300 seconds)input rate 2.48 Gbps, 4.55 Mpps; output rate 1.22 Gbps, 2.24 MppsRX356216924324 unicast packets 11366280385 multicast packets 0 broadcast packets367583204709 input packets 25317981509171 bytes0 jumbo packets 0 storm suppression packets0 runts 0 giants 0 CRC 0 no buffer0 input error 0 short frame 0 overrun 0 underrun 0 ignored0 watchdog 0 bad etype drop 0 bad proto drop 0 if down drop0 input with dribble 0 input discard81372137 Rx pauseTX95309974177 unicast packets 2491785887 multicast packets 0 broadcast packets97801760066 output packets 6605708744882 bytes0 jumbo packets2 output errors 0 collision 0 deferred 0 late collision0 lost carrier 0 no carrier 0 babble377039096 Tx pause7 interface resetsRelated Commands
show vpc consistency-parameters
To display the consistency of parameters that must be compatible across the virtual port-channel (vPC) interfaces, use the show vpc consistency-parameters command.
show vpc consistency-parameters {global | interface <if>}
Syntax Description
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
The show vpc consistency-parameters command displays the configuration of all the vPC Type 1 parameters on both sides of the vPC peer link.
Note
The vPC Type 1 configuration parameters are as follows:
•
•
•
•
–
–
–
•
•
•
•
–
–
–
•
–
–
–
•
•
This command is not available if you have not enabled the vPC feature. See feature vpc for information on enabling vPCs.
This command does not require a license.
Examples
This example shows how to display the vPC consistency parameters for the specified port channel:
switch (config)# show vpc consistency-parameters globalLegend:Type 1 : vPC will be suspended in case of mismatchName Type Local Value Peer Value------------- ---- ---------------------- -----------------------QoS 1 ([], [3], [0], [1-2], ([], [3], [0], [1-2],[4-5], [6]) [4-5], [6])Network QoS (MTU) 1 (1538, 2240, 5038, (1538, 2240, 5038,4038, 9216, 9216) 4038, 9216, 9216)Network Qos (Pause) 1 (F, T, T, F, F, F) (F, T, T, F, F, F)Input Queuing (Bandwidth) 1 (5, 10, 20, 0, 20, 40) (5, 10, 20, 0, 20, 40)Input Queuing (Absolute 1 (F, F, T, F, F, F) (F, F, T, F, F, F)Priority)Output Queuing (Bandwidth) 1 (5, 10, 20, 0, 20, 40) (5, 10, 20, 0, 20, 40)Output Queuing (Absolute 1 (F, F, T, F, F, F) (F, F, T, F, F, F)Priority)STP Mode 1 Rapid-PVST Rapid-PVSTSTP Disabled 1 None NoneSTP MST Region Name 1 "" ""STP MST Region Revision 1 0 0STP MST Region Instance to 1VLAN MappingSTP Loopguard 1 Disabled DisabledSTP Bridge Assurance 1 Enabled EnabledSTP Port Type, Edge 1 Normal, Disabled, Normal, Disabled,BPDUFilter, Edge BPDUGuard Disabled DisabledSTP MST Simulate PVST 1 Enabled EnabledAllowed VLANs - 1-330,333-450,1000-102 1-330,333-447,1000-1023,2000-2023 8,2000-2018Local suspended VLANs - 331-332,448-450,2019-2 -023This example shows how to display the vPC consistency parameters for the specified port channel:
switch (config)# show vpc consistency-parameters interface port-channel 20Legend:Type 1 : vPC will be suspended in case of mismatchName Type Local Value Peer Value------------- ---- ------------------------ --------------------------STP Port Type 1 Default DefaultSTP Port 1 None NoneGuardmode 1 on onSpeed 1 10 Gb/s 10 Gb/sDuplex 1 full fullPort Mode 1 trunk trunkNative Vlan 1 1 1MTU 1 1500 1500Allowed VLAN - 1-100 1-100bitsetRelated Commands
show vpc orphan-ports
To display ports that are not part of the virtual port channel (vPC) but have common VLANs, use the show vpc orphan-ports command.
show vpc orphan-ports
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
Any command mode.
Command History
Usage Guidelines
The show vpc orphan-ports command displays those ports that are not part of the vPC but that share common VLANs with ports that are part of the vPC.
This command is not available if you have not enabled the vPC feature. See feature vpc for information on enabling vPCs.
This command does not require a license.
Examples
This example shows how to display vPC orphan ports:
switch(config)# show vpc orphan portsNote:--------::Going through port database. Please be patient.::--------VLAN Orphan Ports------- -------------------------1 Po6002 Po6003 Po6004 Po6005 Po6006 Po6007 Po6008 Po6009 Po60010 Po60011 Po60012 Po60013 Po60014 Po60015 Po600Related Commands
clear vpc statistics
To clear virtual port-channel (vPC) statistics, use the clear vpc statistics command.
clear vpc statistics {all | peer-keepalive | peer-link | vpc number}
Syntax Description
Defaults
None
Command Modes
Any command mode
Supported User Rolesnetwork-admin
vdc-admin
Command History
Usage Guidelines
Use the clear vpc statistics command to clear the vPC statistics. If the feature is not enabled, this command is unavailable.
The clear vpc statistics peer-link and clear vpc statistics vpc number commands are redirected to the appropriate port channel and the clear statistics port-channel channel-number command.
This command does not require a license.
Examples
This example shows how to clear the statistics for vPC 10:
switch(config)# clear vpc statistics vpc 10switch(config) #Related Commands
show vpc statistics
Displays vPC statistical information on vPCs. If the feature is not enabled, the system displays an error when you enter this command.
