session-constraints
The session-constraints configuration element allows you to create session layer constraints in order to manage and police session-related traffic including maximum concurrent sessions, maximum outbound concurrent sessions, maximum session burst rate, and maximum session sustained rate.
The SIP interface configuration’s constraint-name parameter invokes the session constraint configuration you want to apply. Using the constraints you have set up, the Oracle Communications Session Border Controller checks and limits traffic according to those settings for the SIP interface. Of course, if you do not set up the session constraints or you do not apply them in the SIP interface, then that SIP interface will be unconstrained. If you apply a single session-constraint element to multiple SIP interfaces, each SIP interface will maintain its own copy of the session-constraint.
Note:
The Oracle Communications Session Border Controller supports five concurrent SSH and/or SFTP sessions.Parameters
- name
- Enter the name for this session constraint. This must be a unique identifier that you use when configuring a SIP interface on which you are applying it. This is a required parameter.
- state
- Enable or disable this session constraint
- Default: enabled
- Values: enabled | disabled
- max-sessions
- Enter the maximum sessions allowed for this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- max-inbound-sessions
- Enter the maximum inbound sessions allowed for this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- max-outbound-sessions
- Enter the maximum outbound sessions allowed for this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- max-burst-rate
- Enter the maximum burst rate (invites per second) allowed for
this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- max-inbound-burst-rate
- Enter the maximum inbound burst rate (number of session
invitations per second) for this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- max-outbound-burst-rate
- Enter the maximum outbound burst rate (number of session
invitations per second) for this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- max-sustain-rate
- Enter the maximum rate of session invitations allowed within the
current window for this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- max-inbound-sustain-rate
- Enter the maximum inbound sustain rate (of session invitations
allowed within the current window) for this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- max-outbound-sustain-rate
- Enter the maximum outbound sustain rate (of session invitations
allowed within the current window) for this constraint
- Default: 0
- Values: Min: 0 | Max: 999999999
- min-seizures
- Enter the minimum number of seizures for a no-answer scenario
- Default: 5
- Values: Min: 1 | Max: 999999999
- min-asr
- Enter the minimum ASR in percentage
- Default: 0
- Values: Min: 0 | Max: 100
- cac-trap-threshold
- The CAC (session or burst-rate) utilization threshold expressed
as a percent that when exceeded generates a trap.
- Default: 0
- Values: Min: 0 / Max: 99
- time-to-resume
- Enter the number of seconds that is used to place an element
(like a session agent) in the standby state when it has been taken out of
service because of excessive transaction timeouts
- Default: 0
- Values: Min: 0 | Max: 999999999
- ttr-no-response
- Enter the time delay in seconds to wait before changing the
status of an element (like a session agent) after it has been taken out of
service because of excessive transaction timeouts
- Default: 0
- Values: Min: 0 | Max: 999999999
- in-service-period
- Enter the time in seconds that elapses before an element (like a
session agent) can return to active service after being placed in the
standby state
- Default: 0
- Values: Min: 0 | Max: 999999999
- burst-rate-window
- Enter the time in seconds that you want to use to measure the
burst rate
- Default: 0
- Values: Min: 0 | Max: 999999999
Note:
A default value of 0 means that the burst-rate-window is of 1 second. - sustain-rate-window
- Enter the time in seconds used to measure the sustained rate.
- Default: 0
- Values: Min: 0 | Max: 999999999
The value you set here must be higher than or equal to the value you set for the burst rate window.
- rate-constraints
- Access the rate-constraints subelement
Path
session-constraintsis an element of the session-router path. The full path from the topmost ACLI prompt is: configure terminal > session-router > session-constraints.