1. ACLI Reference Guide
  2. ACLI Configuration Elements N-Z
  3. session-constraints

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: 100
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
sustain-rate-window
Enter the time in seconds used to measure the sustained rate
  • Default: 0
  • Values: Min: 10 | Max: 999999999
    The value you set here must be higher than or equal to the value you set for the burst rate window.

    Note:

    If you are going to use this parameter, you must set it to a minimum value of 10.
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.