Fat AP and Cloud AP
Command Reference 12 WLAN Roaming Commands (Common AP)
12 WLAN Roaming Commands
(Common AP)
About This Chapter
12.1 display station roam-track
12.2 display station roam-statistics
12.3 dot11r enable
12.1 display station roam-track
Function
The display station roam-track command displays the roaming track of a STA.
NOTE
Only cloud APs support this command.
Format
display station roam-track sta-mac mac-address
Parameters
Parameter Description Value
sta-mac mac-address Specifies the MAC The value is in H-H-H
address of a specified format. An H is a
STA. hexadecimal number of
4 digits.
Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 1519
Fat AP and Cloud AP
Command Reference 12 WLAN Roaming Commands (Common AP)
Views
All views
Default Level
1: Monitoring level
Usage Guidelines
During the roaming process of a STA, the device records the STA's roaming track
(that is, information about the APs that the STA connects to). You can run the
display station roam-track command to view the roaming track of the STA.
Example
# Display the roaming track of the STA with the MAC address 00e0-fc00-0001.
<HUAWEI> display station roam-track sta-mac 00e0-fc00-0001
Access SSID:test
Rx/Tx:link receive rate/link transmit rate(Mbps)
c:PMK Cache Roam r:802.11r Roam
------------------------------------------------------------------------------
L2/L3 AP IP AP name Radio ID
BSSID TIME In/Out RSSI Out Rx/Tx
------------------------------------------------------------------------------
-- 192.168.109.1 test1 1
00e0-fc76-e360 2015/01/12 16:52:58 -51/-48 46/13
L2 192.168.109.1 test2 1
00e0-fc74-9640 2015/01/12 16:55:45 -58/- -/-
------------------------------------------------------------------------------
Number: 1
Table 12-1 Description of the display station roam-track command output
Item Description
Access SSID SSID associated with a STA.
Rx/Tx Negotiated rate between the STA and
AP.
L2/L3 Whether a STA roams at Layer 2 or
Layer 3.
Suffix description:
● c: PMK fast roaming.
● r: 802.11r fast roaming
AP IP IP address of an AP that the STA is
associated with.
AP name Name of an AP that the STA is
associated with.
Radio ID ID of a radio that the STA is associated
with.
Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 1520
Fat AP and Cloud AP
Command Reference 12 WLAN Roaming Commands (Common AP)
Item Description
BSSID BSSID of an AP that the STA is
associated with.
TIME Time duration when the STA is
associated with an AP.
In/Out RSSI RSSI of the AP that the STA is
associated with and RSSI of the AP
away from which the STA has left.
Out Rx/Tx Negotiated rate of the STA when it
disconnects from an AP.
Number Number of STA roaming tracks.
12.2 display station roam-statistics
Function
The display station roam-statistics command displays STA roaming statistics.
NOTE
Only cloud APs support this command.
Format
display station roam-statistics
Parameters
None
Views
All views
Default Level
1: Monitoring level
Usage Guidelines
You can run the display station roam-statistics command to view STA roaming
statistics.
Example
# Display roaming statistics about all STAs.
Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 1521
Fat AP and Cloud AP
Command Reference 12 WLAN Roaming Commands (Common AP)
<HUAWEI> display station roam-statistics
----------------------------------------------------------------------------------
Online STAs :0
Online roaming stations :0
Online L3 roam stations :0
Station roam from/to other AC statistic:
Description AC IP L3 roam-in L3 roam-out
---------------------------------------------------------------------------------
----------------------------------------------------------------------------------
Number: 0
Table 12-2 Description of the display station roam-statistics command output
Item Description
Online STAs Number of online STAs.
Online roaming stations Number of online roaming STAs.
Online L3 roam stations Number of Layer 3 roaming STAs.
Station roam from/to other AC statistic Statistics about STAs roaming from
another AP to the local AP or STAs
roaming from the local AP to another
AP.
Description Description of the AP.
AC IP IP address of another AP.
L3 roam-in Number of STAs roaming from another
AP to the local AP.
L3 roam-out Number of STAs roaming from the
local AP to another AP.
12.3 dot11r enable
Function
The dot11r enable command enables 802.11r.
The undo dot11r enable command disables 802.11r.
By default, 802.11r is disabled.
NOTE
Only cloud APs support this command.
Format
dot11r enable [ reassociate-timeout time ]
undo dot11r enable
Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 1522
Fat AP and Cloud AP
Command Reference 12 WLAN Roaming Commands (Common AP)
Parameters
Parameter Description Value
reassociate- STA re-association timeout period. The value is an integer
timeout timeok that ranges from 1 to
After successful authentication, if 10, in seconds. The
the STA does not initiate a default value is 1.
reassociation request within this
period, the roaming fails.
Views
SSID profile view
Default Level
2: Configuration level
Usage Guidelines
Usage Scenario
During roaming, the STA needs to be reauthenticated and re-negotiate a key, so
services are interrupted for a short period of time. You can enable 802.11r to
reduce the number of information exchanges during roaming, thus reducing
latency.
Precautions
● Security policies supported by 802.11r include open system, WPA2+PSK+AES,
WPA2+PPSK+AES, and WPA2+802.1X+AES.
Example
# Enable the 802.11r function.
<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ssid-profile name ssid1
[HUAWEI-wlan-ssid-prof-ssid1] dot11r enable
Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 1523
