Media System - CLI

dedicatedBWForNonRTPMedia

Use this control to specify (reserve) an amount, as a percentage, of bandwidth usage to limit across all physical interfaces for non-RTP media (default = 0).

NOTE: This feature only applies to TCP media traffic such as MSRP.

mediaPeerInactivity

N/A

Use this control to set detection of media peer inactivity (inactivityTimeout) which can be used in conjunction with packet loss rate parameter (packetLossThreshold) of Packet Service Profile. 

• inactivityTimeout – (range: 20-1260 / default = 60)  Set RTP/RTCP inactivity timeout value (in seconds, in multiples of 10) to guard against loss of media connection. The timer is restarted whenever an RTP or RTCP packet is received from the peer.

When both RTP and RTCP are enabled, the timeout will only occur if both packet types remain undetected for the configured inactivityTimeout duration. If RTCP is not enabled, then only the absence of RTP causes the timer to expire.

When mediaPeerInactivity is enabled (configured with an inactivityTimeout value), the SBC detects media inactivity within the configured inactivity timeout value + X, and then executes the configured action (where the X is from 0 - 10 seconds).

INFO: When using this feature, you must also set the "peerAbsenceAction" flag from Packet Service Profile (refer to Packet Service Profile - CLI).

NOTE: If a valid RTP stream does not send enough packets, use mediaPeerInactivity with RTCP only.

NOTE: If the endpoint does not send both RTP and RTCP packets frequently enough within the inactivityTimeout duration, Ribbon recommends to avoid using mediaPeerInactivity. 

mediaPortRange

N/A

Use this control to set the UDP media port range for RTP and RTCP.

• baseUdpPort – Base UDP port number (inclusive) for RTP/RTCP media. (range: 1024-65534 / default = 1024).
• maxUdpPort – Maximum UDP port number (inclusive) for RTP/RTCP media. (range: 1024-65534 / default = 65148). An error message appears if you set the range to a value greater than 65148 because that overlaps a Linux reserved port range (65150 to 65535). Do not specify a value greater than 65148.
• highPriorityPortRangeLocation – Specifies whether the high priority port range, if specified, occurs at the top or the bottom of the media port range.
  • bottom – high priority ports are at the bottom of the range.
  • top – high priority ports are at the top of the range.
• highPriorityPortRangeSize – Specifies the percentage of the configured port range to include in the high priority range. Specifying 0 disables having a high priority range.(range: 0-25)

High priority port range is optional configuration that divides the media port range into a high-priority port range and a low-priority port range. Under congestion conditions, all the packets received on ports outside the high priority media range are dropped automatically by the network processing layer. Therefore, if you choose to configure SIP signaling ports within the media port range, 

mediaRtcpControl

N/A

Use this control to configure the RTCP session.

• sendBYEPacket – Use this flag to choose whether or not to send RTCP BYE packet. 
  • disabled – Use this setting to suppress RTCP BYE packet in a pass-through scenario when RTCP terminationForPassthrough option is enabled and the call is not established. This setting is useful to avoid one-way audio when Dynamic LRBT and RTCP are in use at the same time.
  • enabled – When this flag is enabled, the SBC sends the RTCP BYE packet when a call is terminated. This command affects all calls configured with RTCP termination.
• senderReportInterval – Use this value as the initial interval (in seconds) for SBC to generate sender/receiver report when RTCP is terminated on the SBC. (range: 5-120 / default = 5).

tcpPortRange

This port range is used by the SBC to advertise its TCP port on which it can accept connections. A unique unused port from this range will be included in the SDP media line in the offer or answer towards the MSRP UAs. SBC uses a port from this range per MSRP call leg if it takes up a TCP server role.

To create a TCP port range, use the baseServerPort and maxServerPort to specify the minimum and maximum values as described below.

• baseServerPort – Base port number (inclusive) for TCP media server (range: 1-65534 / default = 1024).
• maxServerPort – Maximum port number (inclusive) for TCP media server (range: 1-65534 / default = 65534).