2-139
Cisco Broadband Cable Command Reference Guide
OL-1581-08
Chapter 2 Cisco CMTS Configuration Commands
cable load-balance group threshold
cable load-balance group threshold
To configure the threshold values that a load-balance group should use for load-balancing operations,
use the
cable load-balance group threshold
command in global configuration mode. To reset the load-
balance group to its default threshold values, use the
no
form of this command.
cable load-balance group
n
threshold
{
load
load-value
[
enforce
threshold
] |
load minimum
number |
stability
percent |
ugs
band-value
}
Syntax Description
n
Specifies the number of the load-balance group. The valid range is 1 to 20.
load
load-value
Specifies the maximum load difference, as expressed in a percentage of
total load, that can exist between interfaces in a load-balance group before
the Cisco CMTS performs load balancing. If the load between interfaces is
greater than the value specified by
load-value
, cable modems that are
registering are assigned to the lesser-utilized interface until the load
difference is once again below this value. The valid range for
load-value
is
1 to 100 percent, with a default of 10 percent.
Note
The default of 10 percent is the minimum recommended threshold.
Do not set this threshold below 10 percent unless you have been
instructed to do so by Cisco TAC.
enforce
threshold
(Optional) Enables dynamic load balancing, which moves online cable
modems after their initial registration to achieve load balancing of the cable
interfaces in a load-balance group. Cable modems that are currently online
are moved when the load difference between two interfaces in the load-
balance group exceeds this percentage. Modems continue to be moved until
the load difference falls below this value.
The possible valid range for
threshold
is 1 to 100 percent, but the
threshold
must be equal to or greater than the percentage specified with the
load-value
option. For this reason, the actual minimum for
threshold
is the current
setting of the
load-value
option. The default is also the same value as the
load-value
parameter.
load minimum
number
(Optional) Specifies that cable modems should be moved only if the load
between the two interfaces is greater than the specified number of cable
modems or service flows (valid only when the method is the number of
modems or service flows). The valid range is 1 to 100, with a default of 5.
stability
percent
Specifies the threshold to be used to determine whether a channel or
interface is unstable, in terms of the percentage of successful ranging
requests. The
percent
value specifies the minimum percentage of successful
ranging requests that is acceptable; otherwise, the CMTS begins moving
CMs. The valid range is 1 to 100 percent, with a default of 50 percent.
ugs
band-value
Specifies that the Cisco CMTS should move cable modems with active UGS
service flows when the current UGS usage reaches the percentage of total
bandwidth available that is specified by the
band-value
parameter. The valid
range for
band-value
is 0 to 100 percent, with a default of 70 percent.
Note
This option is effective only when the
enforce
option has also been
used to enable dynamic load balancing, and the Cisco CMTS has
been authorized to move cable modems with active UGS service
flows (using the
cable load-balance group policy ugs
command).