load-balancing

Profile Config Commands

Configures load balancing parameters

Supported on the following devices:

Syntax

load-balancing [advanced-params|balance-ap-loads|balance-band-loads|balance-channel-loads|band-control-startegy|band-ratio|group-id|neighbor-selection-strategy]
load-balancing advanced-params [2.4GHz-load|5GHz-load|ap-load|equality-margin| hiwater-threshold|max-neighbors|max-preferred-band-load|min-common-clients|min-neighbor-rssi|min-probe-rssi]
load-balancing advanced-params [2.4GHz-load|5GHz-load|ap-load] [client-weightage|throughput-weightage] <0-100>
load-balancing advanced-params equality-margin [2.4GHz|5GHz|ap|band] <0-100>
load-balancing advanced-params hiwater-threshold [ap|channel-2.4GHz|channel-5GHz]<0-100>
load-balancing advanced-params max-preferred-band-load [2.4GHz|5GHz] <0-100>
load-balancing advanced-params [max-neighbors <0-16>|min-common-clients <0-256>| min-neighbor-rssi <-100-30>|min-probe-rssi <-100-30>]
load-balancing [balance-ap-loads|balance-band-loads|balance-channel-loads [2.4GHz|5GHz]]
load-balancing band-control-strategy [distribute-by-ratio|prefer-2.4GHz|prefer-5GHz]
load-balancing band-ratio [2.4GHz|5GHz] [0|<1-10>]
load-balancing group-id <GROUP-ID>
load-balancing neighbor-selection-strategy [use-common-clients|use-roam-notification|use-smart-rf]

Parameters

load-balancing advanced-params [2.4GHz-load|5GHz-load|ap-load] [client-weightage|
throughput-weightage] <0-100>
load-balancing advanced-paramsConfigures advanced load balancing parameters
2.4GHz-load [client-weightage| throughput-weightage] <0-100>Configures 2.4 GHz load calculation weightages
  • client-weightage – Specifies weightage assigned to the client-count when calculating the 2.4 GHz load
  • throughput-weightage – Specifies weightage assigned to throughput, when calculating the 2.4 GHz load

The following keyword is common to the ‘client-weightage‘ and ‘throughput-weightage‘ parameters:

  • <0-100> – Sets the margin as a load percentage from 1 - 100. The default client-weightage is 90%. The default throughput-weightage is 10%.
5GHz-load [client-weightage| throughput-weightage] <0-100>Configures 5.0 GHz load calculation weightages
  • client-weightage – Specifies weightage assigned to the client-count when calculating the 5.0 GHz load
  • throughput-weightage – Specifies weightage assigned to throughput, when calculating the 5.0 GHz load

The following keyword is common to the ‘client-weightage‘ and ‘throughput-weightage‘ parameters:

  • <0-100> – Sets the margin as a load percentage from1 - 100. The default client-weightage is 90%. The default throughput-weightage is 10%.
ap-load [client-weightage| throughput-weightage] <0-100>Configures AP load calculation weightages
  • client-weightage – Specifies weightage assigned to the client-count, when calculating the AP load
  • throughput-weightage – Specifies weightage assigned to throughput, when calculating the AP load

The following keyword is common to the ‘client-weightage‘ and ‘throughput-weightage‘ parameters:

  • <0-100> – Sets the margin as a load percentage from 1 - 100. The default client-weightage is 90%. The default throughput-weightage is 10%.
load-balancing advanced-params equality-margin [2.4GHz|5GHz|ap|band] <0-100>
load-balancing advanced-paramsConfigures advanced load balancing parameters
equality-margin [2.4GHz|5GHz|ap| band] <0-100>Configures the maximum load difference considered equal. The load is compared for different 2.4 GHz channels, 5.0 GHz channels, APs, or bands.
  • 2.4GHz – Configures the maximum load difference considered equal when comparing loads on different 2.4 GHz channels
  • 5GHz – Configures the maximum load difference considered equal when comparing loads on different 5.0 GHz channels
  • ap – Configures the maximum load difference considered equal when comparing loads on different APs
  • band – Configures the maximum load difference considered equal when comparing loads on different bands

The following keyword is common to 2.4 GHz channels, 5.0 GHz channels, APs, and bands:

  • <0-100> – Sets the margin as a load percentage from 1 - 100. The default equality-margin for 2.4 GHz, 5.0 GHz, ap, and band loads is 1%.
load-balancing advanced-params hiwater-threshold [ap|channel-2.4GHz|channel-5GHz] <0-100>
load-balancing advanced-paramsConfigures advanced load balancing parameters
hiwater-thresholdConfigures the load beyond which load balancing is invoked
[ap|channel-2.4GHz| channel-5GHz] <0-100>Select one of the following options:
  • ap – Configures the AP load beyond which load balancing begins
  • channel-2.4GHz – Configures the AP load beyond which load balancing begins (for APs on 2.4 GHz channel)
  • channel-5GHz – Configures the AP load beyond which load balancing begins for (APs on 5.0 GHz channel)

The following keyword is common for the ‘AP‘, ‘channel-2.4GHz‘, and ‘channel-5GHz‘ parameters:

  • <0-100> – Sets the load threshold as a number from 1 - 100. The default hiwater-threshold for channel-2.5GHz, channel-5GHz, and ap loads is 5.
load-balancing advanced-params max-preferred-band-load [2.4GHGz|5GHzd] <0-100>
load-balancing advanced-paramsConfigures advanced load balancing parameters
max-preferred-band-loadConfigures the maximum load on the preferred band, beyond which the other band is equally preferred
[2.4GHz|5GHz] <0-100>Select one of the following options:
  • 2.4GHz – Configures the maximum load on 2.4 GHz, when it is the preferred band
  • 5GHz – Configures the maximum load on 5.0 GHz, when it is the preferred band

The following keyword is common to the 2.4 GHz and 5.0 GHz bands:

  • <0-100> – Configures the maximum load as a percentage from 0 - 100. The default value for 2.4GHz and 5.GHz is 75%.
load-balancing advanced-params [max-neighbors <0-16>|min-common-clients <0-256>|
min-neighbor-rssi <-100-30>|min-probe-rssi <-100-30>]
load-balancing advanced-paramsConfigures advanced load balancing parameters
max-neighbors <0-16>Configures the maximum number of confirmed neighbors to balance
  • <0-16> – Specify a value from 0 - 16. Optionally configure a minimum of 0 neighbors and a maximum of 16 neighbors. The default is 16.
min-common-clients <0-256>Configures the minimum number of common clients that can be shared with the neighbor for load balancing
  • <0-256> – Specify a value from 0 - 256. Optionally configure a minimum of 0 clients and a maximum of 256 clients. The default is 0.
min-neighbor-rssi <-100-30>Configures the minimum signal strength (RSSI) of a neighbor detected
  • <-100-30> – Sets the signal strength in dBm. Specify a value from -100 - 30 dBm. The default is -65 dBm.
min-probe-rssi <-100-30>Configures the minimum received probe signal strength required to qualify the sender as a common client
  • <0-100> – Sets the signal strength in dBm. Specify a value from -100 - 30 dBm. The default is -100 dBm.
load-balancing [balance-ap-loads|balance-band-loads|balance-channel-loads [2.4GHz|5GHz]]
load-balancingConfigures the following load balancing parameters: ap-loads, band-loads, and channel-loads.
balance-ap-loadsEnables neighbor AP load balancing. This option distributes the access point‘s radio load amongst other controller managed access point radios. This option is disabled by default.
balance-band-loadsEnables balancing of the total band load amongst neighbors. This option balances the access point‘s radio load by assigning a ratio to both the 2.4 GHz and 5.0 GHz bands. Balancing radio load by band ratio allows an administrator to assign a greater weight to radio traffic on either the 2.4 GHz or 5.0 GHz band. This option is disabled by default.
balance-channel-loads [2.4GHz|5GHz]Enables the following:
  • 2.4GHz – Channel load balancing on 2.4 GHz band. This option is disabled by default.

    Balances the access point‘s 2.4 GHz radio load across channels supported within the country of deployment. This can prevent congestion on the 2.4 GHz radio if a channel is over utilized.

  • 5GHz – Channel load balancing on 5.0 GHz band. This option is disabled by default.

    Balances the access point‘s 5.0 GHz radio load across channels supported within the country of deployment. This can prevent congestion on the 5.0 GHz radio if a channel is over utilized.

