- show ip arp vpc-statistics
- show port-profile
- show port-profile brief
- show port-profile expand-interface
- show port-profile name
- show port-profile usage
- show running-config expand-port-profile
- show running-config port-profile
- show running-config switch-profile
- show running-config vpc
- show startup-config interface
- show startup-config port-profile
- show startup-config switch-profile
- show startup-config vpc
- show switch-profile
- show switch-profile buffer
- show switch-profile peer
- show switch-profile session-history
- show switch-profile status
- show tech-support vpc
- show version
- show vpc
- show vpc brief
- show vpc consistency-parameters
- show vpc orphan-ports
- show vpc peer-keepalive
- show vpc role
- show vpc statistics
Show Commands
This chapter describes the Cisco NX-OS virtual port channel (vPC) show commands.
show ip arp vpc-statistics
To display the global statistics for the Address Resolution Protocol (ARP) on a virtual port channel (vPC), use the show ip arp vpc-statistics command.
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Usage Guidelines
Examples
This example shows how to display the global ARP statistics on vPCs:
Related Commands
|
|
---|---|
show port-profile
To display the port profiles configured on a switch, use the show port-profile command.
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Usage Guidelines
Use this command to view the configuration information of the port profiles configured on the switch and the interfaces that inherited the port profiles.
Examples
This example shows how to display the port profiles configured on the switch:
Table 1 describes the fields shown in the display.
Related Commands
|
|
---|---|
Copies the running configuration to the startup configuration. |
|
show port-profile brief
To display brief information about the port profiles configured on a switch, use the show port-profile brief command.
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Usage Guidelines
Use this command to view the number of interfaces that inherited the port profile, the number of child port profiles, and the number of commands configured in, or inherited to, a port profile.
Examples
This example shows how to display brief information about the port profiles configured on the switch:
Table 2 describes the fields shown in the display:
Related Commands
|
|
---|---|
Copies the running configuration to the startup configuration. |
|
show port-profile expand-interface
To display the active port profile configurations that are applied to an interface, use the show port-profile expand-interface command.
show port-profile expand-interface [ pp-profile-name ]
Syntax Description
(Optional) Name of the port profile. The name can be a maximum of 80 alphanumeric characters and can include an underscore and hyphen. The name cannot contain spaces or special characters. |
Command Default
Command Modes
Command History
|
|
---|---|
Usage Guidelines
Use this command to view the port profile configuration that is applied to an interface.
Examples
This example shows how to display the port profile configurations applied to the assigned interfaces:
This example shows how to display a specific port profile configuration assigned to an interface:
Related Commands
|
|
---|---|
Copies the running configuration to the startup configuration. |
|
show port-profile name
To display the configuration information of specific port profiles, use the show port-profile name command.
show port-profile name pp-profile-name
Syntax Description
Name of the port profile. The name can be a maximum of 80 alphanumeric characters and can include an underscore and hyphen. The name cannot contain spaces or special characters. |
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the configuration information of a port profile named ppEth:
Table 3 describes the fields shown in the display:
Related Commands
|
|
---|---|
Copies the running configuration to the startup configuration. |
|
show port-profile usage
To display the list of interfaces that inherited a port profile, use the show port-profile usage command.
show port-profile usage [ pp-profile-name ]
Syntax Description
(Optional) Name of the port profile. The name can be a maximum of 80 alphanumeric characters and can include an underscore and hyphen. The name cannot contain spaces or special characters. |
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the assigned interfaces for port profiles configured on the switch:
This example shows how to display the interfaces attached to a port profile named ppEth:
Related Commands
|
|
---|---|
Copies the running configuration to the startup configuration. |
|
show running-config expand-port-profile
To display the detailed running configuration for a port profile, use the show running-config expand expand-port-profile command.
show running-config expand-port-profile
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the running configuration for an expanded port profile:
Related Commands
|
|
---|---|
Displays the running configuration with port profile configurations. |
show running-config port-profile
To display the running configuration of a port profile, use the show running-config port-profile command.
show running-config port-profile [ pp-profile-name ]
Syntax Description
Name of the port profile. The name can be a maximum of 80 alphanumeric characters and can include an underscore and hyphen. The name cannot contain spaces or special characters. |
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the running configuration of all port profiles that are configured on the switch:
This example shows how to display the running configuration of a port profile named ppEth that is configured on the switch:
Related Commands
|
|
---|---|
Displays the startup configuration information for the switch profile. |
show running-config switch-profile
To display the running configuration of a switch profile, use the show running-config switch-profile command.
show running-config switch-profile
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the running configuration of a switch profile named s5010 configured on switch 1 of the peer:
Related Commands
|
|
---|---|
Displays the startup configuration information for the switch profile. |
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[
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the running configuration for a vPC on a switch that runs Cisco NX-OS Release 4.1(2):
This example shows how to display the running configuration for a vPC on a switch that runs Cisco NX-OS Release 4.2(1):
This example shows how to display the vPC reload configuration on a switch that runs Cisco NX-OS Release 5.0(2)N1(1):
This example shows how to display the vPC automatic recovery configuration on a switch that runs Cisco NX-OS Release 5.0(2)N2(1):
Related Commands
|
|
---|---|
Displays information about vPCs. If the feature is not enabled, this command returns an error. |
show startup-config interface
To display interface configuration information in the startup configuration, use the show startup-config interface command.
show startup-config interface [ ethernet slot / port | expand-port-profile | loopback number | mgmt 0 | port-channel { channel-number } [ membership ] | tunnel number | { vlan vlan-id }
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the information in the startup configuration for the interface Ethernet 7/1:
Related Commands
|
|
---|---|
show startup-config port-profile
To display the startup configuration of port profiles, use the show startup-config port-profile command.
show startup-config switch-profile [ pp-profile-name ]
Syntax Description
(Optional) Name of the port profile. The name can be a maximum of 80 alphanumeric characters and can include an underscore and hyphen. The name cannot contain spaces or special characters. |
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the configuration information of all port profiles stored in the startup configuration file:
This example shows how to display the startup configuration of a port profile named ppPO that is configured for port channel interfaces on the switch:
This example shows how to display the startup configuration of a port profile named ppEth that is configured for Ethernet interfaces on the switch:
Related Commands
|
|
---|---|
Copies the running configuration to the startup configuration. |
|
Displays the running configuration information for a switch profile. |
show startup-config switch-profile
To display the startup configuration of a switch profile, use the show startup-config switch-profile command.
show startup-config switch-profile
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the startup configuration of a switch profile named s5010 that is configured on switch 1 of the peer:
Related Commands
|
|
---|---|
Copies the running configuration to the startup configuration. |
|
Displays the running configuration information for a switch profile. |
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
(Optional) Displays startup-configuration information for all vPCs. |
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the vPC information in the startup configuration:
Related Commands
|
|
---|---|
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command. |
show switch-profile
To display the switch profile configured on the switch, use the show switch-profile command.
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the switch profile that is configured on switch 1 of the peer:
Table 4 describes the fields shown in the display:
|
|
---|---|
The revision of the switch profile configuration. The revision number is used to synchronize the configuration in the peer switch. |
Related Commands
|
|
---|---|
show switch-profile buffer
To display the switch profile buffer, use the show switch-profile buffer command.
show switch-profile sw-profile-name buffer
Syntax Description
Name of the switch profile. The name is case sensitive, can be a maximum of 64 alphanumeric characters and can include an underscore, and hyphen. The name cannot contain spaces or special characters. |
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the buffer for the switch profile named s5010:
Table 5 describes the fields shown in the display:
|
|
---|---|
The sequence number or order of entry of the command in the switch profile buffer. |
|
Related Commands
|
|
---|---|
show switch-profile peer
To display information about the destination peer switch in a switch profile configuration, use the show switch-profile peer command.
show switch-profile sw-profile-name peer ip-address
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the information about a destination peer switch with IPv4 address 192.168.120.3 added to the switch profile named s5010 on switch 1 of the peer:
This example shows how to display the successful commit information about a destination peer switch with IPv4 address 192.168.120.3 for the switch profile named s5010 on switch 1 of the peer:
Table 6 describes the fields shown in the display.
Related Commands
|
|
---|---|
Configures the peer switch for configuration synchronization. |
show switch-profile session-history
To display the session history of the switch profile configuration, use the show switch-profile session-history command.
show switch-profile sw-profile-name session-history
Syntax Description
Name of the switch profile. The name is case sensitive, can be a maximum of 64 alphanumeric characters and can include an underscore and hyphen. The name cannot contain spaces or special characters. |
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the session history of the switch profile named s5010 on switch 1 of the peer:
Table 7 describes the fields shown in the display:
Related Commands
|
|
---|---|
show switch-profile status
To display the switch profile configuration status, use the show switch-profile command.
show switch-profile sw-profile-name status
Syntax Description
Name of the switch profile. The name is case sensitive, can be a maximum of 64 alphanumeric characters and can include an underscore and hyphen. The name cannot contain spaces or special characters. |
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the status of the switch profile named s5010 on switch 1 of the peer:
Table 8 describes the fields shown in the display:
Related Commands
|
|
---|---|
show tech-support vpc
To display troubleshooting information about the virtual port channel (vPC), use the show tech-support vpc command.
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the vPC troubleshooting information:
Related Commands
|
|
---|---|
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command. |
show version
To display information about the software and hardware version, use the show version command.
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the version information of a switch that runs Cisco NX-OS Release 4.2(1)N1(1):
This example shows how to display the version information for the kickstart and system image running on a device that runs Cisco NX-OS Release 5.0(2)N2(1):
Related Commands
|
|
---|---|
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command. |
show vpc
To display detailed information about the virtual port channels (vPCs) configured on the switch, use the show vpc command.
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Examples
This example shows how to display the vPC information:
This example shows how to display information about a specific vPC:
Related Commands
|
|
---|---|
show vpc brief
To display brief information about the virtual port channels (vPCs), use the show vpc brief command.
Syntax Description
(Optional) Displays the brief information for the specified vPC. The range is from 1 to 4096. |
Command Default
Command Modes
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 a peer link formed or failed to form.
This command is not available if you have not enabled the vPC feature. See the feature vpc command for information about enabling vPCs.
You can display the track object if you have configured a tracked object for running vPCs on a single module in the vpc-domain configuration mode.
Examples
This example shows how to display brief information about the vPCs on a switch that runs Cisco NX-OS Release 4.1(3)N1(1):
This example 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:
This example shows how to display information about the tracked objects in the vPCs:
This example shows how to display the vPC configuration, including the Graceful Type-1 Consistency configuration, on a switch that runs Cisco NX-OS Release 5.0(2)N2(1):
Related 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 port-channel channel-number | vlans | vpc number }
Syntax Description
Command Default
Command Modes
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 All the Type 1 configurations must be identical on both sides of the vPC peer link, or the link will not come up.
The vPC Type 1 configuration parameters are as follows:
- Port-channel mode: on, off, or active
- Link speed per channel
- Duplex mode per channel
- Trunk mode per channel
– Tagging of native VLAN traffic
- Spanning Tree Protocol (STP) mode
- STP region configuration for Multiple Spanning Tree
- Enable/disable state the same per VLAN
- STP global settings
– Port type setting—We recommend that you set all vPC peer link ports as network ports.
This command is not available if you have not enabled the vPC feature. See feature vpc for information on enabling vPCs.
Examples
This example shows how to display the vPC global consistency parameters on a switch that runs Cisco NX-OS Release 4.1(3)N1(1):
This example shows how to display the vPC global consistency parameters on a switch that runs Cisco NX-OS Release 5.0(2)N2(1):
This example shows how to display the vPC consistency parameters for the specified port channel on a switch that runs Cisco NX-OS Release 4.1(3)N1(1):
This example shows how to display the vPC consistency parameters for the specified port channel on a switch that runs Cisco NX-OS Release 5.0(2)N2(1):
This example shows how to display the vPC consistency parameters for the specified vPC on a switch that runs Cisco NX-OS Release 4.1(3)N1(1):
This example shows how to display the vPC consistency parameters for VLANs on a switch that runs Cisco NX-OS Release 4.1(3)N1(1):
Related Commands
|
|
---|---|
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command. |
|
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.
Syntax Description
Command Default
Command Modes
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 the feature vpc command for information about enabling vPCs.
Examples
This example shows how to display vPC orphan ports:
Related Commands
|
|
---|---|
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.
Syntax Description
Command Default
Command Modes
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 is not available if you have not enabled the vPC feature. See the feature vpc command for information about enabling vPCs.
Examples
This example shows how to display information about the peer-keepalive message:
Related Commands
|
|
---|---|
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.
Syntax Description
Command Default
Command Modes
Command History
|
|
---|---|
Usage Guidelines
The show vpc role command displays the following information about the vPC status:
- Status of peer adjacency
- vPC role
- vPC MAC address
- vPC system priority
- MAC address of the device that you are working on
- System priority for the device that you are working on
This command is not available if you have not enabled the vPC feature. See the feature vpc command for information on enabling vPCs.
Examples
This example shows how to display the vPC role information of the device that you are working on:
When you reload the primary vPC peer device, the secondary vPC peer device assumes the role of the primary device. This example shows how the vPC role displays then on the new primary device:
Related Commands
|
|
---|---|
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command. |
|
show vpc statistics
To display virtual port-channel (vPC) statistics, use the show vpc statistics command.
show vpc statistics { peer-keepalive | peer-link | vpc number }
Syntax Description
Displays statistics about the specified vPC. The range is from 1 to 4096. |
Command Default
Command Modes
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.
The vpc number parameter displays the same information as the show interface port-channel channel number command for the specified vPC port channel.
This command is not available if you have not enabled the vPC feature. See the feature vpc command for information on enabling vPCs.
Examples
This example shows how to display statistics about the peer-keepalive message:
Related Commands
|
|
---|---|
Displays information about vPCs. If the feature is not enabled, the system displays an error when you enter this command. |
|