Upgrade Guide for Cisco Catalyst 9000 Series Switches and Smart Switches

PDF

Upgrade Guide for Cisco Catalyst 9000 Series Switches and Smart Switches

Command set for system and application health checks

Want to summarize with AI?

Log in

Lists the command set for performing system and application health checks on switches, covering core, redundancy, StackWise, StackWise Virtual, network services, and application hosting checks, as well as additional commands for troubleshooting abnormal conditions across various hardware and feature configurations.


This topic describes how to select and use appropriate system and application health check commands for different switch platforms and configurations, enabling consistent pre- and post-upgrade assessments and effective troubleshooting of core, redundancy, stacking, network service, and application hosting operations.

Use this command set as a reference for selecting the checks that apply to a specific switch, topology, and configured feature set.

Run the same checks before and after the upgrade. Allow the network to reconverge, then compare the results with the pre-upgrade baseline.

The commands are read-only. Some commands apply only to a stack, modular chassis, StackWise Virtual system, ISSU-capable system, or a switch using application hosting.

The reference sessions are illustrative. Exact fields and values vary by model, topology, configuration, and IOS XE release. Comment lines in the examples explain the command output and are not generated by the device.

Core checks for every switch

terminal length 0
show clock
show version
show boot
show install summary

show platform resources
show platform software status control-processor brief
show processes cpu sorted
show processes cpu history
show processes memory sorted

show environment all
show interfaces status
show interfaces status err-disabled
show interfaces counters errors
show etherchannel summary
show spanning-tree summary totals
show spanning-tree inconsistentports
show ip interface brief
show ip route summary

show logging | last 100
show license summary

ISSU and redundancy checks

Run these only on an ISSU-capable dual-supervisor, StackWise, or StackWise Virtual system.

The show install issu history is available in Cisco IOS XE 16.10.1, and later. An ISSU path must still be approved by the current Cisco compatibility matrix.


show issu state detail
show install issu history
show redundancy
show redundancy states

show redundancy config-sync failures mcl
show redundancy config-sync failures prc
show redundancy config-sync failures bem
show redundancy counters
show redundancy switchover history

Physical StackWise checks


show switch detail
show switch stack-ring speed
show switch stack-ports summary
show switch stack-ports detail

StackWise Virtual checks


show stackwise-virtual link
show stackwise-virtual bandwidth
show stackwise-virtual neighbors
show stackwise-virtual dual-active-detection

Configured network-service checks

Run only the protocols used by the switch.

For a non-default VRF, use the corresponding VRF-aware command.


show ip ospf neighbor summary
show ip eigrp neighbors
show ip bgp summary
show isis neighbors
show bfd neighbors details
show standby brief
show vrrp brief

Optional application-hosting checks


show iox-service
show app-hosting list
show app-hosting detail appid <APP_ID>
show app-hosting utilization appid <APP_ID>

Additional checks for further analysis

Use these additional set of commands to troubleshoot if any of the checks done earlier fails or gives an error.

The switch active, R0, F0, module, and location syntax vary by platform. Use command help (?) to select the one supported by the switch.


show install log
show processes cpu platform sorted 5min location switch active R0
show processes memory platform sorted location switch active R0
show platform software process list switch active R0 summary
show platform software object-manager switch active F0 statistics
show diagnostic result module all detail
show logging onboard switch active uptime detail
dir crashinfo: