Contents

WLAN load balancing commands· 1

ap radio· 1

description· 1

display wlan load-balance group· 2

display wlan load-balance status service-template· 3

snmp-agent trap enable wlan load-balance· 4

wlan load-balance access-denial 5

wlan load-balance enable· 6

wlan load-balance group· 6

wlan load-balance mode bandwidth· 7

wlan load-balance mode session· 7

wlan load-balance mode traffic· 8

wlan load-balance rssi-threshold· 9

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.

ap radio

Use ap radio to add a radio to a load balancing group.

Use undo ap to remove one or all radios from a load balancing group.

Syntax

ap name ap-name radio radio-id

undo ap { name ap-name [ radio radio-id ] | all }

Default

No radio exists in a load balancing group.

Views

Load balancing group view

Predefined user roles

network-admin

Parameters

ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The name can include letters, numbers, underscores (_), dots (.), left brackets ([), right brackets (]), slashes (/), and minus signs (-). The AP must already exist.

radio-id: Specifies a radio by its ID. The value range for this argument varies by AP model.

all: Specifies all radios.

Usage guidelines

You can add a radio to only one load balancing group.

If you do not specify a radio in the undo ap command, the command removes all radios on the specified AP from the load balancing group.

Examples

# Add radio 2 of AP ap1 to load balancing group 10.

<Sysname> system-view

[Sysname] wlan load-balance group 10

[Sysname-wlan-lb-group-10] ap name ap1 radio 2

description

Use description to set a description for a load balancing group.

Use undo description to restore the default.

Syntax

description text

undo description

Default

No description is set for a load balancing group.

Views

Load balancing group view

Predefined user roles

network-admin

Parameters

text: Specifies a description for a load balancing group, a case-sensitive string of 1 to 64 characters.

Examples

# Set the description for load balancing group 10 to marketing.

<Sysname> system-view

[Sysname] wlan load-balance group 10

[Sysname-wlan-lb-group10] description marketing

display wlan load-balance group

Use display wlan load-balance group to display load balancing group information.

Syntax

display wlan load-balance group { group-id | all }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group-id: Specifies a load balancing group by its ID. The value range for this argument is 1 to 65535.

all: Specifies all load balancing groups.

Examples

# Display information about load balancing group 1.

<Sysname> display wlan load-balance group 1

                  WLAN load balance group information

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

Group ID                : 1

Description             :

Group members           : ap3-radio2,

                          ap2-radio1,

                          ap1-radio1,

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

# Display information about all load balancing groups.

<Sysname> display wlan load-balance group all

                  WLAN load balance group information

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

Group ID                : 1

Description             :

Group members           : ap3-radio2,

                          ap2-radio1,

                          ap1-radio1,

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

Group ID                : 2

Description             : marketing

Group members           : ap3-radio1,

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

Table 1 Command output

Field	Description
Group members	List of radios in the load balancing group.

‌

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 | group group-id }

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.

group group-id: Displays information about radios in a load balancing group. The group-id argument represents the ID of the load balancing group. The value range for this argument is 1 to 65535.

Examples

# Display load balancing information for radios that are bound to service template st1 and are in load balancing group 1.

<Sysname> display wlan load-balance status service-template st1 group 1

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

Total radios: 4

 

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

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

1/1       1         2        100              5           Y

1/2       1         10       50               10          N

2/1       1         2        10               1           Y

2/2       1         2        0                0           Y

 

# 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: Yes

Total radios: 4

 

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

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

3/1       0         2        100              5           Y

1/2       1         10       50               10          N

4/1       1         2        10               1           Y

4/2       0         2        0                0           Y

Table 2 Command output

Field	Description
Load-balance group exist	Whether load balancing groups exist: Yes or No.
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.
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 group

Use wlan load-balance group to create a load balancing group and enter its view, or enter the view of an existing load balancing group.

Use undo wlan load-balance group to remove one or all load balancing groups.

Syntax

wlan load-balance group group-id

undo wlan load-balance group { group-id | all }

Default

No load balancing group exists.

Views

System view

Predefined user roles

network-admin

Parameters

group-id: Specifies a load balancing group by its ID. The value range for this argument is 1 to 65535.

all: Specifies all load balancing groups.

Usage guidelines

To perform load balancing among specific APs, you can add the radios of these APs to a load balancing group. The device does not perform load balancing on radios that do not belong to the load balancing group.

Examples

# Create load balancing group 10 and enter its view.

<Sysname> system-view

[Sysname] wlan load-balance group 10

[Sysname-wlan-lb-group-10]

Related commands

ap radio

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