load-balancing band-control-strategy [distribute-by-ratio|prefer-2.4GHz| prefer-5GHz]
load-balancing band-control-strategyConfigures a band control strategy

By default, this option steers 5.0 GHz-capable clients to the 5.0 GHz band. When an access point hears a request from a client to associate on both the 2.4 GHz and 5.0 GHz bands, it knows the client is capable of operation in 5.0 GHz. Band steering steers the client by responding only to the 5.0 GHz association request and not the 2.4 GHz request. Consequently, the client only associates in the 5.0 GHz band.

distribute-by-ratioDistributes clients to either band according to the band-ratio
prefer-2.4GHzNudges all dual-band clients to 2.4 GHz band
prefer-5GHzNudges all dual-band clients to 5.0 GHz band. This is the default setting.
load-balancing band-ratio [2.4GHz|5GHz] [0|<1-10>]
load-balancing band-ratioConfigures the relative loading of 2.4 GHz band and 5.0 GHz band.This allows an administrator to weight client traffic load if wishing to prioritize client traffic load on the 2.4 GHz or the radio band. The higher the value set, the greater the weight assigned to radio traffic load on the 2.4 GHz or 5.0 GHz radio band.
2.4GHz [0|<1-10>]Configures the relative loading of 2.4 GHz band
  • 0 – Selecting ‘0‘ steers all dual-band clients preferentially to the other band
  • <0-10> – Configures a relative load as a number from 0 - 10. The default is 0.
5ghz [0|<1-10>]Configures the relative loading of 5.0 GHz band
  • 0 – Selecting ‘0‘ steers all dual-band clients preferentially to the other band
  • <0-10> – Configures a relative load as a number from 0 - 10. The default is 1.
load-balancing group-id <GROUP-ID>
load-balancing group-id <GROUP-ID>Configures group ID to facilitate load balancing
  • <GROUP-ID> – Specify the group ID. This option is enabled only when a group ID is configured.
load-balancing neighbor-selection-strategy [use-common-clients|use-roam-notification|
use-smart-rf]
load-balancing neighbor-selection-strategyConfigures a neighbor selection strategy. The options are: use-common-clients, use-roam-notification, and use-smart-rf
use-common-clientsSelects neighbors based on probes from clients common to neighbors. This option is enabled by default.
use-roam-notificationSelects neighbors based on roam notifications from roamed clients. This option is enabled by default.
use-smart-rfSelects neighbors detected by Smart RF. This option is enabled by default.

Example

nx9500-6C8809(config-profile-TestNX5500)#load-balancing advanced-params 2.4ghz-load throughput-weightage 90

nx9500-6C8809(config-profile-TestNX5500)#load-balancing advanced-params hiwater-threshold ap 90

nx9500-6C8809(config-profile-TestNX5500)#load-balancing balance-ap-loads

nx9500-6C8809(config-profile-TestNX5500)#show context
profile nx5500 TestNX5500
 bridge vlan 1
  bridging-mode isolated-tunnel
  ip igmp snooping
  ip igmp snooping querier
 ip default-gateway 172.16.10.4
 autoinstall configuration
 autoinstall firmware
 load-balancing advanced-params 2.4ghz-load throughput-weightage 90
 load-balancing advanced-params hiwater-threshold ap 90
 load-balancing balance-ap-loads
--More--
nx9500-6C8809(config-profile-TestNX5500)#

Related Commands

noDisables load balancing on this profile
9041291-01 Rev AA