DTMF Transfer Configuration

RFC 2833 Session Agent Configuration

Session agents, used as a way to classify and act on a subset of a signaling interface’s traffic, also have rfc2833-mode and rfc2833-payload parameters. The configurations of these parameters overrides the configuration of the same-named parameters on the signaling interface where the session agent resides. You can set the rfc2833-mode parameter to none for a session agent to revert to the parent signaling interface’s two RFC 2833 settings.

ACLI Configuration and Instructions

This section explains how to configure the RFC 2833 mode on a signaling interface and on a session agent configured for that signaling interface. The session agent’s configuration takes precedence over the signaling interface, unless the session agent’s rfc2833-mode is set to none. In that case, the signaling interface’s configuration is used for applicable traffic.

SIP Interface

To configure the RFC 2833 mode on 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. If you are adding support for this feature to a pre-existing SIP interface, then you must select the specific configuration instance, using the ACLI select command.
  5. rfc2833-mode—Set this parameter to either transparent, preferred, or dual based upon the behavior your want for this SIP interface.
    • transparent—does not add RFC 2833 telephone-event into SDP if not present, and does not prefer.

    • preferred—adds RFC 2833 telephone-event media type into SDP and prefers to use this method for DTMF indication.

    • dual—adds RFC 2833 telephone-event media type into SDP and sends both SDP and signaling-based DTMF indications if possible.

  6. rfc2833-payload—Set this parameter to the media-type value you wish to use when inserting RFC 2833 telephone-events into an SDP offer. 101 is the generally accepted media type for RFC 2833 telephone-events.
  7. Save and activate your configuration.

Session Agent

Session agent RFC 2833 mode configurations override those on the signaling interface where they exit. The none parameter is used to defer to the signaling interface.

To configure the RFC 2833 mode on a session agent:

  1. In Superuser mode, type configure terminal and press Enter.
    ORACLE# configure terminal
  2. Type session-router and press Enter to access the system-level configuration elements.
    ORACLE(configure)# session-router
  3. Type session-agent and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.
    ORACLE(session-router)# session-agent
    ORACLE(session-agent)#
  4. Select the session agent where you want this feature.
    ORACLE(session-agent)# select 1
  5. rfc2833-mode—Set this parameter to either none, transparent, preferred, or dual based upon the behavior your want for this SIP interface.
    • none—defaults to the behavior of the SIP interface for traffic that matches this session agent.

    • transparent—does not add RFC 2833 telephone-event into SDP if not present, and does not prefer.

    • preferred—adds RFC 2833 telephone-event media type into SDP and prefers to use this method for DTMF indication.

    • dual—adds RFC 2833 telephone-event media type into SDP and sends both SDP and signaling-based DTMF indications if possible.

  6. rfc2833-payload—Set this parameter to the media-type value you wish to use when inserting RFC 2833 telephone-events into an SDP offer. 101 is the generally accepted media type for RFC 2833 telephone-events.
  7. Save and activate your configuration.

Codec Policy

To configure a codec policy to support DTMF audio tones, as transcoded:

  1. In Superuser mode, type configure terminal and press Enter.
    ORACLE# configure terminal
  2. Type media-manager and press Enter.
    configure# media-manager
  3. Type codec-policy and press Enter.
    ORACLE(media-manager)# codec-policy
    ORACLE(codec-policy)#
  4. If you are adding support for this feature to a pre-existing configuration, then you must select the specific configuration instance, using the ACLI select command.
    ORACLE(codec-policy)# select
    <name>:
    1: private
    2: public
    selection:1
    ORACLE(codec-policy)#
  5. dtmf-in-audio—Set this parameter to disabled, preferred, or dual based upon how the Oracle® Enterprise Session Border Controller should support the conversion of signaling messages or RFC 2833 to DTMF Audio tones in the realm where this codec policy is active.
    • disabled—does not support DTMF audio tones as transcoded in this realm.

    • preferred—supports DTMF audio tones as transcoded in this realm.

    • dual—supports both transcoded DTMF audio tones and signaling-based DTMF indications if possible.

  6. Save and activate your configuration.

Translate Non2833 Event Behavior

To configure the exceptional behavior:

  1. In Superuser mode, type configure terminal and press Enter.
    ORACLE# configure terminal
  2. Type media-manager and press Enter to access the media-level configuration elements.
    ORACLE(configure)# media-manager
    ORACLE(media-manager)#
  3. Type media-manager and press Enter to begin configuring this feature.
    ORACLE(media-manager)# media-manager
    ORACLE(media-manager-config)#
  4. translate-non-rfc2833-event—Set this parameter to enabled to use non-default behavior described in Override Preferred RFC 2833.
  5. translate-non-inband-event—Set this parameter to enabled to use non-default behavior described in Override Preferred DTMF Audio.
  6. Save and activate your configuration.

P-dual-info Header Appearance

Customizing the P-Dual-Info header is performed globally from the sip config.

To configure how the P-dual-info header appears:

  1. In Superuser mode, type configure terminal and press Enter.
    ORACLE# configure terminal
  2. Type session-router and press Enter to access the system-level configuration elements.
    ORACLE(configure)# session-router
  3. Type sip-config and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.
    ORACLE(session-router)# sip-config
    ORACLE(sip-config)#
  4. Type options followed by a Space.
  5. After the Space, type the P-Dual-Info header information in the following format:
    +dual-info=”<header-name>”

    For example:

    ORACLE(sip-config)# options dual-info=P-Dual-Info
  6. Save your work using the ACLI done command.