1. ACLI Configuration Guide
  2. Admission Control and QoS
  3. Aggregate Session Constraints for SIP

Aggregate Session Constraints for SIP

You can set a full suite of session constraints and then apply them to a SIP interface. The session constraints configuration contains many of the same parameters as the session agent, so you can configure a group of constraints and then apply them to a SIP interface/

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® Enterprise 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.

SIP interfaces now have two states: “In Service” and “Constraints Exceeded.” When any one of the constraints is exceeded, the status of the SIP interface changes to Constraints Exceeded and remains in that state until the time-to-resume period ends. The session constraint timers that apply to the SIP interface are the time-to-resume, burst window, and sustain window.

Aggregate Session Constraints Configuration

This section shows you how to configure aggregate session constraints and then apply them to a SIP interface.

The session constraints configuration contains many of the same parameters as the session agent does; it also incorporates the changes to the session agent parameters that are described in this section.

To configure the session constraints:

  1. In Superuser mode, type configure terminal and press Enter. 
    ORACLE# configure terminal
  2. Type session-router and press Enter. 
    ORACLE(configure)# session-router
  3. Type session-constraints and press Enter. 
    ORACLE(session-router)# session-constraints
  4. name—Enter the name for this session constraints configuration; this is a unique identifier that you will use in the SIP interface when you want the session constraints applied there. This is a required parameter that has no default.
  5. state—Enable this parameter to use these session constraints. The default value is enabled. The valid values are:

    • enabled | disabled

  6. max-sessions—Enter the maximum sessions allowed for this constraint. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  7. max-outbound-sessions—Enter the maximum outbound sessions allowed for this constraint. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  8. max-inbound-sessions—Enter the maximum inbound sessions allowed for this constraint. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  9. max-burst-rate—Enter the maximum burst rate (invites per second) allowed for this constraint. This value should be the sum of the max-inbound-burst-rate and the max-outbound-burst-rate. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  10. max-sustain-rate—Enter the maximum rate of session invitations per second allowed within the current window for this constraint. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

      For the sustained rate, the Oracle® Enterprise Session Border Controller maintains a current and previous window size. The period of time over which the rate is calculated is always between one and two window sizes.

  11. max-inbound-burst-rate——Enter the maximum inbound burst rate (number of session invitations per second) for this constraint. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  12. max-inbound-sustain-rate—Enter the maximum inbound sustain rate (of session invitations allowed within the current window) for this constraint. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

      For the sustained rate, the Oracle® Enterprise Session Border Controller maintains a current and previous window size. The period of time over which the rate is calculated is always between one and two window sizes.

  13. max-outbound-burst-rate——Enter the maximum outbound burst rate (number of session invitations per second) for this constraint. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  14. max-outbound-sustain-rate—Enter the maximum outbound sustain rate (of session invitations allowed within the current window) for this constraint. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

      For the sustained rate, the Oracle® Enterprise Session Border Controller maintains a current and previous window size. The period of time over which the rate is calculated is always between one and two window sizes.

  15. time-to-resume—Enter the number of seconds after which the SA (Session Agent) is put back in service (after the SA is taken OOS (Out Of Service) because it exceeded some constraint). The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  16. ttr-no-response—Enter the time delay in seconds to wait before the SA (Session Agent) is put back in service (after the SA is taken OOS (Out Of Service) because it did not respond to the Oracle® Enterprise Session Border Controller). The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  17. 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. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  18. burst-rate-window—Enter the time in seconds that you want to use to measure the burst rate; the window is the time over which the burst rate is calculated, and is used for the over all burst rate as well as the inbound and outbound burst rates. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

  19. sustain-rate-window—Enter the time in seconds used to measure the sustained rate; the window is the time over which the sustained rate is calculated, and is used for the over all sustained rate as well as the inbound and outbound sustained rates. The default value is zero (0). The valid range is:

    • Minimum—0

    • Maximum—999999999

Applying Session Constraints in a SIP Interfaces

In the SIP interface, there is a new parameter that allows you to use a set of session constraints for that interface; the parameter is called constraint-name.

