show ap arm client-match summary

show ap arm client-match summary [client-mac ]|[advanced]|[brief]

Description

If the client match feature is enabled, the output of this command shows the history of AP association changes triggered by the client match feature.

Parameter

Description

client-mac

MAC address of a client for which you want to view a history of AP association changes triggered by the client match feature.

advanced

Displays advanced debugging information. Include this parameter only under the supervision ofArubasupport.

brief

Displays brief statistical information containing the final calculated data of the output parameters.

Example

The following command displays information on the Client Match summary. (For versions prior toArubaOS8.10.0.0.)

((host) [mynode](config) #show ap arm client-match summary

SM: Sticky Moves, BM: Bandsteer Moves, LM: Load Balance Moves, MU: MUsteer Moves, VoM: Voice Roam M oves, HM: HE Moves

T: Total, S: Success

ACC: Accept, REJ#: Reject with reason #, TO: Timeout FA: False Accept

11v Move Format: (T/ACC/REJ1/REJ2/REJ3/REJ4/REJ5/REJ6/REJ7/REJ8/TO/FA)

Client Match Summary

---------------------

MAC SM (T/S) LM (T/S) BM (T/S) MU (T/S) VoM (T/S) HM (T/S) Moves (T/S) Last Move (Time/Rsn/ Dur)) Device Type 11v Moves

--- -------- -------- -------- -------- --------- -------- ----------- -------------------- ----- ----------- ---------

Total clients:0

