show wireless client summary
Displays a summary of all wireless clients currently associated with the controller, including their MAC addresses, IP addresses, SSIDs, and connection status, used for quick client monitoring and troubleshooting.
Definition: show wireless client summary is a Cisco IOS privileged exec command. Displays a summary of all wireless clients currently associated with the controller, including their MAC addresses, IP addresses, SSIDs, and connection status, used for quick client monitoring and troubleshooting.
Overview
The 'show wireless client summary' command is a vital tool for Cisco wireless network administrators, providing a concise yet comprehensive view of all wireless clients currently associated with a controller. This command is typically executed in privileged EXEC mode on a Cisco Wireless LAN Controller (WLC) or a switch running IOS-XE with embedded wireless capabilities. Its primary purpose is to deliver a real-time snapshot of client connectivity, including MAC addresses, IP addresses, SSIDs, and connection status. This information is crucial for quick monitoring, troubleshooting, and capacity planning in wireless networks.
At its core, this command reflects the state of the wireless control plane, where the controller maintains a database of associated clients. Each client entry includes details such as the client's MAC address (a unique hardware identifier), the IP address assigned via DHCP or static configuration, the SSID (Service Set Identifier) of the network they are connected to, and the current status (e.g., associated, authenticated, or running). The command aggregates this data from the controller's client database, which is updated in real-time as clients join, roam, or disconnect.
Network engineers reach for this command in several scenarios. First, during initial deployment or after configuration changes, it provides a quick check to ensure clients are successfully associating. Second, when troubleshooting connectivity issues, the summary can reveal whether a client is present, its IP address (to verify DHCP operation), and the SSID (to confirm it's connecting to the correct network). Third, for capacity management, the command shows the total number of clients, helping engineers identify if an access point or controller is nearing its client limit. Alternatives include 'show wireless client detail <mac>' for in-depth information about a single client, or 'show ap dot11 5ghz summary' for AP-level statistics. However, the summary command is the fastest way to get an overview.
In the broader workflow, this command is often the first step in a troubleshooting sequence. For example, if a user reports no connectivity, the engineer checks the summary to see if the client is associated. If not, they might check the AP's radio status or client exclusion policies. If the client is associated but has no IP address, they would investigate DHCP. The command is also useful for verifying client roaming: after a client moves between APs, the summary should show the same MAC with an updated AP name (if the output includes that detail).
Important IOS behavior: The command is available in privileged EXEC mode (enable mode) and does not require any special privilege level beyond 15. It has no impact on the running configuration—it is a read-only show command. Output is typically buffered, meaning it may not update in real-time if the screen is scrolling; pressing 'space' or 'enter' advances the output. On some platforms, the output can be lengthy if many clients are associated, so using filters like 'include' or 'section' can help. The command is supported on Cisco IOS-XE (e.g., Catalyst 9800 series WLCs) and earlier AireOS-based controllers, though syntax may vary slightly. It does not exist in IOS-XR or NX-OS, which have their own wireless management interfaces.
show wireless client summaryWhen to Use This Command
- Check how many clients are connected to the wireless network and their associated SSIDs.
- Identify a specific client by MAC or IP address to verify connectivity.
- Monitor client distribution across different SSIDs or VLANs.
- Troubleshoot client connectivity issues by verifying association status.
Command Examples
Basic client summary
show wireless client summaryNumber of Clients: 3 MAC Address AP Name WLAN State Protocol IP Address 00:11:22:33:44:55 AP-1 1 Run 802.11ac 192.168.1.100 AA:BB:CC:DD:EE:FF AP-2 2 Run 802.11n 10.0.0.50 11:22:33:44:55:66 AP-1 1 Run 802.11ac 192.168.1.101
Line 1: Total number of associated clients. Columns: MAC Address (client hardware address), AP Name (access point the client is associated to), WLAN (WLAN profile ID), State (Run = active, Idle, etc.), Protocol (Wi-Fi standard), IP Address (client IP).
Client summary with verbose output
show wireless client summary verboseClient MAC: 00:11:22:33:44:55 AP Name: AP-1 WLAN: 1 State: Run Protocol: 802.11ac IP Address: 192.168.1.100 VLAN: 10 RSSI: -45 dBm SNR: 35 dB Client MAC: AA:BB:CC:DD:EE:FF AP Name: AP-2 WLAN: 2 State: Run Protocol: 802.11n IP Address: 10.0.0.50 VLAN: 20 RSSI: -67 dBm SNR: 22 dB
Verbose output shows per-client details including VLAN, RSSI (signal strength, closer to 0 is better), and SNR (signal-to-noise ratio, higher is better). Good RSSI: > -65 dBm; poor: < -75 dBm.
Understanding the Output
The 'show wireless client summary' command provides a quick overview of all wireless clients. The first line shows the total count. Each row represents a client with its MAC address, associated AP, WLAN ID, state (Run means active), protocol (802.11a/b/g/n/ac/ax), and IP address.
In a real network, look for clients in 'Idle' or 'Disassociated' state to identify issues. A sudden drop in client count may indicate AP or controller problems. The verbose output adds VLAN, RSSI, and SNR for signal quality assessment.
RSSI values above -65 dBm indicate good signal, while below -75 dBm suggest weak signal. SNR above 25 dB is good; below 15 dB may cause connectivity issues.
Configuration Scenarios
Verify client connectivity after SSID configuration
After configuring a new SSID 'CorpNet' on a Cisco 9800 WLC, the network engineer needs to confirm that clients are successfully associating and obtaining IP addresses.
Topology
Client1---(WiFi)---AP1---(Switch)---WLC (192.168.1.1)Steps
- 1.Step 1: Access the WLC via SSH or console and enter privileged EXEC mode: WLC> enable
- 2.Step 2: Execute the summary command: WLC# show wireless client summary
- 3.Step 3: Review the output for the client's MAC address, IP address, and SSID 'CorpNet'.
- 4.Step 4: Verify the client status is 'Associated' or 'Run'.
! No configuration is required to run this command; it is a show command. ! However, the SSID must be configured and enabled: WLC(config)# wireless profile policy CorpNet-Policy WLC(config-wireless-policy)# description Corporate Network WLC(config-wireless-policy)# vlan 10 WLC(config-wireless-policy)# no shutdown WLC(config-wireless-policy)# exit WLC(config)# ssid CorpNet WLC(config-ssid)# security wpa2 psk set-key ascii MySecureKey123 WLC(config-ssid)# no shutdown
Verify: WLC# show wireless client summary Number of Clients: 1 MAC Address IP Address SSID Status 00:1a:2b:3c:4d:5e 192.168.10.100 CorpNet Associated
Watch out: If the client does not appear, ensure the SSID is broadcast and the client's wireless adapter is configured to connect to the correct SSID. Also, check that the client's MAC is not excluded via a filter.
Troubleshoot a client that cannot obtain an IP address
A user reports that their laptop connects to the Wi-Fi but cannot access the internet. The engineer uses the summary command to check if the client has an IP address.
Topology
Laptop---(WiFi)---AP2---(Switch)---WLC (192.168.1.1)---Router---DHCP Server (10.0.0.1)Steps
- 1.Step 1: Enter privileged EXEC mode on the WLC: WLC> enable
- 2.Step 2: Run the summary command: WLC# show wireless client summary
- 3.Step 3: Locate the client's MAC address and check the IP address field. If it shows 0.0.0.0 or 'N/A', the client has not received an IP.
- 4.Step 4: Verify DHCP settings on the WLC and the upstream DHCP server.
! Ensure the WLAN profile has DHCP required enabled: WLC(config)# wireless profile policy CorpNet-Policy WLC(config-wireless-policy)# dhcp required WLC(config-wireless-policy)# exit ! Also verify the DHCP server is reachable from the client's VLAN.
Verify: WLC# show wireless client summary Number of Clients: 1 MAC Address IP Address SSID Status 00:1a:2b:3c:4d:5e 0.0.0.0 CorpNet Associated This indicates the client is associated but has no IP address.
Watch out: A common mistake is forgetting to configure a DHCP server on the client's VLAN or having a misconfigured IP helper address on the switch interface. Also, ensure the client's firewall is not blocking DHCP.
Troubleshooting with This Command
The 'show wireless client summary' command is an essential first step in troubleshooting wireless client issues. Healthy output shows clients with valid IP addresses and a status of 'Associated' or 'Run'. Problem indicators include clients with status 'Excluded', 'Authenticating', or 'Probing', or IP addresses of 0.0.0.0. A missing client entirely suggests association failure.
Key fields to focus on: MAC address (identifies the client), IP address (indicates DHCP success), SSID (confirms correct network), and Status (shows the client state). Common symptoms: If a client shows 'Excluded', it may be blacklisted due to repeated authentication failures. If status is 'Authenticating', the client is stuck in the authentication phase, often due to incorrect PSK or RADIUS issues. If IP is 0.0.0.0, DHCP is failing.
A step-by-step diagnostic flow: 1) Run 'show wireless client summary' to see if the client is present. 2) If present, note the status and IP. 3) If IP is 0.0.0.0, check DHCP: verify the DHCP server is reachable, the VLAN has an IP helper, and the client's DHCP request is not being dropped. Use 'show ip dhcp binding' on the DHCP server. 4) If status is 'Excluded', run 'show wireless client exclusion' to see the reason. 5) If the client is not listed, check the AP's radio status with 'show ap dot11 5ghz summary' and verify the SSID is broadcast. 6) Correlate with 'debug wireless client <mac>' for detailed logs.
This command can be combined with 'show wireless client detail <mac>' for deeper analysis, or 'show ap auto-rf' to check RF interference. In a roaming scenario, if a client disappears from the summary after moving, it may indicate a roaming failure. The summary command is also useful for identifying unauthorized clients by spotting unexpected MAC addresses.
CCNA Exam Tips
CCNA exam may ask which command shows client association status; remember 'show wireless client summary'.
Know that 'Run' state means client is actively passing traffic; other states like 'Idle' or 'Authenticating' indicate issues.
Be able to identify client IP address and associated AP from the output for troubleshooting.
The verbose option provides RSSI and SNR, which are key for wireless performance analysis.
Common Mistakes
Confusing 'show wireless client summary' with 'show ap summary' which shows APs, not clients.
Assuming all clients in 'Run' state have good connectivity; they may have weak signal (low RSSI).
Forgetting to use 'verbose' when needing signal strength details.
show wireless client summary vs show ap summary
Both commands provide a quick overview of the wireless infrastructure, but they focus on different components: client devices versus access points. Network engineers often confuse them because they both display summary data from the same controller and are used for initial troubleshooting.
| Aspect | show wireless client summary | show ap summary |
|---|---|---|
| Scope | Associated wireless clients | Connected access points |
| Output Fields | Client MAC, IP, SSID, connection status | AP name, IP, status, model |
| Typical Use | Troubleshooting client connectivity issues | Verifying AP registration and health |
| Configuration Dependence | Requires wireless management enabled on controller | Requires AP successfully joined the controller |
Use show wireless client summary when you need to quickly identify client association status, IP addresses, and SSID for troubleshooting client connectivity.
Use show ap summary when you need to verify access point connectivity, model, and operational status after a deployment or reboot.
Platform Notes
On IOS-XE platforms (e.g., Catalyst 9800 series), the command syntax is 'show wireless client summary' and output includes columns like MAC Address, IP Address, SSID, Status, and sometimes AP Name and RSSI. On older AireOS-based controllers (e.g., 5508, 2504), the equivalent command is 'show client summary' with similar output. The NX-OS equivalent does not exist; NX-OS switches do not natively manage wireless clients.
For ASA firewalls, there is no direct equivalent; wireless client monitoring is done via the WLC. In IOS-XR, wireless is not supported. Differences between IOS versions: In IOS 15.x and earlier (if using a switch with embedded wireless), the command may be 'show wireless client summary' or 'show wlan client summary'.
In IOS-XE 16.x and later, the output format is more structured and may include additional fields like 'Protocol' and 'Roam Count'. Always check the specific platform documentation for exact syntax.
Related Commands
show ap summary
Displays a summary of all connected access points, including their names, IP addresses, status, and model information, used to quickly verify AP connectivity and operational state.
show wlan summary
Displays a summary of all WLANs configured on a Cisco wireless controller, used to quickly verify WLAN IDs, names, SSIDs, status, security settings, and interface bindings.
Practice for the CCNA 200-301
Test your knowledge with practice questions covering all CCNA 200-301 exam domains.
Practice CCNA 200-301 Questions