session-agent-group

The session-agent-group element creates a group of Session Agents and/or groups of other SAGs. The creation of a SAG indicates that its members are logically equivalent and can be used interchangeably. This allows for the creation of constructs like hunt groups for application servers or gateways.

Parameters

group-name

Enter the name of the session-agent-group element. This required entry must follow the Name Format, and it must be unique.

description

Describe the session agent group element

state

Enable or disable the session-agent-group element

• Default: enabled
• Values: enabled | disabled

app-protocol

Distinguish H.323 session agent groups from SIP session agent groups

• Default: SIP
• Values: H323 | SIP

strategy

Select the session agent allocation options for the session-agent-group. Strategies determine how session agents will be chosen by this session-agent-group element.

• Default: Hunt
• Values:
  • Hunt—Selects session agents in the order in which they are listed
  • RoundRobin—Selects each session agent in the order in which they are listed in the dest list, selecting each agent in turn, one per session. After all session agents have been used, the first session agent is used again and the cycle continues.
  • LeastBusy—Selects the session agent that has the fewest number of sessions relative to the max-outbound-sessions constraint or the max-sessions constraint (i.e., lowest percent busy) of the session-agent element
  • PropDist—Based on programmed, constrained session limits, the Proportional Distribution strategy proportionally distributes the traffic among all of the available session-agent elements
  • LowSusRate—Routes to the session agent with the lowest sustained rate of session initiations/invitations

dest

Enter one or more destinations (i.e., next hops) available for use by this session-agent group. The destination value(s) must correspond to a valid IP address or hostname.

trunk-group

Enter trunk group names and trunk group contexts to match in either IPTEL or custom format. If left blank, the Oracle Communications Session Border Controller uses the trunk group in the realm for this session agent group. Multiple entries are surrounded in parentheses and separated from each other with spaces.

Entries for this list must one of the following formats: tgrp:context or tgrp.context.

sag-recursion

Enable or disable SIP SAG recursion for this SAG

• Default: disabled
• Values: enabled | disabled

stop-sag-recurse

Enter the list of SIP response codes that terminate recursion within the SAG. On encountering the specified response code(s), the Oracle Communications Session Border Controller returns a final response to the UAC and stops trying to route the message. This includes not attempting to contact higher-cost SAs.

You can enter the response codes as a comma-separated list or as response code ranges.

• Default: 401, 407

Path

session-agent-groupis an element under the session-router path. The full path from the topmost ACLI prompt is: configure terminal , and then session-router , and then session-group.

Note:

This is a multiple instance configuration element.