sta-load-balance dynamic btm-fail-times

Function

The sta-load-balance dynamic btm-fail-times command sets the maximum number of attempts to steer STAs in BTM mode.

The undo sta-load-balance dynamic btm-fail-times command restores the default maximum number of attempts to steer STAs in BTM mode.

By default, the maximum number of attempts to steer STAs in BTM mode is 5.

Format

sta-load-balance dynamic btm-fail-times btm-fail-times

undo sta-load-balance dynamic btm-fail-times

Parameters

Parameter	Description	Value
btm-fail-times	Specifies the maximum number of attempts to steer STAs in BTM mode.	The value is an integer that ranges from 0 to 10. The value 0 indicates that the BTM mode is not used to steer STAs.

Parameter

Description

Value

btm-fail-times

Specifies the maximum number of attempts to steer STAs in BTM mode.

The value is an integer that ranges from 0 to 10.

The value 0 indicates that the BTM mode is not used to steer STAs.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The device preferentially uses the BTM mode to trigger STA steering to the target AP. Due to differences of STAs, some STAs can be successfully steered in BTM mode after multiple attempts. You can run the sta-load-balance dynamic btm-fail-times command to set the maximum number of attempts to steer STAs in BTM mode. If the number of attempts exceeds the specified value, the device attempts to steer STAs in deauthentication mode.

Precautions

You are advised to retain the default value. If the success rate of STA steering in BTM mode is low, you can set a smaller value to improve the steering efficiency.

Example

# Set the maximum number of attempts to steer STAs in BTM mode to 4 in RRM profile default.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] rrm-profile name default
[HUAWEI-wlan-rrm-prof-default] sta-load-balance dynamic btm-fail-times 4