SIP Per-Realm CAC

Building on the Oracle® Enterprise Session Border Controller’s pre-existing call admission control methods, CAC can be performed based on how many minutes are being used by SIP or H.323 calls per-realm for a calendar month.

In the realm configuration, you can now set a value representing the maximum number of minutes to use for SIP and H.323 session using that realm. Although the value you configure is in minutes, the Oracle® Enterprise Session Border Controller performs CAC based on this value to the second. When you use this feature for configurations with nested realms, the parent realm will have the total minutes for all its child realms (i.e., at least the sum of minutes configured for the child realms).

The Oracle® Enterprise Session Border Controller calculates the number of minutes used when a call completes, and counts both call legs for a call that uses the same realm for ingress and egress. The total time attributed to a call is the amount of time between connection (SIP 200 OK) and disconnect (SIP BYE), regardless of whether media is released or not; there is no pause for calls being placed on hold.

If the number of minutes is exhausted, the Oracle® Enterprise Session Border Controller rejects calls with a SIP 503 Service Unavailable message (including additional information “monthly minutes exceeded). In the event that the limit is reached mid-call, the Oracle® Enterprise Session Border Controller continues with the call that pushed the realm over its threshold but does not accept new calls. When the limit is exceeded, the Oracle® Enterprise Session Border Controller issues an alarm and sends out a trap including the name of the realm; a trap is also sent when the alarm condition clears.

Note:

The Oracle® Enterprise Session Border Controller does not reject GETS/NSEP calls based on monthly minutes CAC.

You can change the value for minutes-based CAC in a realm configuration at any time, though revising the value downward might cause limits to be reached. This value resets to zero (0) at the beginning of every month, and is checkpointed across both system in an HA node. Because this data changes so rapidly, however, the value will not persist across and HA node if both systems undergo simultaneous failure or reboot.

You can use the ACLI show monthly minutes <realm-id> command (where <realm-id> is the realm identifier of the specific realm for which you want data) to see how many minutes are configured for a realm, how many of those are still available, and how many calls have been rejected due to exceeding the limit.

SIP per Realm CAC Configuration

This section shows you how to configure minutes-based CAC for realms and how to display minutes-based CAC data for a specific realm.

Enabling Realm-Based CAC

Note that setting the new monthly-minutes parameters to zero (0), or leaving it set to its default of 0, disables this feature.

To configure minutes-based CAC:

  1. In Superuser mode, type configure terminal and press Enter.
    ORACLE# configure terminal
    ORACLE(configure)#
  2. Type media-manager and press Enter.
    ORACLE(configure)# media-manager
    ORACLE(media-manager)#
  3. Type realm-config and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.
    ORACLE(media-manager)# realm-config
    ORACLE(realm-config)#
  4. Select the realm where you want to want to add SIP per user CAC.
    ORACLE(realm-config)# select
  5. monthly-minutes—Enter the number of minutes allowed during a calendar month in this realm for SIP and H.323 calls. By default, this parameter is set to zero (0), which disabled monthly minutes-based CAC. You can enter a value as high as 71582788.
  6. Save and activate your configuration.

Viewing Realm-Based CAC Data

Use the ACLI show monthly-minutes command to see the following information:

  • How many minutes are configured for a realm
  • How many of those are still available
  • How many calls have been rejected due to exceeding the limit

    To view information about SIP per user CAC using the IP address mode:

  1. In either User or Superuser mode, type show monthly-minutes <realm-id>, a Space, and the IP address for which you want to view data. Then press Enter. The <realm-id> is the realm identifier for. the realm identifier of the specific realm for which you want data
    ORACLE# show monthly-minutes private_realm