WLAN load balancing commands -- 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

mdc-admin

Parameters

ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The name can include letters, numbers, underscores (_), 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 device 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

WLAN load balancing commands -- description

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

Use undo description to restore the default.

Syntax

description text

undo description

Default

No description is configured for a load balancing group.

Views

Load balancing group view

Predefined user roles

network-admin

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

WLAN load balancing commands -- 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

mdc-admin

mdc-operator

Parameters

group-id: Specifies a load balancing group by its ID. The value range for this argument varies by device model.

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.

WLAN load balancing commands -- 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

mdc-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 Network Management and Monitoring Configuration Guide.

Examples

# Enable SNMP notifications for WLAN load balancing.

<Sysname> system-view

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

WLAN load balancing commands -- 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

mdc-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 balancing commands -- 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

mdc-admin

Examples

# Enable WLAN load balancing.

<Sysname> system-view

[Sysname] wlan load-balance enable

WLAN load balancing commands -- 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

mdc-admin

Parameters

group-id: Specifies a load balancing group by its ID. The value range for this argument varies by device model.

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 AC 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 balancing commands -- 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

Views

System view

Default

Session-mode load balancing is used.

Predefined user roles

network-admin

mdc-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 AC 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 balancing commands -- 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

mdc-admin

Parameters

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

gap gap-value: Specifies the session gap threshold in the range of 1 to 8. 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 balancing commands -- 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

mdc-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 balancing commands -- 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

mdc-admin

Parameters

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

Usage guidelines

If an AP detects that the RSSI of a client is lower than the specified RSSI threshold, the AP performs either of the following operations:

· If multiple APs can detect the client, the AP participates in load balancing only when the client requests to associate with the AP.

· If only this AP can detect the client, the AP decreases the maximum number of denials to 1 so that the client has more chances to associate with the AP.

Examples

# Set the RSSI threshold to 40.

<Sysname> system-view

[Sysname] wlan load-balance rssi-threshold 40