In this section:
Use this object to define the parameters associated with the Media features for this SIP trunk group.
As a best practice, always use UPPERCASE for trunk group names.
The SBC 5210 and SBC 7000 systems support creating IP Interface Groups containing sets of IP interfaces that are not "processor friendly" (i.e. carried on physical Ethernet ports served by separate processors). However, restrictions exist regarding the usage of such Interface Groups.
(This ability does not apply to the SBC 5110 and 5400 systems which have only two physical media ports. IP interfaces from the two physical ports may be configured within the same IP Interface Groups without restrictions.)
For complete details, refer to Configuring IP Interface Groups and Interfaces.
% set addressContext <name> zone <name> sipTrunkGroup <name> media advertiseAudioOnly <disabled | enabled> anat answerPreference <honorRecvPrec | iPv4 | iPv6 | matchSigAddrType> offerPreference <iPv4 | iPv6 | matchSigAddrType> appSpecificBandwidth <disabled | enabled> comediaConnectionRole <active | none | passive> dataPathModePassthru <disabled | enabled> directMediaAllowed <disabled | enabled> directMediaAllowedBehindNapt <disabled | enabled> directMediaAntiTrombone <disabled | enabled> directMediaGroupId <#> disallowSrtpStream dtlsProfileName <profile name> earlyMedia ice lateMediaSupport <convert | passthru> multipleAudioStreamsSupport lyncShare <disabled | enabled> maxPtimeDefault <#> mediaAddrType <iPv4 | iPv6 | iPv4andiPv6 | matchSigAddrType> mediaIpAddress <IPv4 or IPv6 address> mediaIpInterfaceGroupName <IPIG name> mediaIpSecondaryInterfaceGroupName <IPIG name> mediaPortRange baseUdpPort <1024-65534, or "none"> maxUdpPort <1024-65534, or "none"> msrp <disabled | enabled> msrpMux <disabled | enabled> omrAllowed <disabled | enabled | ravelCallOnly> omrPrimaryRealm <OMR primary realm name> pcrf recordable <disabled | enabled> relayUnknownAttrsForAudioTrancodeCalls <disabled | enabled> sdpAttributesSelectiveRelay <disabled | enabled> sourceAddressFiltering <disabled | enabled> tcpPortRange baseServerPort <1-65534, or "none"> maxServerPort <1-65534, or "none"> tmr64K <disabled | enabled>
SIP Trunk Group Media Parameters
Parameter | Length/Range | Description |
---|---|---|
| N/A | Enable flag to suppress non-audio streams and send only the main audio/image stream in the SDP offer. This flag controls both the initial and subsequent offers.
|
anat | N/A | Alternative Network Address Types (ANAT) configuration options.
Note: The Note
Ribbon recommends to avoid configuring both Media Nat and ICE Support on the same Trunk Group because these configurations are independent mechanisms for solving NAT traversal issues. Because of of this, these configurations should not coexist on the same Trunk Group. |
appSpecificBandwidth | N/A | Enable this flag on a trunk group to include the b=AS attribute in the SDP outgoing offer or answer sent on that trunk group.
This flag does not insert the b=AS SDP attribute for non-audio streams or at the session level. The b=AS SDP attribute does not apply to the H.323 signaling interface. |
comediaConnectionRole | N/A | This indicates whether the SDP offer sent by SBC includes any direction attribute line defined by COMEDIA draft.
|
dataPathModePassThru | N/A | Specifies whether the SBCwill transparently pass media direction (Data Path Mode) received from a peer in the Offer SDP RTP IP.
|
directMediaAllowed | N/A | If enabled, attempt to set up a direct-media path so that media flows directly between endpoints in the same direct-media group.
|
directMediaAllowedBehindNapt | N/A | If enabled, attempt to set up a direct-media call for endpoints behind NAT.
|
directMediaAntiTrombone | N/A | Enable flag on trunk groups facing AS to allow direct media using C-line trigger (e.g. media anti-trombone).
Note: Direct Media configuration ( |
directMediaGroupId | 0-65535 | This identifies the direct media group to which this trunk group belongs.(default = 0). |
disallowSrtpStream | Determines whether the SBC forwards SRTP streams on egress when they are received in incoming SDP, or if it sets the port to zero, thus disabling the SRTP stream. Multiple audio m-line support (multipleAudioStreamsSupport) must be enabled before you can enable this parameter. The options are:
| |
dtlsProfileName | 1-23 | <profile name> – Name of DTLS Profile to associate with this SIP trunk group. |
earlyMedia | N/A | Use this object to configure early Media support. See Early Media Parameters table below for details. |
ice | N/A | ICE SDP grouping method options. See ICE Parameters table below for details. |
lateMediaSupport | N/A | Use this parameter on the ingress trunk group to determine whether a SIP late media (reverse offer) INVITE is converted to a forward offer on egress or else allowed to transparently pass through.
|
lyncShare | N/A | This parameter supports Lync/Desktop sharing application media streams.
Refer to Configuring SBC and LYNC in Media Environment for configuration details. |
maxPtimeDefault | 10-150 | This parameter indicates the default packet size in milliseconds. (default = 150). |
mediaAddrType | N/A | The Media Address Type attribute determines the type of IP address used in the offer.
|
mediaIpAddress | IPv4/IPv6 | Each trunk group can have a The Note: If you prefer to instead choose an IP Address from a range of values configured in Note: Does not apply to D-SBC. |
mediaIpInterfaceGroupName | N/A | Name of the IP interface group for media, up to 23 characters. The specified name must be the name of a valid, existing ipInterfaceGroup. |
| N/A | Specifies the name of a secondary (or public/external address) IP interface group to use for media for calls involving the Microsoft Teams Phone System. |
mediaPortRange | N/A | Use this media control to set the
NOTE: When provisioning a UDP media port range, set the range slightly larger than the actual number of ports needed to support maximum simultaneous calls. |
msrp | N/A | This flag is enabled by default allowing MSRP payload relay over TCP connections upon successful negotiation of MSRP SDP attributes.
|
msrpMux | N/A | Enable this flag to reuse an existing TCP connection with an IP peer for multiple MSRP sessions (MSRP multiplexing). MSRP multiplexing applies only to MSRP sessions established using back-to-back user agent (B2BUA) behavior. Multiplexing cannot be applied to MSRP sessions established based on the RFC 6714 “Connection Establishment for Media Anchoring” (CEMA) type of handling. The options are:
|
multipleAudioStreamsSupport | N/A | This flag determines whether the SBC processes multiple audio m-lines, or a combination of audio and image m-lines, in SDP. The options are:
|
omrAllowed | N/A | Use this parameter to specify when to apply OMR procedures. (see Configuring SBC to Apply OMR Rules for additional details)
Note: The PSX flag NOTE: This configuration is not supported on ERE and is intended for use only with an external PSX. |
omrPrimaryRealm | N/A |
NOTE: This configuration is not supported on ERE and is intended for use only with an external PSX. |
pcrf | N/A | Use this object to define Policy and Charging Rules Function (PCRF) parameters. See PCRF Parameters table below for details. |
recordable | N/A | Enable flag to support media recording of RTP stream to an external recording device on this SIP trunk group.
|
relayUnknownAttrsForAudioTrancodeCalls | N/A | Use this flag to specify whether or not to relay of unknown SDP attributes in the core audio stream for transcoded calls. Options are:
|
sdpAttributesSelectiveRelay | N/A | Enable this flag to control the selective relay of unknown SDP attributes at session level and selective relay of unknown SDP attributes in the core audio stream.
|
sourceAddressFiltering | N/A | When enabled, incoming media packets which do not match the expected source IP address and UDP/TCP port are filtered out.
|
tcpPortRange | N/A | Use this media control to set the
|
tmr64K | N/A | Enable this flag to allow the transmission Medium Requirement Unrestricted 64kbit/s control for SIP-ISUP interworking.
|
% set addressContext <name> zone <name> sipTrunkGroup <name> media earlyMedia forkingBehaviour <firstProvResponse | firstRtp | lastReceivedSdp | pemPriority> relayPemState <disabled | enabled> suppressGatedParam <disabled | enabled> method pEarlyMedia defaultGatingMethod <inactive | none | recvonly | sendonly | sendrecv> egressSupport <disabled | enabled> rtpServerTable rtpServerTableName sessionAnswer
Early Media Parameters
Parameter | Description |
---|---|
forkingBehaviour | Use this parameter to identify the method to provide early dialog media selection.
|
relayPemState | Disable this flag to suppress the P-Early Media (PEM) Legacy behavior.
Exceptions:
|
suppressGatedParam | If this flag is enabled, the SBC does not sends the Gated Param in PEM towards Ingress.
|
method | Select a method to use to provide early media.
|
% set addressContext <name> zone <name> sipTrunkGroup <name> media ice answerPreference <honorRecvPrec | ipv4 | ipv6 | matchSigAddrType> offerPreference <ipv4 | ipv6 | matchSigAddrType>
ICE Parameters
Parameter | Description |
---|---|
answerPreference | This parameter determines which IP version to use for calls when multiple versions are specified using candidate lines for host type in answer.
|
offerPreference | This parameter determines which IP version appears first in the SDP offer.
|
The ice
object is only available when mediaAddrType
is set to iPv4andiPv6
and the sipTrunkGroup
services
' iceSupport
parameter is set to iceLync
.
For example, the following commands are used to enable the ice
parameter for the address context AC1 with the zone "Zone1" and "SipTrnkGrp1" SIP trunk group:
% set addressContext AC1 zone
Zone1
sipTrunkGroup SipTrnkGrp1
media mediaAddrType iPv4andiPv6
% set addressContext AC1 zone Zone1
sipTrunkGroup SipTrnkGrp1
services natTraversal iceSupport iceLync
Now, the ice
object can be set:
% set addressContext AC1 zone Zone1 sipTrunkGroup SipTrnkGrp1 media ice
Possible completions:
answerPreference - Answer version precedence when SDP method is ICE
offerPreference - Offer version precedence when SDP method is ICE
Ribbon recommends to avoid configuring both Media Nat and ICE Support on the same Trunk Group because these configurations are independent mechanisms for solving NAT traversal issues. Because of of this, these configurations should not coexist on the same Trunk Group.
% set addressContext <name> zone <name> sipTrunkGroup <name> media pcrf cushionNullSdp <disabled | enabled> cushionPacketSize <disabled | enabled> fetchLocationInfo <none | retrieveInOffer | retrieveInAnswer> pcrfCommitment <none | required | supported> pcrfInteractionMode <synchronous | asynchronous> pcrfRealm <DIAMETER domain> pcrfSendAarOnlyForSessionAnswer <disabled | enabled> provSignalingFlow <disabled | enabled> signallingPath <disabled | enabled> terminateOnNwFailure <disabled | enabled>
PCRF Parameters
Parameter | Description |
---|---|
cushionNullSdp | Enable flag to allow Authorization/Authentication Request (AAR) when initial call setup is an INVITE which lacks SDP (estimate G.711 10 msec as a worst case). Disable flag to wait for reverse offer.
|
cushionPacketSize | Enable flag to use the smallest packet size in an answer from the range supported for each codec for bandwidth estimate.Disable flag to use packet size in offer.
Note: Enabling this option may avoid rejecting an answer because its AAR fails even though the offer AAR succeeds, and also to abort a call after ringing the destination. |
fetchLocationInfo | Specify when P-CSCF requests Location information.
|
pcrfCommitment | The degree of commitment expected from the PCRF during call setup or call update.
|
pcrfInteractionMode | Use this object to specify whether PCRF interaction is synchronous or asynchronous.
|
pcrfRealm <string> | The DIAMETER domain of a Policy and Charging Rule Function (up to 127 characters). |
pcrfSendAarOnlyForSessionAnswer | Use this flag to control the sending of AAR messages.
|
provSignalingFlow | Enable flag to send P-Access-Network-Info header.
|
signallingPath | Enable flag to subscribe for the Signaling Bearer Events.
|
terminateOnNwFailure | Enable flag to terminate call on receiving TEMPRARY_NETWORK_FAILURE in AAA.
|