steer-restrict auth-threshold

Function

The steer-restrict auth-threshold command sets the maximum number of times non-target APs suppress authentication of STAs during STA steering.

The undo steer-restrict auth-threshold command restores the default maximum number of times non-target APs suppress authentication of STAs during STA steering.

By default, the maximum number of times non-target APs suppress authentication of STAs during STA steering is 0.

Format

steer-restrict auth-threshold auth-threshold

undo steer-restrict auth-threshold

Parameters

Parameter	Description	Value
auth-threshold	Specifies the maximum number of times non-target APs suppress authentication of STAs during STA steering.	The value is an integer that ranges from 0 to 5.

Views

Static load balancing group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a STA is triggered to steer to a specified target AP, non-target APs will suppress association of the STA temporarily to improve the STA's steering success rate. You can run the sta-load-balance dynamic steer-restrict auth-threshold command to set the maximum number of times non-target APs suppress authentication of STAs during STA steering.

Precautions

You can set a larger value of this parameter to improve the STAs' steering success rate, which, however, may affect users' network experience.

The default value is applicable to mainstream STAs. You are advised to retain the default value. If users' service experience deteriorates due to STA steering, set a smaller value for this parameter.

Example

# Set the maximum number of times non-target APs suppress authentication of STAs during STA steering to 1.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] sta-load-balance static-group name coco
[HUAWEI-wlan-sta-lb-static-coco] steer-restrict auth-threshold 1