Page History

Noprint

Panel

borderColor	green
bgColor	transparent
borderWidth	2

Back to Table of Contents

Back to CLI Configure Mode

Back to System - CLI

Panel

In this section:

Table of Contents

maxLevel	3

The Congestion objects provide a facility for managing the call congestion for

Spacevars

0	product

application. Following system congestion levels are defined in this section, with each level representing an increasing severity of congestion within the

Spacevars

0	product

:

adaptive – The congestion level at which the adaptive congestion control algorithm activates. The adaptive algorithm iteratively adjusts the call acceptance rate up or down to maximize call throughput while maintaining target performance metrics throughout the overload event. The algorithm is self-tuning to automatically adjust to nominal capacity (and to non-call-rate related events consuming unpredictable amounts of CPU) and is independent of call scenario mix, signaling types, and user retry behavior. There is a single default configuration for all system configurations. Emergency calls may optionally be given preference over non-priority calls.
levelMC1 – Limited congestion level. By default, no calls are rejected due to congestion in this level.
levelMC2 – Moderate congestion level. By default, the adaptive congestion controls activate when this level of congestion is reached.
levelMC3 – Critical congestion level. By default, this level is disabled since the adaptive congestion controls (which activate at levelMC2) prevent the box from reaching this level.
mode – Mode for the system congestion control.
policer – System congestion Call Rate Policer configuration.

In levels MC1 and MC2, the

Spacevars

0	product

software will attempt to balance traffic by assigning H.323 and SIP calls to non-congested modules. In levels MC1, MC2, and MC3, all INFO event log messages are suppressed.

These congestion levels only apply to the packet calls. You define the threshold at which these congestion levels are trigger by associating each level with an Overload Profile. CPU utilization congestion criteria thresholds and durations are specified in the Overload Profile:

By configuring the Overload Profile appropriately, some of the congestion criteria can trigger a change in the congestion level.

During a sustained system load, the

Spacevars

0	product

accepts calls at a smooth rate, avoiding behavior such as accepting all calls for a short period of time, and then rejecting all calls for the remaining sampling period. This is accomplished with system-level policers. Unlike IP Traffic Policers--which control the allowed rate of incoming IP packets, congestion policers control the allowed rate of incoming calls in a system. Individually configurable bucket sizes (POLICER BUCKETSIZE) control the call burst handling capability. The policer fill rate controls the sustained rate (the rate at which tokens are added to the bucket). In this case, the fill rate is the sustained call rate allowed at calls per second (CPS). Fill rates are not configurable when using congestion policers; instead, they are dynamically adjusted based on resource usage, to maximize those resources.

Command Syntax

Code Block

language	none

% set system congestion 
	adaptive
		MCLevel(mc1 | mc2 | mc3>
% set system congestion 
	levelMC1
		mode <inService | outOfService> 
		overloadProfileName <defaultMC1>
	levelMC2
		mode <inService | outOfService> 
		overloadProfileName <defaultMC2>
	levelMC3
		mode <inService | outOfService> 
		overloadProfileName <defaultMC3>
 
% set system congestion
	mode <adaptive>
	policer preference 
		call <0-3>
		emergencyCall <0-3>
		initialSipRegister <0-3>
		initialSipSubscribe <0-3>

Command Parameters

Caption

0	Table
1	Congestion Parameters

Parameter

...

Length/Range

Description
`adaptive`

...

N/A

Adaptive overload configuration.

MCLevel – Sets the system machine congestion level at which the system adaptive algorithm activates:
- mc1 – Adaptive congestion control is activated at system congestion level mc1.
- mc2 – Adaptive congestion control is activated at system congestion level mc2.
- mc3 – Adaptive congestion control is activated at system congestion level mc3.

levelMC1

...

The operational state of machine congestion level 1, or MC1.

mode – The Maintenance mode of MC1.
- inService – (default) The most recently assigned Overload Profile is validated and activated.
- outOfService – Congestion control processing for machine level 1 is suspended. A new Overload Profile can be assigned.
overloadProfileName – The Overload Profile name of MC1.
- defaultMC1 – The name of the Overload Profile assigned to Machine Congestion Level 1 (MC1).
- defaultMC2 – The name of the Overload Profile assigned to Machine Congestion Level 2 (MC2).
- defaultMC3 – The name of the Overload Profile assigned to Machine Congestion Level 3 (MC3).

See MC Level Thresholds table below for Set and Clear thresholds.

levelMC2

...

N/A

The operational state of machine congestion level 2, or MC2.

mode – The Maintenance mode of MC2.
- inService – (default) The most recently assigned Overload Profile is validated and activated.
- outOfService – Congestion control processing for machine level 2 is suspended. A new Overload Profile can be assigned.
overloadProfileName – The Overload Profile name of MC2.
- defaultMC1 – The name of the Overload Profile assigned to Machine Congestion Level 1 (MC1).
- defaultMC2 – The name of the Overload Profile assigned to Machine Congestion Level 2 (MC2).
- defaultMC3 – The name of the Overload Profile assigned to Machine Congestion Level 3 (MC3).

See MC Level Thresholds table below for Set and Clear thresholds.

levelMC3

...

The operational state of machine congestion level 3, or MC3.

mode – The Maintenance mode of MC3.
- inService – (default) The most recently assigned Overload Profile is validated and activated.
- outOfService – Congestion control processing for machine level 3 is suspended. A new Overload Profile can be assigned.
overloadProfileName – The Overload Profile name of MC3.
- defaultMC1 – The name of the Overload Profile assigned to Machine Congestion Level 1 (MC1).
- defaultMC2 – The name of the Overload Profile assigned to Machine Congestion Level 2 (MC2).
- defaultMC3 – The name of the Overload Profile assigned to Machine Congestion Level 3 (MC3).

See MC Level Thresholds table below for Set and Clear thresholds.

mode

...

The system overload control mode.

adaptive – (default) Adaptive overload control mechanism is applied.

policer preference

...

The system congestion Call Rate Policer configuration. Use this control to assign a preference value (0 to 3) to the call types below, where 0 is the highest and 3 is the lowest preference value.

call – Preference value applied during normal call admission (default = 1).
emergencyCall – Preference value that is applied during emergency call admission (default = 0).
initialSipRegister – Preference value that is applied during initial SIP registration admission (default = 2).
initialSipSubscribe – Preference value to apply to initial SIP Subscribe requests during initial SIP Subscribe admission (default = 2).

Caption

0	Table
1	MC Level Thresholds
3	MC Level Thresholds

MC Level	Set Threshold (%)	Clear Threshold (%)
MC1	85	80
MC2	90	86
MC3	98	95

Command Example

To display congestion configuration information:

Code Block

language	none

% set system congestion adaptive MCLevel mc1
% set system congestion levelMC1 mode inService overloadProfileName defaultMC1
% set system congestion levelMC2 mode inService overloadProfileName defaultMC2
% set system congestion levelMC2 mode outOfService overloadProfileName defaultMC3
% set system congestion mode adaptive
% set system congestion policer preference call 0
 
% show system congestion
levelMC1 {
    mode                inService;
    overloadProfileName defaultMC1;
}
levelMC2 {
    mode                inService;
    overloadProfileName defaultMC2;
}
levelMC3 {
    mode                outOfService;
    overloadProfileName defaultMC3;
}
mode adaptive;
adaptive {
    MCLevel mc1;
}
policer {
    preference {
        call 0;
    }
}

Pagebreak

Space shortcuts

Page tree

Versions Compared

Old Version 3

New Version 4

Key

Command Syntax

Command Parameters

Command Example