Contents

WLAN load balancing commands· 1

description· 1

display wlan load-balance group· 1

display wlan load-balance status service-template· 2

radio‌· 3

snmp-agent trap enable wlan load-balance· 4

wlan load-balance access-denial 5

wlan load-balance enable· 5

wlan load-balance group· 6

wlan load-balance mode session· 6

wlan load-balance rssi-threshold· 7

WLAN load balancing commands

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           : fatap-radio1,

                          fatap-radio2,

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

# 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           : fatap-radio1,

                          fatap-radio2,

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

Group ID                : 2

Description             : marketing

Group members           : fatap-radio3,

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

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 session threshold/gap: 2/1

Total radios: 3

 

RID   Group ID  Session   Balanced(Y/N)

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

1     1         2         Y

2     1         10        N

3     1         2         Y

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

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

Current load balancing session threshold/gap: 2/1

Load balancing groups exist: Yes

Total radios: 2

 

RID   Group ID  Session   Balanced(Y/N)

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

1     1         2         Y

2     1         10        N

Table 2 Command output‌

Field	Description
Load balancing groups exist	Whether load balancing groups exist: Yes or No.
RID	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.
Balanced(Y/N)	Load balancing status: ·     Y—The radio has been load balanced. ·     N—The radio has not been load balanced.

‌

radio‌

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

Use undo radio to remove a radio from a load balancing group.

Syntax

radio radio-id

undo radio [ radio-id ]

Default

No radios exist in a load balancing group.

Views

Load balancing group view

Predefined user roles

network-admin

Parameters

radio-id: Specifies a radio by its ID.

Usage guidelines

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

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

Examples

# Add radio 2 to load balancing group 1.

<Sysname> system-view

[Sysname] wlan load-balance group 1

[Sysname-wlan-lb-group-1] radio 2

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

radio‌

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