Contents

WLAN load balancing commands· 1

display wlan load-balance status service-template· 1

snmp-agent trap enable wlan load-balance· 2

wlan load-balance access-denial 2

wlan load-balance enable· 3

wlan load-balance mode bandwidth· 3

wlan load-balance mode session· 4

wlan load-balance mode traffic· 5

wlan load-balance rssi-threshold· 5

WLAN load balancing commands

The AP models and serial numbers in this document are used only as examples. Support for AP models and serial numbers depends on the AC model.

display wlan load-balance status service-template

Use display wlan load-balance status service-template to display load balancing information for radios that are bound to a service template.

Syntax

display wlan load-balance status service-template template-name client mac-address

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

template-name: Specifies a service template by its name, a case-insensitive string of 1 to 63 characters.

client mac-address: Displays information about radios that have detected the specified client. The mac-address argument represents the MAC address of the client and is in H-H-H format.

Examples

# Display load balancing information for radios that are bound to service template st1 and that detect the client with MAC address 702d-2249-33bf.

<Sysname> display wlan load-balance status service-template st1 client 702d-2249-33bf

Current load balancing mode (threshold/gap): session (2/1)

Load balancing group exist: No

Total radios: 4

 

APID/RID  Group ID  Session  Bandwidth(Mbps)  Traffic(%)  Balance(Y/N)

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

3/1       0         2        100              5           Y

1/2       0         10       50               10          N

4/1       0         2        10               1           Y

4/2       0         2        0                0           Y

Table 1 Command output

Field	Description
Load-balance group exist	Whether load balancing groups exist: Yes or No. This field is not supported in the current software version.
APID/RID	AP ID or radio ID.
Group ID	Load balancing group ID. The value of 0 indicates that the radio is not in a load balancing group. This field is not supported in the current software version.
Session	Number of clients associated with the radio.
Bandwidth(Mbps)	Bandwidth of the radio in Mbps.
Traffic(%)	Percentage of the traffic on the radio to the maximum bandwidth of the radio.
Balance(Y/N)	Load balancing status: ·     Y—The radio has been load balanced. ·     N—The radio has not been load balanced.

‌

snmp-agent trap enable wlan load-balance

Use snmp-agent trap enable wlan load-balance to enable SNMP notifications for WLAN load balancing.

Use undo snmp-agent trap enable wlan load-balance to disable SNMP notifications for WLAN load balancing.

Syntax

snmp-agent trap enable wlan load-balance

undo snmp-agent trap enable wlan load-balance

Default

SNMP notifications for WLAN load balancing are disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

To report critical WLAN load balancing events to an NMS, enable SNMP notifications for WLAN load balancing. For WLAN load balancing event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

Examples

# Enable SNMP notifications for WLAN load balancing.

<Sysname> system-view

[Sysname] snmp-agent trap enable wlan load-balance

wlan load-balance access-denial

Use wlan load-balance access-denial to set the maximum number of denials for association requests.

Use undo wlan load-balance access-denial to restore the default.

Syntax

wlan load-balance access-denial access-denial

undo wlan load-balance access-denial

Default

The maximum number of denials is 10 for association requests.

Views

System view

Predefined user roles

network-admin

Parameters

access-denial: Specifies the maximum number of denials for association requests, in the range of 2 to 10.

Usage guidelines

If the number of times that an AP rejects a client reaches the maximum number of denials for association requests, the AP accepts the association request from the client.

Examples

# Set the maximum number of denials to 4 for association requests.

<Sysname> system-view

[Sysname] wlan load-balance access-denial 4

wlan load-balance enable

Use wlan load-balance enable to enable WLAN load balancing.

Use undo wlan load-balance enable to disable WLAN load balancing.

Syntax

wlan load-balance enable

undo wlan load-balance enable

Default

WLAN load balancing is disabled.

Views

System view

Predefined user roles

network-admin

Examples

# Enable WLAN load balancing.

<Sysname> system-view

