To display information that is related to the stack member or the switch stack, use the show switch command in EXEC mode.
show switch [stack-member-number | detail | neighbors | stack-ports [summary] [detail]]
Syntax Description
stack-member-number
|
(Optional) Number of the stack member. The range is 1 to 9.
|
detail
|
(Optional) Displays detailed information about the stack ring.
|
neighbors
|
(Optional) Displays the neighbors of the entire switch stack.
|
stack-ports
|
(Optional) Displays port information for the entire switch stack.
|
summary
|
(Optional) Displays the stack cable length, the stack link status, and the loopback status.
|
stack-ports detail
|
(Optional) Displays the stack link status, errors, drops, total packets transmitted and received, transmission rate, stack
link bandwidth and speed, for each stack member.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release |
Modification |
Cisco IOS XE Fuji 16.9.2
|
This command was introduced.
|
Cisco IOS XE Amsterdam 17.3.1
|
Added the keyword detail to the command – show switch stack-ports detail
|
Usage Guidelines
This command displays these states:
-
Initializing—A switch has been just added to the stack and it has not completed the basic initialization to go to the ready
state.
-
HA Sync in Progress—After the standby is elected, the corresponding switch remains in this state until the synchronization
is completed.
-
Syncing—A switch that is added to an already existing stack remains in this state until the switch add sequence is complete.
-
Ready—The member has completed loading the system- and interface-level configurations and can forward traffic.
-
V-Mismatch—A switch in version mismatch mode. Version-mismatch mode is when a switch that joins the stack has a software version
that is incompatible with the active switch.
-
Provisioned—The state of a preconfigured switch before it becomes an active member of a switch stack. The MAC address and
the priority number in the display are always 0 for the provisioned switch.
-
Unprovisioned—The state of a switch when the provisioned switch number was unprovisioned using the no switch switch-number provision command.
-
Removed—A switch that was present in the stack was removed using the reload slot command.
-
Sync not started—When multiple switches are added to an existing stack together, the active switch adds them one by one. The
switch that is being added is in the Syncing state. The switches that have not been added yet are in the Sync not started
state.
-
Lic-Mismatch—A switch has a different license level than the active switch.
A typical state transition for a stack member (including an active switch) booting up is Waiting > Initializing > Ready.
A typical state transition for a stack member in version mismatch (VM) mode is Waiting > Ver Mismatch.
You can use the show switch command to identify whether the provisioned switch exists in the switch stack. The show running-config and the show startup-config privileged EXEC commands do not provide this information.
The display also includes stack MAC-persistency wait-time if persistent MAC address is enabled.
Use the show switch stack-ports detail command to display a detailed information on the stack link of each stack member.
Examples
This example shows how to display the member 6 summary information:
Device# show switch 6
Switch# Role Mac Address Priority State
--------------------------------------------------------
6 Member 0003.e31a.1e00 1 Ready
This example shows how to display the neighbor information for a stack:
Device# show switch neighbors
Switch # Port A Port B
-------- ------ ------
6 None 8
8 6 None
This example shows how to display stack-port information:
Device# show switch stack-ports
Switch # Port A Port B
-------- ------ ------
6 Down Ok
8 Ok Down
This example shows the output for the show switch stack-ports summary command. The table that follows describes the fields in the display.
Device# show switch stack-ports summary
Switch#/ Stack Neighbor Cable Link Link Sync # In
Port# Port Length OK Active OK Changes Loopback
Status To LinkOK
-------- ------ -------- -------- ---- ------ ---- --------- --------
1/1 Down 2 50 cm No NO No 10 No
1/2 Ok 3 1 m Yes Yes Yes 0 No
2/1 Ok 5 3 m Yes Yes Yes 0 No
2/2 Down 1 50 cm No No No 10 No
3/1 Ok 1 1 m Yes Yes Yes 0 No
3/2 Ok 5 1 m Yes Yes Yes 0 No
5/1 Ok 3 1 m Yes Yes Yes 0 No
5/2 Ok 2 3 m Yes Yes Yes 0 No
Table 1. Show switch stack-ports summary Command Output
Field
|
Description
|
Switch#/Port#
|
Member number and its stack port number.
|
Stack Port Status
|
Status of the stack port.
-
Down—A cable is detected, but either no connected neighbor is up, or the stack port is disabled.
-
OK—A cable is detected, and the connected neighbor is up.
|
Neighbor
|
Switch number of the active member at the other end of the stack cable.
|
Cable Length
|
Valid lengths are 50 cm, 1 m, or 3 m.
If the switch cannot detect the cable length, the value is no cable. The cable might not be connected, or the link might be unreliable.
|
Link OK
|
Whether the stack cable is connected and functional. There may or may not be a neighbor connected on the other end.
The link partner is a stack port on a neighbor switch.
|
Link Active
|
Whether a neighbor is connected on the other end of the stack cable.
|
Sync OK
|
Whether the link partner sends valid protocol messages to the stack port.
|
# Changes to LinkOK
|
The relative stability of the link.
If a large number of changes occur in a short period of time, link flapping can occur.
|
In Loopback
|
Whether a stack cable is attached to a stack port on the member.
|
This is an example output from the show switch stack-ports detail command.
Device# show switch stack-ports detail
1/1 is OK Loopback No
Cable Length 50cm Neighbor 2
Link Ok Yes Sync Ok Yes Link Active Yes
Changes to LinkOK 1
Five minute input rate 430998 packets/sec
Five minute output rate 100989 packets/sec
2198108 packets input, 17584864 bytes
553113 packets output, 4424904 bytes
CRC Errors
Data CRC 0
Ringword CRC 0
InvRingWord 0
PcsCodeWord 0
1/2 is OK Loopback No
Cable Length 50cm Neighbor 3
Link Ok Yes Sync Ok Yes Link Active Yes
Changes to LinkOK 1
Five minute input rate 743042 packets/sec
Five minute output rate 79830 packets/sec
3765816 packets input, 30126528 bytes
439001 packets output, 3512008 bytes
CRC Errors
Data CRC 0
Ringword CRC 0
InvRingWord 0
PcsCodeWord 0
…..
….
…
….
Table 2. show switch stack-ports detail Command Output
Field
|
Description
|
Neighbor
|
Switch number of the active member at the other end of the stack cable.
|
Cable Length
|
Valid lengths are 50 cm, 1 m, or 3 m.
If the switch cannot detect the cable length, the value is Unknown. The cable might not be connected, or the link might be unreliable.
|
Link OK
|
Whether the stack cable is connected and functional. There may or may not be a neighbor connected on the other end.
The link partner is a stack port on a neighbor switch.
|
Link Active
|
Whether a neighbor is connected on the other end of the stack cable.
|
Sync OK
|
Whether the link partner sends valid protocol messages to the stack port.
|
# Changes to LinkOK
|
The relative stability of the link.
If a large number of changes occur in a short period of time, link flapping can occur.
|
Five minute input rate
|
The average rate (calculated over a five minute period) at which packets are received, measured in packets/sec.
|
Five minute output rate
|
The average rate (calculated over a five minute period) at which packets are transmitted, measured in packets/sec.
|
CRC Errors
|
Different types of Cyclic Redundancy Check (CRC) errors that are seen on a stack interface:
-
Data CRC: Stack interface data CRC error
-
Ringword CRC: Stack interface ring word CRC error
-
InvRingWord: Stack interface invalid ring word error
-
PcsCodeWord: Stack interface Physical Coding Sublayer (PCS) error
These errors normally occur when a stack interface state changes due to a switchover or a switch reload. You can ignore such
errors.
But when these error counters increase significantly or when they increase continuously over a period of time, check the stack
cable for issues.
Use the clear counters command to clear the stack counters for all ports.
|