Secure Tone on MGCP TDM Gateways

The Secure Tone feature provides support for Cisco Unified Communications Manager (UCM) to play a secure or non secure tone when the secure status of the call changes.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Prerequisites for Secure Tone on MGCP TDM Gateways

  • Cisco Unified Communications Manager (UCM) 8.0(3) or a later release is running.

  • Cisco IOS Media Gateway Control Protocol (MGCP) version 0.1 is configured.

Restrictions for Secure Tone on MGCP TDM Gateways

  • Cisco UCM 8.0 will play the secure or non-secure indication tone to the protected device only when a two-way media connection is established.

  • This feature is available only on Cisco IOS secure images.

Secure Tone on MGCP TDM Gateways

Cisco UCM not provides support for including supplementary service calls such as transfer and conferencing also changes the way in which secure and non secure indication tones are played. This new feature of playing the secure indication tone is based on the overall secure status unlike the earlier versions when it was based on end-to-end device's protected status. If the overall status is secure, the Secure Indication Tone (SIT) will be played to the protected phone. If the overall secure status is non secure, the Non-Secure Indication Tone (NSIT) will be played to the protected phone. SIT or NSIT will be played when a two-way audio media connection is first established on the protected phone.

Cisco UCM sends a Notification Request (RQNT) with the newly defined tone ID for secure or non secure status. Following is a sample message sent from Cisco UCM to the MGCP gateway to play the secure tone when the status of the call changes: 


RQNT 199 S2/DS1-0/1@nw053b-3745.cisco.com MGCP 0.1
X: 1
R: D/[0-9ABCD*#]
S: X+TONE/st
Q: process,loop

How to Configure Secure Tone on MGCP TDM Gateways

Configuring Secure Tone on MGCP TDM Gateways

SUMMARY STEPS

  1. enable
  2. configure terminal
  3. mgcp package-capability tone-package
  4. exit

DETAILED STEPS

  Command or Action Purpose
Step 1

enable

Example:


Router> enable

Enables privileged EXEC mode.

  • Enter your password if prompted.

Step 2

configure terminal

Example:


Router# configure terminal

Enters global configuration mode.

Step 3

mgcp package-capability tone-package

Example:


Router(config)# mgcp package-capability tone-package

Configures the secure tone capability for MGCP packages.

Step 4

exit

Example:


Router# exit

Exits the current mode.

Verifying and Troubleshooting Secure Tone on MGCP TDM Gateways

SUMMARY STEPS

  1. show mgcp
  2. debug mgcp all
  3. debug mgcp packets

DETAILED STEPS

Step 1

show mgcp

This command is used for displaying the values for MGCP parameters. The parameters are displayed only when the tone package has been enabled using the mgcp package-capability tone-package command.

Step 2

debug mgcp all

This command is used to enable all debug traces for the MGCP gateway.

Step 3

debug mgcp packets

This command is used for enabling debug traces for the MGCP packets.

Configuration Examples for Secure Tone on MGCP TDM Gateways

Example Configuring Secure Tone for MGCP TDM Gateways

The following example shows how to enable the trunk package, DTMF package, script package, and tone package on the gateway, and then names the trunk package as the default package for the gateway: 


Router(config)# mgcp package-capability trunk-package
Router(config)# mgcp package-capability dtmf-package
Router(config)# mgcp package-capability script-package
Router(config)# mgcp package-capability tone-package
Router(config)# mgcp default-package trunk-package

Example Verifying Secure Tone for MGCP TDM Gateways

The following is a partial sample output from the show mgcp command when the package capability has been enabled for tone package: 


Router# show mgcp
MGCP Admin State ACTIVE, Oper State ACTIVE - Cause Code NONE
MGCP call-agent: 10.7.0.200 3460 Initial protocol service is MGCP 0.1
MGCP validate call-agent source-ipaddr DISABLED
MGCP block-newcalls DISABLED
MGCP send SGCP RSIP: forced/restart/graceful/disconnected DISABLED 
MGCP quarantine mode discard/step
GCP quarantine of persistent events is ENABLED
MGCP dtmf-relay for VoIP disabled for all codec types
MGCP dtmf-relay for VoAAL2 disabled for all codec types
MGCP voip modem passthrough mode: NSE, codec: g711ulaw, redundancy: DISABLED, 
MGCP voaal2 modem passthrough disabled
MGCP voip nse modem relay: Disabled
MGCP voip mdste modem relay: Enabled
        SPRT rx v14 hold time: 50 (ms), SPRT tx v14 hold count: 16,
        SPRT tx v14 hold time: 20 (ms), SPRT Retries: 12
        SSE redundancy interval: 20 (ms), SSE redundancy packet: 3,
        SSE t1 timer: 1000 (ms), SSE retries: 3

The following lines show that the tone-package keyword is enabled: 


MGCP supported packages: gm-package dtmf-package mf-package trunk-package 
                         line-package hs-package rtp-package script-package ms-package 
                         dt-package mo-package mt-package sst-package mdr-package 
                         fxr-package pre-package mdste-package srtp-package tone-package

Additional References

Related Documents

Related Topic

Document Title

Cisco IOS commands

Cisco IOS Master Commands List, All Releases

MGCP configuration

MGCP and Related Protocols Configuration Guide

Cisco IOS voice configuration

Cisco IOS Voice Configuration Library

Cisco IOS voice commands

Cisco IOS Voice Command Reference

Cisco IOS debug commands

Cisco IOS Debug Command Reference

Standards

Standard

Title

None

--

MIBs

MIB

MIBs Link

None

To locate and download MIBs for selected platforms, Cisco software releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs

RFCs

RFC

Title

None

--

Technical Assistance

Description

Link

The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password.

http://www.cisco.com/cisco/web/support/index.html

Feature Information for Secure Tone on MGCP TDM Gateways

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Table 1. Feature Information for Secure Tone Support on MGCP TDM Gateway

Feature Name

Releases

Feature Information

Secure Tone Support on MGCP TDM Gateway

15.1(4)M

This feature provides support for the Cisco UCM to play a secure or non secure tone when the secure status of the call changes or when the media are reconnected after the call is answered.

The following command was introduced or modified: mgcp package capability tone-package.