Sticky (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0

负载平衡(T / S): 0/0 Deauth (T / S): 0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0

Band-steer (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0

Voice-roam (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0

MU-Steer (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0

HE-steer (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0

The following command displays information on the Client Match summary. (ForArubaOS8.10.0.0 or later versions.)

(host) [mynode] (config) #show ap arm client-match summary SM: Sticky Moves, B5G: Bandsteer Moves to 5GHz, LM: Load Balance Moves, MU: MUsteer Moves, VoM: Voice Roam Moves, HM: HE Moves, HP: HE Pooling Moves, B6G: Bandsteer Moves to 6GHz T: Total, S: Success ACC: Accept, REJ#: Reject with reason #, TO: Timeout FA: False Accept 11v Move Format: (T/ACC/REJ1/REJ2/REJ3/REJ4/REJ5/REJ6/REJ7/REJ8/TO/FA) Client Match Summary --------------------- MAC SM (T/S) LM (T/S) B5G (T/S) MU (T/S) VoM (T/S) HM (T/S) HP (T/S) B6G (T/S) Moves (T/S) Last Move (Time/Rsn/Dur)) Device Type 11v Moves --- -------- -------- --------- -------- --------- -------- -------- --------- ----------- ------------------------- ----------- --------- fc:b3:bc:43:f9:13 4/4 0/0 39/0 0/0 3/1 0/0 0/0 0/0 46/5 Oct 27 12:00:46 2021/Band-steer to 5GHz/X 39/1/0/0/0/0/0/0/2/0/23/13 Total clients:1 Sticky (T/S):4/4 Deauth (T/S):4/4 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0 Load-balance (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0 Band-steer to 5GHz (T/S):39/0 Deauth (T/S):0/0 11v-BTM: 39/1/0/0/0/0/0/0/2/0/23/13 Voice-roam (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0 MU-Steer (T/S):3/1 Deauth (T/S):3/1 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0 HE-steer (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0 HE-pooling (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0 Band-steer to 6GHz (T/S):0/0 Deauth (T/S):0/0 11v-BTM: 0/0/0/0/0/0/0/0/0/0/0/0

The output of this command includes the following parameters.

Column Description

MAC

MAC address of the client that was moved to a different AP radio.

SM (T/S)
Sticky Moves

The output of this column shows the following two values:

T:总数乘以端匹配特性attempted to move a mobile roaming client because it was staying associated (sticking) to a sub-optimal AP.

S: Number of times the client match successfully moved a mobile roaming client because it was staying associated (sticking) to a sub-optimal AP.

LM (T/S)
Load Balance Moves

The output of this column shows the following two values:

T:总数乘以端匹配特性attempted to move an AP to a different radio on dual-radio AP to balance the client load between the AP radios.

S: Number of times the client match feature successfully moved an AP to a different radio on dual-radio AP to balance the client load between the AP radios.

BM (T/S)
Bandsteer Moves (For versions prior toArubaOS8.10.0.0.)

The output of this column shows the following two values:

T:总数乘以端匹配特性attempted to steer a dual-band client to a 5 GHz radio.

S: Number of times the client match feature successfully moved a dual-band client to a 5 GHz radio.

B5G (T/S)
Bandsteer Moves to 5GHz(ForArubaOS8.10.0.0 or later versions)

The output of this column shows the following two values:

T:总数乘以端匹配特性attempted to steer a dual-band client to a 5 GHz radio.

S: Number of times the client match feature successfully moved a dual-band client to a 5 GHz radio.

B6G (T/S)
Bandsteer Moves to 6GHz (ForArubaOS8.10.0.0 or later versions)

The output of this column shows the following two values:

T:总数乘以端匹配特性attempted to steer a dual-band client to a 6 GHz radio.

S: Number of times the client match feature successfully moved a dual-band client to a 6 GHz radio.

MU (T/S)
MU steer Moves

The output of this column shows the following two values:

T: Total number of times the Client Match feature attempted to steer and align MU-MIMO-capable clients with MU-MIMO-capable radios.

S: Number of times the client match feature successfully moved an AP to a different radio.

VoM (T/S)
Voice Roam Moves

The output of this column shows the following two values:

T:总数乘以端匹配特性attempted to move a voice client roaming from one AP BSS to another AP BSS using the same SSID.

S: Number of times the client match feature successfully moved a roaming voice client roaming from one AP BSS to another using AP BSS the same SSID.

Moves(T/S)

The output of this column shows the following two values:

T:总数乘以端匹配特性attempted to move an AP to a different radio.

S: Number of times the client match feature successfully moved an AP to a different radio.

Last Move

This column shows the date and time the client was steered to a different AP radio, the reason why the client match feature made the change, and the number of seconds it took for the change to take place. Possible reasons include:

Sticky: A mobile roaming client was staying associated (sticking) to a sub-optimal AP for too long.

Band steer: A dual-band capable client was steered toward a 5Ghz radio on a dual-band AP.

Band Balance: A dual-band capable client was steered toward a different radio to balance the load between the two radios on a single AP.

Load Balance: Client match moved the client to a different AP, based upon the load on APs in the client's RF neighborhood, and the SNR levels the client detected from each underutilized AP.

HE-Steer:A HE capable client was steered to a HE capable AP on the same band.

Device type

Type of client, if the value can be determined.

11v Moves (T/ACC/REJ1/REJ2/REJ3/REJ4
/REJ5/REJ6/REJ7/REJ8/TO/FA)

The output of this column shows the following values:

T:总数乘以端匹配特性attempted to move an AP to a different radio using the 802.11v BSS transition management request.

ACC: Number of times a client returned a 802.11v accept message.

REJ1: Move Rejected; unspecified reject reason

REJ2: Move Rejected; Insufficient Beacons

REJ3: Move Rejected; Insufficient capacity

REJ4: Move Rejected; BSS Termination undesired

REJ5: Move Rejected; BSS Termination Delay requested

REJ6:Move Rejected; STA BSS Trans List provided

REJ7: Move Rejected; No Suitable candidate

REJ8: Move Rejected; Leaving ESS

TO: Number of times the dot11v BSS transition management request timed out because the client failed to acknowledge the 802.11v BSS transition management request from the AP.

FA: Number of false accepts, where the client responds to a move request with an accept message, but fails to move to the destination radio and remains on the same radio.

Related Commands

Command

Description

rf arm-profile

This command enables ClientMatch.

show ap arm client-match probe-report

This command displays the client probe report for the specified AP.

show ap arm client-match neighbors

This command displays the BSSID of other APs seen by clients in the select AP's RF neighborhood.

show ap arm virtual-beacon-report

This command displays the virtual beacon report for an AP with a specific IP or MAC address.

show ap arm client-match unsupported

This command displays a list of clients that failed to be steered to a more optimal AP, and the reason the initial steering request was triggered.

show ap arm client-match history

This command shows the history of AP association changes triggered by the client match feature.

show ap arm client-match restriction-table

This command displays the list of clients that ClientMatch has restricted from the specified AP.

Command History

Command

Modification

ArubaOS8.10.0.0

The output of theshow ap arm client-match summaryandshow ap arm client-match summary advancedcommands was modified to include the following fields for Wi-Fi 6E APs:

B5G (T/S)

B6G (T/S)

ArubaOS8.6.0.0

The output of theshow ap arm client-match summary advancedcommand was modified to display the percentage of ClientMatch success in addition to the absolute values.

ArubaOS8.3.0.0

A new parameterbriefwas added.

ArubaOS8.0.0.0

Command introduced.

Command Information

Platforms

License

Command Mode

All platforms

base operating system.

Enable or Config mode onMobility Conductor.