[Sysname] wlan load-balance enable

wlan load-balance mode bandwidth

Use wlan load-balance mode bandwidth to configure bandwidth-mode load balancing.

Use undo wlan load-balance mode to restore the default.

Syntax

wlan load-balance mode bandwidth value [ gap gap-value ]

undo wlan load-balance mode

Default

Session-mode load balancing is used.

Predefined user roles

network-admin

Parameters

value: Specifies the bandwidth threshold in the range of 1 to 500 Mbps.

gap gap-value: Specifies the bandwidth gap threshold in the range of 1 to 200 Mbps. The default bandwidth gap threshold is 20 Mbps.

Usage guidelines

The device performs bandwidth-mode load balancing when the following conditions are met:

·     The bandwidth of an AP reaches the bandwidth threshold.

·     The bandwidth gap between the AP and the AP that has the smallest bandwidth reaches the bandwidth gap threshold.

Examples

# Set the load balancing mode to bandwidth mode, and set the bandwidth threshold and bandwidth gap threshold to 100 Mbps and 20 Mbps, respectively.

<Sysname> system-view

[Sysname] wlan load-balance mode bandwidth 100 gap 20

wlan load-balance mode session

Use wlan load-balance mode session to configure session-mode load balancing.

Use undo wlan load-balance mode to restore the default.

Syntax

wlan load-balance mode session value [ gap gap-value ]

undo wlan load-balance mode

Default

Session-mode load balancing is used and the session threshold is 20.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the session threshold in the range of 1 to 120.

gap gap-value: Specifies the session gap threshold in the range of 1 to 12. The default session gap threshold is 4.

Usage guidelines

The AC performs session-mode load balancing when the following conditions are met:

·     The number of clients associated with an AP reaches the session threshold.

·     The session gap between the AP and the AP that has the fewest clients reaches the session gap threshold.

Examples

# Set the load balancing mode to session mode, and set the session threshold and session gap threshold to 7 and 5, respectively.

<Sysname> system-view

[Sysname] wlan load-balance mode session 7 gap 5

wlan load-balance mode traffic

Use wlan load-balance mode traffic to configure traffic-mode load balancing.

Use undo wlan load-balance mode to restore the default.

Syntax

wlan load-balance mode traffic value [ gap gap-value ]

undo wlan load-balance mode

Default

Session-mode load balancing is used.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the traffic threshold in the ratio between the traffic and the maximum bandwidth of an AP. The value range for this argument is 1% to 80%.

gap gap-value: Specifies the traffic gap threshold in the ratio between the traffic gap and the maximum bandwidth of an AP. The value range for this argument is 10% and 40%. The default traffic gap threshold is 20%.

Usage guidelines

The AC performs traffic-mode load balancing when the following conditions are met:

·     The traffic of an AP reaches the traffic threshold.

·     The traffic gap between the AP and the AP that has the least traffic reaches the traffic gap threshold.

Examples

# Set the load balancing mode to traffic mode, and set the traffic threshold and traffic gap threshold to 25% and 20%, respectively.

<Sysname> system-view

[Sysname] wlan load-balance mode traffic 25 gap 20

wlan load-balance rssi-threshold

Use wlan load-balance rssi-threshold to set the received signal strength indicator (RSSI) threshold.

Use undo wlan load-balance rssi-threshold to restore the default.

Syntax

wlan load-balance rssi-threshold rssi-threshold

undo wlan load-balance rssi-threshold

Default

The RSSI threshold is 25.

Views

System view

Predefined user roles

network-admin

Parameters

rssi-threshold: Specifies the RSSI threshold in the range of 5 to 100.

Usage guidelines

An AP determines that a client not detected if the client's RSSI is lower than the load balancing RSSI threshold. If only one AP can detect the client, the AP increases the access probability for the client by decreasing the maximum number of denials to 1 for the client.

Examples

# Set the RSSI threshold to 40.

<Sysname> system-view

[Sysname] wlan load-balance rssi-threshold 40