btm-fail-times

Function

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

The undo 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

btm-fail-times btm-fail-times

undo btm-fail-times

Parameters

Parameter	Description	Value
btm-fail-times	Specifies the 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 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

Static load balancing group 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 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.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] sta-load-balance static-group name coco
[HUAWEI-wlan-sta-lb-static-coco] btm-fail-times 4