Contents

WLAN radio load balancing commands· 1

display wlan radio-load-balance status service-template· 1

wlan radio-load-balance access-denial 3

wlan radio-load-balance enable· 3

wlan radio-load-balance overload-5g ssid-hide· 4

wlan radio-load-balance rssi-threshold· 5

WLAN radio load balancing commands

The following compatibility matrix shows the support of hardware platforms for WLAN radio load balancing:

 

Hardware series	Model	WLAN radio load balancing compatibility
WA6600 series	WA6628E-T	Yes
WA5600 series	WA5630X WA5620E-T	Yes
WA5500 series	WA5530 WA5530i WA5530X WA5530S WA5530-SI WA5530-LI WA5510E-T	Yes: ·     WA5530 ·     WA5530i ·     WA5530X ·     WA5530S ·     WA5530-SI ·     WA5530-LI No: WA5510E-T
WA5300 series	WA5320i WA5320i-LI WA5320X WA5320X-LI WA5320X-E WA5320X-SI WA5340	Yes
UAP300 series	UAP300	Yes
WAP723 series	WAP723-W2	Yes
WAP722 series	WAP722X-W2 WAP722XS-W2	Yes

‌

Hardware series	Model	WLAN radio load balancing compatibility
WA530 series	WA538 WA536 WA5330 WA530X	Yes

‌

 

display wlan radio-load-balance status service-template

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

Syntax

display wlan radio-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 radio-load-balance status service-template st1 client 702d-2249-33bf

Current radio load balancing mode: session

Threshold: 2

Gap: 1

Band ratio (5 G/2.4 G): 2/1

Total radios: 2

APID    RID    Sessions   Balanced(Y/N)

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

1        1      10          N

1        2      2           Y

Table 1 Command output

Field	Description
Threshold	Session threshold.
Gap	Session gap threshold. (This field is displayed only when the session gap threshold is configured.)
Band ratio (5G/2.4G)	Ratio of clients associated with 5 GHz radios to clients associated with 2.4 GHz radios. (This field is displayed only when the ratio of clients associated with 5 GHz radios to clients associated with 2.4 GHz radios is configured.)
APID	AP ID.
RID	Radio ID.
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.

‌

wlan radio-load-balance access-denial

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

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

Syntax

wlan radio-load-balance access-denial access-denial

undo wlan radio-load-balance access-denial

Default

The maximum number of denials is 3 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 a radio rejects a client reaches the specified maximum number of denials for association requests, the radio accepts the association request from the client.

Examples

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

<Sysname> system-view

[Sysname] wlan radio-load-balance access-denial 4

wlan radio-load-balance enable

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

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

Syntax

wlan radio-load-balance enable [ mode session value [ gap gap-value | band-ratio 5g-proportion 2.4g-proportion ] ]

undo wlan radio-load-balance enable

Default

WLAN radio load balancing is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

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

gap gap-value: Specifies the session gap threshold value in the range of 1 to 12. The session gap is the difference between weighted client value of a radio where the client comes online and the weighted client value of the radio that has the fewest clients within the same AC. The weighted client value is equivalent to the number of clients multiplied by the radio weight value. The radio weight values of 2.4 GHz and 5 GHz radios are 2 and 1, respectively.

band-ratio 5g-proportion 2.4g-proportion: Specifies the ratio of clients associated with all 5 GHz neighbor radios to clients associated with all 2.4 GHz neighbor radios of a client. The value range is 1 to 5 for both the 5g-proportion and 2.4g-proportion arguments.

Usage guidelines

The AP supports session-mode radio load balancing and the following radio load balancing types:

·     Session gap threshold based—The AP performs radio load balancing when the following conditions are met:

¡     The number of clients associated with a radio reaches the session threshold.

¡     The session gap between the radio and the radio that has the fewest clients reaches the session gap threshold.

·     Band ratio based—The AP performs radio load balancing in the following scenarios:

Scenario 1

¡     A client requests to associate with a 5 GHz radio.

¡     The number of clients associated with the 5 GHz radio reaches the session threshold.

¡     The ratio of clients associated with all 5 GHz neighbor radios to clients associated with all 2.4 GHz neighbor radios of the client is larger than the band ratio.

Scenario 2

¡     A client requests to associate with a 2.4 GHz radio.

¡     The number of clients associated with the 2.4 GHz radio reaches the session threshold.

¡     The ratio of clients associated with all 5 GHz neighbor radios to clients associated with all 2.4 GHz neighbor radios of the client is smaller than the band ratio.

If you do not specify a radio load balancing type, the session gap threshold based type is used. The session threshold is 50, and the session gap threshold 10.

 

	NOTE: Neighbor radios of a client refer to all radios that receive requests from the client.

‌

Examples

# Enable WLAN radio load balancing.

<Sysname> system-view

[Sysname] wlan radio-load-balance enable mode session 4 gap 3

wlan radio-load-balance overload-5g ssid-hide

Use wlan radio-load-balance overload-5g ssid-hide to enable overloaded 5 GHz radios to hide SSIDs.

Use undo wlan radio-load-balance overload-5g ssid-hide to disable overloaded 5 GHz radios from hiding SSIDs.

Syntax

wlan radio-load-balance overload-5g ssid-hide [ session value [ gap gap-value ] ] [ force-logoff ]

undo wlan radio-load-balance overload-5g ssid-hide

Default

Overloaded 5 GHz radios hide SSIDs.

Views

System view

Predefined user roles

network-admin

Parameters

session value: Specifies the session threshold value in the range of 1 to 120. The default value is 5.

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

force-logoff: Forces half of the clients associated with the target 5 GHz radio to log off when radar avoidance occurs.

Usage guidelines

After you configure this command, a 5 GHz radio hides its SSID in beacon frames when the following conditions are met:

·     The number of clients associated with the 5 GHz radio reaches the session threshold.

·     The session gap between the 5 GHz radio and another 5 GHz radio on the same AP reaches the session gap threshold.

The 5 GHz radio stops hiding its SSID in beacon frame when either of the following conditions are met:

·     The number of clients associated with the 5 GHz radio falls below the session threshold.

·     The session gap between the 5 GHz radio and another 5 GHz radio on the same AP falls below the session gap threshold.

When radar avoidance occurs on a 5 GHz radio, all clients on the radio will be transferred to the other 5 GHz radio of the same AP. As a result, the 5 GHz radio might be overloaded. To resolve this issue, specify the force-logoff keyword to force half of the clients on a 5 GHz radio to log off when radar avoidance occurs on the other 5 GHz radio of the same AP. Specifying the force-logoff keyword will force clients to log off. As a best practice, specify this keyword only when necessary.

As a best practice, enable this feature when a large number of clients exist in the network.

This feature takes effect only when an AP has multiple 5 GHz radios.

Examples

# Enable overloaded 5 GHz radios to hide SSIDs.

<Sysname> system-view

[Sysname] wlan radio-load-balance overload-5g ssid-hide session 20 gap 5

wlan radio-load-balance rssi-threshold

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

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

Syntax

wlan radio-load-balance rssi-threshold rssi-threshold

undo wlan radio-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

If a radio detects that the RSSI of a client is lower than the specified RSSI threshold, the radio ignores the association requests of the client.

Examples

# Set the RSSI threshold to 40.

<Sysname> system-view

[Sysname] wlan radio-load-balance rssi-threshold 40