To apply session constraints to a SIP interface:

  1. In Superuser mode, type configure terminal and press Enter. 
    ORACLE# configure terminal
  2. Type session-router and press Enter. 
    ORACLE(configure)# session-router
  3. Type sip-interface and press Enter. 
    ORACLE(session-router)# sip-interface
  4. constraint-name—Enter the name of the session constraints configuration that you want to apply to this SIP interface. There is no default for this parameter.
  5. Save and activate your configuration.

Configuring CAC Policing and Marking for non-Audio non-Video Media

In the media profile and the media policy configurations, the following values have been added for the media-type parameter:

  • application | data | image | text

For the media policy, these new values apply to ToS marking.

Support for the AS Bandwidth Modifier

Two new parameters have been added to the media profile configuration:

  • sdp-bandwidth—Enable or disable the use of the AS modifier in the SDP if the req-bandwidth and sdp-rate-limit-headroom parameters are not set to valid values in a corresponding media profile. The default value is disabled. The valid values are:
    • enabled | disabled
  • sdp-rate-limit-headroom—Specify the percentage of headroom to be added while using the AS bandwidth parameter while calculating the average-rate-limit (rate limit for the RTP flow). The default value is zero (0). The valid range is:
    • Minimum—0
    • Maximum—100

The following conditions apply to the use and application of these two new parameters:

  • If the amount of required bandwidth is not specified in the media profile (req-bandwidth) for the media type in the m= line of the SDP, then the value specified in the AS modifier is used. The Oracle® Enterprise Session Border Controller only uses the AS value if you set the new sdp-bandwidth to enabled.
  • If the average rate limit value for RTP flows is not specified in the media profile (average-rate-limit) for the media type in the m= line of the SDP, then the value specified in the AS modifier is used. The system only uses the AS value if you set the new sdp-bandwidth to enabled. When calculating the average rate rate limit that it will use based on the AS modifier, the Oracle® Enterprise Session Border Controller applies the percentage set in the sdp-rate-limit-headroom parameter.
  • The Oracle® Enterprise Session Border Controller uses the value specified in the AS modifier (if sdp-bandwidth is enabled, and req-bandwidth is set to 0) along with the user-cac-bandwidth value set in the realm configuration; this works the same way that the req-bandwidth parameter does.
  • The system uses the value specified in the AS modifier (if sdp-bandwidth is enabled, and req-bandwidth is set to 0) along with the max-bandwidth value set in the realm configuration; this works the same way that the req-bandwidth parameter does.

Media Profile Configuration

To set any of the new media types in the media profile configuration:

  1. In Superuser mode, type configure terminal and press Enter. 
    ORACLE# configure terminal
  2. Type session-router and press Enter. 
    ORACLE(configure)# session-router
ORACLE(session-router)#
  3. Type media-profile and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters. 
    ORACLE(session-router)# media-profile
ORACLE(media-profile)#
  4. media-type—Enter the media type that you want to use for this media profile. The valid values are:

    • audio | video | application | data | image | text

  5. Save and activate your configuration.

    To set any of the new media types in the media policy configuration:

  6. In Superuser mode, type configure terminal and press Enter. 
    ORACLE# configure terminal
  7. Type media-manager and press Enter. 
    ORACLE(configure)# media-manager
ORACLE(media-manager)#
  8. Type media-policy and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters. 
    ORACLE(media-manager)# media-policy
ORACLE(media-policy)#
  9. media-type—Enter the media type that you want to use for this media profile. The valid values are:

    • audio | video | application | data | image | text

  10. Save and activate your configuration.

AS Modifier and Headroom Configuration

To enable AS modifier use and establish the percentage of headroom to use:

  1. In Superuser mode, type configure terminal and press Enter. 
    ORACLE# configure terminal
  2. Type session-router and press Enter. 
    ORACLE(configure)# session-router
ORACLE(session-router)#
  3. Type media-profile and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters. 
    ORACLE(session-router)# media-profile
ORACLE(media-profile)#
  4. sdp-bandwidth—Enable this parameter to use the AS bandwidth modifier in the SDP. The default is disabled. Valid values are:

    • enabled | disabled

  5. sdp-rate-limit-headroom—Specify the percentage of headroom to be added while using the AS bandwidth parameter while calculating the average-rate-limit (rate limit for the RTP flow). The default is 0. The valid range is:

    • Minimum—0

    • Maximum—100

  6. Save and activate your configuration.