Table Of Contents
Fundamental Cisco Unified Border Element Configuration
Prerequisites for Fundamental Cisco Unified Border Element Configuration
Restrictions for Fundamental Cisco Unified Border Element Configuration
Information About Cisco Unified Border Element Features
How to Configure Fundamental Cisco Unified Border Element
Configuring an Ethernet Interface
Configuring a RTP Loopback Interface
Configuring Codec Transparency on a Cisco Unified Border Element
Configuring Codec Transparency for All Dial Peers in a Voice Class
Configuring Codec Transparency for an Individual Dial Peer
Configuring the GSMAMR-NB Codec on a Cisco Unified Border Element
Configuring iLBC Codec on a Cisco Unified Border Element
Configuring QoS for a Cisco Unified Border Element
Configuring Cisco Unified Border Element for High Utilization
Increase I/O Memory for High Utilization
Manage Ethernet Hold Queue for High Utilization
Configuring Cisco Unified Border Element with OSP
Media Statistics on a Cisco Unified Border Element
Information About Media Statistics in an Cisco Unified Border Element
Configuring Media Statistics in a Cisco Unified Border Element
Configuring Media Statistics in Voice-Service Configuration Mode
Configuring Media Statistics on Dial Peer Configuration Mode
Monitoring Media Statistics in a Cisco Unified Border Element
Voice Quality Enhancements on Cisco Unified Border Element
Configuring Codec Repacketization
Configuring Codec Repacketization the Incoming VoIP Dial Peer
Configuring Codec Repacketization the Outgoing VoIP Dial Peer
Verifying Codec Repacketization
Configuring IP-to-IP Call Gain/Loss Control
Configuring IP-to-IP Call Gain/Loss Control on the Incoming VoIP Dial Peer
Configuring IP-to-IP Call Gain/Loss Control on the Outgoing VoIP Dial Peer
Verifying IP-IP Call Gain/Loss
Configuring Voice Quality Metrics
Verifying Voice Quality Metrics
Troubleshooting and Verifying Fundamental Cisco Unified Border Element Configuration and Operation
Verifying Fundamental Cisco Unified Border Element Configurations
Configuration Examples for Fundamental Cisco Unified Border Element
Cisco Unified Border Element: Example
Local-to-Remote Network Using the Cisco Unified Border Element: Example
Remote-to-Local Network Using the Cisco Unified Border Element: Example
Remote-to-Remote Network Using a Cisco Unified Border Element: Example
Remote-to-Remote Network Using Two Cisco Unified Border Elements: Example
Codec Repacketization: Example
Voice Quality Metrics: Example
Feature Information for Cisco Unified Border Element Configuration Guide
Fundamental Cisco Unified Border Element Configuration
Revised: October 27, 2009First Published: June 19, 2006Last Updated: October 27, 2009This chapter describes fundamental configuration tasks required for Fundamental Cisco Unified Border Element functionality. A Cisco Unified Border Element, in this guide also called an IP-to-IP gateway (IPIPGW), border element (BE), or session border controller, facilitates connectivity between independent VoIP networks by enabling H.323 VoIP and videoconferencing calls from one IP network to another. This gateway performs most of the same functions of a PSTN-to-IP gateway, but typically joins two IP call legs, rather than a PSTN and an IP call leg.
Activation Cisco Product Authorization Key (PAK)—A Product Authorization Key (PAK) is required to configure some of the features described in this guide. Before you start the configuration process, please register your products and activate your PAK at the following URL http://www.cisco.com/go/license.Your software release may not support all the features documented in this module. For the latest feature information and caveats, see 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 "Cisco Unified Border Element Features Roadmap" section on page 1.
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
For more information about Cisco IOS voice features, see the entire Cisco IOS Voice Configuration Library—including feature documents, and troubleshooting information—at http://www.cisco.com/univercd/cc/td/doc/product/software/ios124/124tcg/vcl.htm.
Contents
•
Prerequisites for Fundamental Cisco Unified Border Element Configuration
•
Restrictions for Fundamental Cisco Unified Border Element Configuration
•
Information About Cisco Unified Border Element Features
•
How to Configure Fundamental Cisco Unified Border Element
•
Configuration Examples for Fundamental Cisco Unified Border Element
•
Feature Information for Cisco Unified Border Element Configuration Guide5
Prerequisites for Fundamental Cisco Unified Border Element Configuration
•
Perform the prerequisites listed in the "Prerequisites for Cisco Unified Border Element Configuration" section in this guide.
•
Perform basic H.323 gateway configuration.
•
Perform basic H.323 gatekeeper configuration.
Note
For configuration instructions, see the "Configuring H.323 Gateways" and "Configuring H.323 Gatekeepers" chapters of the Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2.
Restrictions for Fundamental Cisco Unified Border Element Configuration
•
Cisco Unified Border Elements that require the Registration, Admission, and Status (RAS) protocol must have a via-zone-enabled gatekeeper or equivalent.
•
Cisco Unified Border Elements interoperate with Cisco ATA 186, Cisco ATA 188, Cisco CallManager, Cisco CallManager Express 3.1, Cisco IOS gateways, NetMeeting, and Polycom ViewStation.
•
Cisco fax relay is reported as a voice call on an Cisco Unified Border Element.
•
Fax calls are reported as a modem plus fax call when modem CLI are present.
•
Slow-start to fast-start interworking is supported only for H.32-to-H.323 calls.
•
DTMF Interworking rtp-nte to out of band is not supported when high density transcoder is enabled. Use normal transcoding for rtp-nte to out of band DTMF interworking.
•
The transcoding process on the Cisco Unified Border Element will always drop fast-start calls down to slow-start between H.323 endpoints even when the H.323 terminating endpoints support fast-start calls.
•
Cisco Unified Border Element supports T.38 fax relay (H.323 Annex D). However, endpoints configured with Named Signaling Events (NSE) may result in reduced fax transmission quality and are not supported.
Information About Cisco Unified Border Element Features
Gateway feature benefits include the following:
•
Codec filtering by restricting codecs advertised on outbound call legs. For example, restriction of high-bandwidth codecs is possible on the reorigination side of the Cisco Unified Border Element outbound dial peer.
•
Support for changing codecs during rotary dial peer selection.
•
Network privacy by hiding the internal network structure from other administrative domains.
•
Ability to create interconnections between different VoIP network types (such as SIP-to-H.323, H.323-to-SIP, and SIP-to-SIP protocol interworking).
•
Better voice quality, cost and space savings (including rack density), and feature set compared with back-to-back gateways.
•
Support for TDM voice.
•
Support for Cisco ATA188 and third-party endpoints.
•
More control of calls routed between ITSPs.
How to Configure Fundamental Cisco Unified Border Element
This section contains the following tasks:
•
Configuring an Ethernet Interface
•
Configuring a RTP Loopback Interface
•
Configuring Codec Transparency on a Cisco Unified Border Element
•
Configuring the GSMAMR-NB Codec on a Cisco Unified Border Element
•
Configuring iLBC Codec on a Cisco Unified Border Element
•
Configuring QoS for a Cisco Unified Border Element
•
Configuring Cisco Unified Border Element for High Utilization
•
Configuring Cisco Unified Border Element with OSP
•
Media Statistics on a Cisco Unified Border Element
•
Voice Quality Enhancements on Cisco Unified Border Element
•
Troubleshooting and Verifying Fundamental Cisco Unified Border Element Configuration and Operation
Configuring an Ethernet Interface
You can configure the Cisco Unified Border Element feature to operate with either a single Ethernet interface for all incoming, outgoing, and via-zone gatekeeper traffic or two Ethernet interfaces for signaling and media streams (optional but highly recommended for single-interface configurations). To configure an Ethernet interface, perform the steps in this section.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
interface type slot/port
4.
ip route-cache same-interface
5.
exit
DETAILED STEPSExamples
The following example shows a configuration that uses a single Ethernet interface for all traffic:
interface FastEthernet0/1ip address 10.16.8.6 255.255.0.0no ip redirectsip route-cache same-interfacespeed autofull-duplexh323-gateway voip interfaceh323-gateway voip id 7206-vgk1 ipaddr 10.16.8.71 1719h323-gateway voip h323-id 3660-hud1h323-gateway voip tech-prefix 1#h323_gateway voip bind srcaddr 10.16.8.6Configuring a RTP Loopback Interface
The Cisco Unified Border Element supports configuration of an RTP loopback dial peer for use in verifying and troubleshooting H.323 networks. When a call encounters an RTP loopback dial peer, the gateway automatically signals call connect and loops all voice data back to the source. In contrast to normal calls through the VoIP-to-VoIP gateway, RTP loopback calls consist of only one call leg.
To configure a RTP loopback interface, perform the steps in this section.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice number voip
4.
incoming called-number string
5.
destination-pattern string
6.
codec codec
7.
session target loopback:rtp
8.
exit
DETAILED STEPSExamples
Using a Single Dial Peer on a Cisco Unified Border Element
Router(config)# dial-peer voice 5550199 voipRouter(config-dial-peer)# incoming called-number 5550199Router(config-dial-peer)# destination-pattern 5550199Router(config-dial-peer)# codec g711ulawRouter(config-dial-peer)# session target loopback:rtpUsing Separate Dial Peers on a Cisco Unified Border Element
dial-peer voice 5550188 voipincoming called-number 5550188session target rascodec g711ulaw!dial-peer voice 5550182 voipdestination-pattern 5550188session target loopback:rtpUsing a Codec Preference List to Support Additional Codecs
voice class codec 1
codec preference 1 g711ulawcodec preference 2 g729r8dial-peer voice 5429999 voipincoming called-number 5550199destination-pattern 5550199voice-class codec 1session target loopback:rtpConfiguring Codec Transparency on a Cisco Unified Border Element
Codec transparency enables the Cisco Unified Border Element to pass codec capabilities between endpoints. If you configure transparency, the Cisco Unified Border Element uses the codec that was specified by the endpoints for setting up a call.
To configure codec transparency on an Cisco Unified Border Element, perform the steps in this section. This section contains the following subsections:
•
Configuring Codec Transparency for All Dial Peers in a Voice Class
•
Configuring Codec Transparency for an Individual Dial Peer
Restrictions
•
Codec transparency is only supported for H.323-to-H.323 calls.
•
Codec filtering must be based on codec types; filtering based on byte size is not supported.
•
Codec transparency is not supported when call start interwork is configured.
•
For video calls, you must configure codec transparency in both incoming and outgoing dial peers. Codec filtering may not be possible for video calls.
Configuring Codec Transparency for All Dial Peers in a Voice Class
To configure codec transparency for all dial peers in a voice class, perform the steps in this section.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
voice class codec tag
4.
codec preference value codec-type
5.
exit
6.
dial-peer voice number voip
7.
voice class codec tag
8.
exit
DETAILED STEPSConfiguring Codec Transparency for an Individual Dial Peer
To configure codec transparency for an individual dial peer, perform the steps in this section.
Restrictions
If you plan to configure both incoming and outgoing dial peers, you must specify the transparent codec on the incoming dial peer.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice number voip
4.
codec codec-type
5.
exit
DETAILED STEPSExamples
The following example shows an inbound and outbound dial peer on the same tag in which the inbound dial peer is configured with the transparent codec, and the outbound dial peer is configured with the filter codec:
dial-peer voice 1 voipincoming called-number .Tdestination-pattern .Tsession target rascodec transparentThe following example shows separate tags for the inbound and outbound dial peers:
dial-peer voice 1 voipdestination-pattern .Tsession target rascodec transparentdial-peer voice 2 voipincoming called-number .Tcodec transparentdestination-pattern .Tsession target rasThe following example shows filtering of high-bandwidth codecs applied to dial peer 1. With this configuration, codecs other than those specified are disallowed.
voice class codec 1codec preference 1 g729br8codec preference 2 g723r53codec preference 3 g723r68dial-peer voice 1 voipvoice-class codec 1The following shows a different filtering configuration. With this configuration, codecs other than g729r8 are disallowed.
dial-peer voice 1 voipdestination-pattern .Tsession target rasConfiguring the GSMAMR-NB Codec on a Cisco Unified Border Element
The Adaptive Multirate Narrow Band (AMR-NB) codec is a high complexity multimode codec that supports eight narrowband speech encoding modes with bit rates between 4.75 and 12.2 kbps. The sampling frequency used in AMR-NB is 8000 Hz and the speech encoding is performed on 20 ms speech frames. Therefore, each encoded AMR-NB speech frame represents 160 samples of the original speech.
The AMR-NB codec was originally developed and standardized by the European Telecommunications Standards Institute (ETSI) for Groupe Speciale Mobile (GSM) cellular systems. and chosen by the Third Generation Partnership Project (3GPP) as the mandatory codec for third generation (3G) cellular systems.
Table 1 Contains codec mode and bit rate information for the AMR-NB codec.
Table 1 AMR Codec Modes and Bit Rates
Codec Mode Bit Rate (kbps)0
4.75
1
5.15
2
5.90
3
6.70
4
7.40
5
7.95
6
10.2
7
12.2
81
1.80
1 Used for Silence Indication Detection (SID) frames.
To configure GSMAMR-NB Codec on an Cisco Unified Border Element from a live feed, perform the steps in this section.
Prerequisites
•
You must install an IP Plus image (minimum) of Cisco IOS Release 12.4(9)T or a later release.
Restrictions
The following restrictions apply when configuring H323-to-SIP, and SIP-to-SIP Cisco Unified Border Element connections:
•
Codec filtering is supported only based on codec type.
•
Transcoding and conferencing are not supported
•
Codec transparent is not supported
•
Codec parameters such as pkt period, encap, frame format and modes should be explicitly configured.
The following restrictions apply when configuring H.323-to-H.323 Cisco Unified Border Element connections:
•
Codec filtering is supported only based on codec type.
•
Transcoding and conferencing are not supported
•
Codec transparent is supported
•
Configuring codec parameters such as pkt period, encap, frame format and modes is not needed. If configured, they will be ignored as the negotiation of the parameters is left to the endpoints.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice tag {pots | mmoip | voip}
4.
codec gsmamr-nb [packetization-period 20][encap rfc3267][frame-format {bandwidth-efficient | octet-aligned [crc | no-crc]}] [modes modes-value]
5.
exit
6.
end
DETAILED STEPSConfiguring iLBC Codec on a Cisco Unified Border Element
The internet Low Bitrate Codec (iLBC) is a standard, high-complexity speech codec that is suitable for robust voice communication over IP. iLBC has built-in error correction functionality that helps the codec perform in networks with a high-packet loss.
Note
H.323-to-SIP calls, the iLBC codec configuration must be the same across all the call legs in the call. i.e. originating gateway, Cisco Unified Border Element(s) and terminating gateway.
Additional information and configuration of the iLBC code on an Cisco Unified Border Element can be found at the following links:
•
Codecs section of the Dial Peer Configuration on Voice Gateway Routers Guide
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/vvfax_c/int_c/dpeer_c
/dp_ovrvw.htm#1035124•
Dial Peer Features and Configuration section of the Dial Peer Configuration on Voice Gateway Routers Guide
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/vvfax_c/int_c/dpeer_c
/dp_confg.htmConfiguring QoS for a Cisco Unified Border Element
To assign QoS differentiated services code points (DSCP) for H.323 calls through the Cisco Unified Border Element, perform the steps in this section.
Note
With the exception of RSVP, all VoIP QoS options supported by TDM-to-IP gateways are supported by Cisco Unified Border Elements. See the following documents for details and configuration instructions:
•
The "Configuring Quality of Service for Voice" chapter in Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2
•
Quality of Service for Voice over IP
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice number voip
4.
ip qos dscp ef media
5.
ip qos dscp af31 signaling
6.
exit
DETAILED STEPSConfiguring Cisco Unified Border Element for High Utilization
For high-utilization configurations, the Cisco Unified Border Element may require a higher percentage of memory than that which is made available by default during bootup. Additionally, high-utilization configurations may experience an increase in dropped packets.
To configure Cisco Unified Border Element for high utilization, perform the steps in this section. This section contains the following subsections:
•
Increase I/O Memory for High Utilization
•
Manage Ethernet Hold Queue for High Utilization
Increase I/O Memory for High Utilization
To increase the amount of memory available to the Cisco Unified Border Element, perform the steps in this section.
Prerequisites
Determine if sufficient I/O memory is available by using the show memory command:
Note
If peak utilization is consistently more than 80 percent of the total I/O memory allocated, use the memory-size iomem command to set the I/O memory percentage to use less than 80 percent of the allocation.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
show version
4.
memory-size iomem
DETAILED STEPSManage Ethernet Hold Queue for High Utilization
Some traffic patterns and network environments may produce bursts of packets on the Ethernet interfaces used for Cisco Unified Border Element signaling and media. In some cases, these bursts can result in dropped packets when the Ethernet input queue overflows. Similarly, momentary congestion on the local network could inhibit the Cisco Unified Border Element feature, also resulting in dropped packets when the Ethernet output queue overflows.
Because H.323 uses UDP for media transport and RAS signaling, dropped packets have a negative impact on call signaling integrity and voice quality. Packet drops due to momentary, occasional Ethernet queue overflows in bursty networks can be reduced or eliminated by increasing the Ethernet hold queue sizes.
CautionA consistently overloaded Ethernet hold queue may increase latency. You may be required to upgrade the Cisco Unified Border Element feature to a higher-performance platform or distribute traffic to an additional gateway.
To increase the Ethernet input hold queue, perform the steps in this section.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
interface type slot/port
4.
hold-queue length in
5.
hold-queue length out
6.
exit
DETAILED STEPSExamples
In general, set the queue size to the smallest value that resolves the packet drops. Monitor the network using the show interfaces ethernet command to confirm that the queue occupancy and drops are both close to zero. For example:
Router(config)# interface f0/1Router(config)# hold-queue 1024 inRouter(config)# hold-queue 1024 outRouter# show interface f0/1 | include queueInput queue: 17/1024/0/0 (size/max/drops/flushes); Total output drops: 0Output queue :0/1024 (size/max)Router# show interface f0/1FastEthernet0/1 is up, line protocol is upHardware is AmdFE, address is 0002.b950.5181 (bia 0002.b950.5181)Description: archived via cfg file p8.cfg on Wed May 1 09:46:33 EDT 2002Internet address is 10.3.2.63/16MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,reliability 255/255, txload 104/255, rxload 97/255Encapsulation ARPA, loopback not setKeepalive set (10 sec)Full-duplex, 100Mb/s, 100BaseTX/FXARP type: ARPA, ARP Timeout 04:00:00Last input 00:00:00, output 00:00:00, output hang neverLast clearing of "show interface" counters neverInput queue: 7/1024/0/0 (size/max/drops/flushes); Total output drops: 0Queueing strategy: fifoOutput queue :0/1024 (size/max)5 minute input rate 38335000 bits/sec, 24068 packets/sec5 minute output rate 40897000 bits/sec, 24019 packets/sec112943349 packets input, 1022884421 bytesReceived 405 broadcasts, 0 runts, 0 giants, 0 throttles0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored0 watchdog0 input packets with dribble condition detected113081187 packets output, 2612108380 bytes, 0 underruns0 output errors, 0 collisions, 2 interface resets0 babbles, 0 late collision, 0 deferred0 lost carrier, 0 no carrier0 output buffer failures, 0 output buffers swapped outRouter# show running-config interface f0/1Building configuration...Current configuration : 420 bytes!interface FastEthernet0/1ip address 10.3.2.63 255.255.0.0no ip redirectsip route-cache same-interfacespeed autofull-duplexh323-gateway voip interfaceh323-gateway voip id 3640-vgk2 ipaddr 10.3.2.72 1719 priority 1h323-gateway voip h323-id 3660-hud3h323-gateway voip tech-prefix 1#h323-gateway voip bind srcaddr 10.3.2.63hold-queue 1024 inhold-queue 1024 outConfiguring Cisco Unified Border Element with OSP
The Cisco Unified Border Element with Open Settlement Protocol (OSP) feature enables VoIP service providers to gain the benefits of the Cisco Unified Border Element and to make use of routing, billing, and settlement capabilities offered by OSP-based clearinghouses.
Open Settlement Protocol is a client-server protocol used to establish authenticated connections between gateways. OSP provides for the secure transfer of accounting and routing information between Cisco Unified Border Elements.
Figure 1 shows a sample topology that uses the Cisco Unified Border Element feature with OSP. With the exception of the authentication and accounting messages that are exchanged between the Cisco Unified Border Element and the OSP server, the exchange of messages between the gateways and gatekeepers is similar to the process illustrated in Figure 4.
Figure 1 Cisco Unified Border Element with OSP Configuration Topology
Note
For details on configuring and using OSP applications, see the "Configuring Settlement Applications" chapter of the Cisco IOS Voice, Video and Fax Configuration Guide, Release 12.2.
To configure the Cisco Unified Border Element with OSP, perform the steps in this section.
Prerequisites
•
Obtain the required feature license for each platform on which you will configure the Cisco Unified Border Element with OSP feature.
•
Install a Cisco IOS image that supports the Cisco Unified Border Element and encryption. See Figure 3 for a list of Cisco IOS image requirements.
•
Configure OSP on the Cisco Unified Border Element. For detailed instructions on configuring OSP, see the Configuring Settlement Applications chapter of the Cisco IOS Voice, Video and Fax Configuration Guide, Release 12.2.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice number voip
4.
application application-name
5.
exit
DETAILED STEPSExamples
Figure 2 shows two ITSPs using Cisco Unified Border Element and OSP to connect calls passing between the two networks. The examples that follow are based on this illustration.
Figure 2 Cisco Unified Border Element with OSP Feature Topology
Sample Configuration for the Cisco Unified Border Element with OSP Feature
The following example shows the dial peer configuration necessary to complete calls using the configuration shown in Figure 3:
Cisco Unified Border Element-919 Dial Peers
The following dial peer is used for incoming calls from GW919:
dial-peer voice 11 voipapplication sessionincoming called-number 408....session target rascodec transparent!The following dial peer is used for outgoing calls to Cisco Unified Border Element-408:
dial-peer voice 12 voipdestination-pattern 408....session target settlementcodec transparent!The following dial peer is used for incoming calls from Cisco Unified Border Element-408:
dial-peer voice 13 voipapplication sessionincoming called-number 919....session target settlementcodec transparent!The following dial peer is used for outgoing calls to GW919:
dial-peer voice 14 voipdestination-pattern 919....session target rascodec transparent!Cisco Unified Border Element-408 Dial Peers
The following dial peer is used for incoming calls from Cisco Unified Border Element-919:
dial-peer voice 21 voipapplication sessionincoming called-number 408....session target settlementcodec transparent!The following dial peer is used for outgoing calls to GW408:
dial-peer voice 22 voipdestination-pattern 408....session target rascodec transparent!The following dial peer is used for outgoing calls to Cisco Unified Border Element-919:
dial-peer voice 23 voipdestination-pattern 919....session target settlementcodec transparent!The following dial peer is used for incoming calls from GW408:
dial-peer voice 24 voipapplication sessionincoming called-number 919....session target rascodec transparent!Media Statistics on a Cisco Unified Border Element
This chapter describes the media statistics feature. The media statistics command allows you to estimate the values of the packet loss, jitter, and the Round Trip Time (RTT) statistics based on RFC-3550.
To enable media statistics on an Cisco Unified Border Element, perform the steps in this section. This section contains the following subsections:
•
Information About Media Statistics in an Cisco Unified Border Element
•
Configuring Media Statistics in a Cisco Unified Border Element
•
Verifying Fundamental Cisco Unified Border Element Configurations
Restrictions
•
Integrated TDM-IP and Cisco Unified Border Element is not supported.
•
Estimating media statistics feature on Cisco Unified Border Element is available if the media statistics command is configured. The feature is disabled by default.
•
Cisco Unified Border Element does not initiate RTCP it only passes the received RTCP packet from incoming leg to Outgoing leg.
•
Voice quality may be impacted by per-packet touching of an RTP stream for generating the required voice statistics.
Information About Media Statistics in an Cisco Unified Border Element
The Voip RTP library estimates the values based on RTCP packets received on the Cisco Unified Border Element. This feature adds the capability to generate the media statistics in Cisco Unified Border Element and estimate the values of packet loss, jitter, and Round Trip Time (RTT)
Packet Loss
Packet loss is estimated on Cisco Unified Border Element based on RFC 3550. Packet loss calculation is done based on RTP stream and the computation is done in VOIPRTP library by checking the sequence Number.
•
The Packet loss value computed is filled in variable cvVoIPCallActiveLostPackets in the CISCO-VOICE-DIAL-CONTROL-MIB
•
Packet loss value will be estimated even if the End-End RTCP is not present for the call.
Jitter
Packet jitter is defined as an estimate of the statistical variance of the RTP data packet interarrival time, measured in timestamp units. Jitter is estimated on Cisco Unified Border Elements based on RFC 3550. Jitter is computed in VOIPRTP library.
•
The Jitter value computed is filled in variable cvCallActivePlayDelayJitter in CISCO-VOICE-DIAL-CONTROL-MIB.
Round Trip Time
The Round Trip Time (RTT) value computed is filled in variable cvVoIPCallActiveRoundTripDelay in CISCO-VOICE-DIAL-CONTROL-MIB.
•
Cisco Unified Border Element handles signaling and Media without DSP and establishes calls with protocols H.323, SIP and also does interworking between H.323 and SIP protocols. As the calls are handled DSP less currently the values populated on Cisco Unified Border Element for voice statistics are displayed as zero.
Note
A sub-rtcp message is similar to a rtcp message except the payload type is different. A sub-rtcp message is a cisco proprietary message initiated by the Cisco Unified Border Element.
Configuring Media Statistics in a Cisco Unified Border Element
The media statistics feature can be configured in global, or dial peer configuration mode, perform the steps in this section. This section contains the following subsections:
•
Configuring Media Statistics in Voice-Service Configuration Mode
•
Configuring Media Statistics on Dial Peer Configuration Mode
•
Monitoring Media Statistics in a Cisco Unified Border Element (optional)
•
Verifying Fundamental Cisco Unified Border Element Configurations
Note
•
Before you perform a procedure, familiarize yourself with the following information:
•
For help with a procedure, see the monitoring and verifying sections listed above.
Configuring Media Statistics in Voice-Service Configuration Mode
To globally enable media statistics in voice-service configuration mode to estimate the values for packet loss, jitter, and RTT, perform the steps in this section.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
voice service voip
4.
media statistics
5.
exit
DETAILED STEPSConfiguring Media Statistics on Dial Peer Configuration Mode
To enable media statistics in on a dial peer voice-service configuration mode to estimate the values for packet loss, jitter, and RTT, perform the steps in this section.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
voice service voip
4.
media statistics
5.
exit
DETAILED STEPSMonitoring Media Statistics in a Cisco Unified Border Element
Monitor the media statistics with the show call active voice look for following variables:
•
LostPackets
•
PlayDelayJitter
•
RoundTripDelay
SUMMARY STEPS1.
show call active voice
2.
show call active voice | i LostPackets
3.
show call active voice | i RoundTripDelay
4.
show call active voice | i PlayDelayJitter
5.
show voip rtp connections
6.
show call history voice last 2 | i RoundTripDelay
7.
show call history voice last 2 | i LostPackets
DETAILED STEPS
Step 1
show call active voice
Use this command to display media statistics information and indicate whether the media statistic feature is enabled.
c3745-ipipgw#show call active voiceTelephony call-legs: 0SIP call-legs: 2H323 call-legs: 0Call agent controlled call-legs: 0SCCP call-legs: 0Multicast call-legs: 0Total call-legs: 2GENERIC:SetupTime=525050 msIndex=1PeerAddress=6662PeerSubAddress=PeerId=0PeerIfIndex=54LogicalIfIndex=0ConnectTime=527550 msCallDuration=00:00:04 secCallState=4CallOrigin=2ChargedUnits=0InfoType=speechTransmitPackets=112TransmitBytes=2240ReceivePackets=318ReceiveBytes=6360VOIP:ConnectionId[0xA6008E71 0xA8FE11D6 0x800B000D 0x2970B190]IncomingConnectionId[0xA6008E71 0xA8FE11D6 0x800B000D 0x2970B190]CallID=5RemoteIPAddress=1.3.7.16RemoteUDPPort=19512RemoteSignallingIPAddress=1.3.7.16RemoteSignallingPort=52111RemoteMediaIPAddress=1.3.7.16RemoteMediaPort=19512RoundTripDelay=0 msSelectedQoS=best-efforttx_DtmfRelay=rtp-nteFastConnect=FALSEAnnexE=FALSESeparate H245 Connection=FALSEH245 Tunneling=FALSESessionProtocol=sipv2ProtocolCallId=A601C6C1-A8FE11D6-8029B65F-D48EEF95@1.3.7.16SessionTarget=1.3.7.16OnTimeRvPlayout=0GapFillWithSilence=0 msGapFillWithPrediction=0 msGapFillWithInterpolation=0 msGapFillWithRedundancy=0 msHiWaterPlayoutDelay=0 msLoWaterPlayoutDelay=0 msTxPakNumber=0TxSignalPak=0TxComfortNoisePak=0TxDuration=0TxVoiceDuration=0RxPakNumber=0RxSignalPak=0RxComfortNoisePak=0RxDuration=0RxVoiceDuration=0RxOutOfSeq=0RxLatePak=0RxEarlyPak=0RxBadProtocol=0PlayDelayCurrent=0PlayDelayMin=0PlayDelayMax=0PlayDelayClockOffset=0PlayDelayJitter=0PlayErrPredictive=0PlayErrInterpolative=0PlayErrSilence=0PlayErrBufferOverFlow=0PlayErrRetroactive=0PlayErrTalkspurt=0OutSignalLevel=0InSignalLevel=0LevelTxPowerMean=0LevelRxPowerMean=0LevelBgNoise=0ERLLevel=0ACOMLevel=0ErrRxDrop=0ErrTxDrop=0ErrTxControl=0ErrRxControl=0ReceiveDelay=0 msLostPackets=0EarlyPackets=0LatePackets=0SRTP = offTextRelay = offVAD = disabledCoderTypeRate=g729r8CodecBytes=20Media Setting=flow-throughCallerName=CallerIDBlocked=FalseOriginalCallingNumber=6662OriginalCallingOctet=0x0OriginalCalledNumber=6661OriginalCalledOctet=0x0OriginalRedirectCalledNumber=OriginalRedirectCalledOctet=0x80TranslatedCallingNumber=6662TranslatedCallingOctet=0x0TranslatedCalledNumber=6661TranslatedCalledOctet=0x0TranslatedRedirectCalledNumber=TranslatedRedirectCalledOctet=0x80GwReceivedCalledNumber=6661GwReceivedCalledOctet3=0x0GwReceivedCallingNumber=6662GwReceivedCallingOctet3=0x0GwReceivedCallingOctet3a=0x80MediaInactiveDetected=noMediaInactiveTimestamp=MediaControlReceived=LongDurationCallDetected=noLongDurCallTimestamp=LongDurcallDuration=Username=6662GENERIC:SetupTime=525050 msIndex=2PeerAddress=6661PeerSubAddress=PeerId=6661PeerIfIndex=54LogicalIfIndex=0ConnectTime=527550 msCallDuration=00:00:06 secCallState=4CallOrigin=1ChargedUnits=0InfoType=speechTransmitPackets=432TransmitBytes=8640ReceivePackets=112ReceiveBytes=2240VOIP:ConnectionId[0xA6008E71 0xA8FE11D6 0x800B000D 0x2970B190]IncomingConnectionId[0xA6008E71 0xA8FE11D6 0x800B000D 0x2970B190]CallID=6RemoteIPAddress=1.3.7.112RemoteUDPPort=18958RemoteSignallingIPAddress=1.3.7.112RemoteSignallingPort=5060RemoteMediaIPAddress=1.3.7.112RemoteMediaPort=18958RoundTripDelay=0 msSelectedQoS=best-efforttx_DtmfRelay=rtp-nteFastConnect=FALSEAnnexE=FALSESeparate H245 Connection=FALSEH245 Tunneling=FALSESessionProtocol=sipv2ProtocolCallId=D0445D00-62B611D6-800DB698-E7A6FDDD@1.3.7.9SessionTarget=1.3.7.112OnTimeRvPlayout=0GapFillWithSilence=0 msGapFillWithPrediction=0 msGapFillWithInterpolation=0 msGapFillWithRedundancy=0 msHiWaterPlayoutDelay=0 msLoWaterPlayoutDelay=0 msTxPakNumber=0TxSignalPak=0TxComfortNoisePak=0TxDuration=0TxVoiceDuration=0RxPakNumber=0RxSignalPak=0RxComfortNoisePak=0RxDuration=0RxVoiceDuration=0RxOutOfSeq=0RxLatePak=0RxEarlyPak=0RxBadProtocol=0PlayDelayCurrent=0PlayDelayMin=0PlayDelayMax=0PlayDelayClockOffset=0PlayDelayJitter=0PlayErrPredictive=0PlayErrInterpolative=0PlayErrSilence=0PlayErrBufferOverFlow=0PlayErrRetroactive=0PlayErrTalkspurt=0OutSignalLevel=0InSignalLevel=0LevelTxPowerMean=0LevelRxPowerMean=0LevelBgNoise=0ERLLevel=0ACOMLevel=0ErrRxDrop=0ErrTxDrop=0ErrTxControl=0ErrRxControl=0ReceiveDelay=0 msLostPackets=0EarlyPackets=0LatePackets=0SRTP = offTextRelay = offVAD = disabledCoderTypeRate=g729r8CodecBytes=20Media Setting=flow-throughCallerName=CallerIDBlocked=FalseOriginalCallingNumber=6662OriginalCallingOctet=0x0OriginalCalledNumber=6661OriginalCalledOctet=0x0OriginalRedirectCalledNumber=OriginalRedirectCalledOctet=0x80TranslatedCallingNumber=6662TranslatedCallingOctet=0x0TranslatedCalledNumber=6661TranslatedCalledOctet=0x0TranslatedRedirectCalledNumber=TranslatedRedirectCalledOctet=0x80GwReceivedCalledNumber=6661GwReceivedCalledOctet3=0x0GwOutpulsedCalledNumber=6661GwOutpulsedCalledOctet3=0x0GwReceivedCallingNumber=6662GwReceivedCallingOctet3=0x0GwReceivedCallingOctet3a=0x80GwOutpulsedCallingNumber=6662GwOutpulsedCallingOctet3=0x0GwOutpulsedCallingOctet3a=0x80MediaInactiveDetected=noMediaInactiveTimestamp=MediaControlReceived=LongDurationCallDetected=noLongDurCallTimestamp=LongDurcallDuration=Username=6662Telephony call-legs: 0SIP call-legs: 2H323 call-legs: 0Call agent controlled call-legs: 0SCCP call-legs: 0Multicast call-legs: 0Total call-legs: 2Step 2
Router# show call active voice | i LostPackets
LostPackets=0LostPackets=126Step 3
Router# show call active voice | i RoundTripDelay
RoundTripDelay=0 msRoundTripDelay=4 msStep 4
Router# show call active voice | i PlayDelayJitter
PlayDelayJitter=0PlayDelayJitter=24Step 5
Router# show voip rtp connections
VoIP RTP active connections :No. CallId dstCallId LocalRTP RmtRTP LocalIP RemoteIP1 5 6 17892 17794 15.5.34.5 15.5.34.1582 6 5 16990 18744 15.5.34.5 15.5.34.6Found 2 active RTP connectionsVoice Quality Enhancements on Cisco Unified Border Element
To configure voice quality enhancements on the Cisco UBE, perform the steps in this section. This section contains the following subsections:
•
Configuring Codec Repacketization
•
Configuring IP-to-IP Call Gain/Loss Control
•
Configuring Voice Quality Metrics
Codec Repacketization
Codec repacketization is used to connect dissimilar networks that have different packetization time periods. A portion of a network might be set to generate packets on the Real-Time Transport Protocol (RTP) voice stream every 10 ms, while another portion may have a packetization period of 20 ms. When one side can adjust to the other's packetization, the call is completed successfully. However, if both sides cannot agree on a common packetization, the call may fail. The codec repacketization enhancement prevents this call failure scenario.
By enabling the Cisco UBE gateway to do codec repacketization, one side of the call can be one packetization period, while allowing the other side can be another. Behavior is predictable, and you can always connect different portions of the voice network.
Note
Be aware that in most cases, the packet sizes can be negotiated to a size both ends of a network can support. Use of the codec repacketization feature should be limited to extreme cases, and should always be used with caution. The maximum payload-size value for G.729r8 and G.723 codecs is 60 bytes.
Because repacketization uses digital signal processor (DSP) transcoding, there is a potential performance impact on DSP and Cisco IOS software. Therefore, codec repacketization should be used only when necessary. To explain the circumstances of when repacketization is and is not necessary, the following scenarios are provided (using G.711 codec as the example):
•
Scenario 1—Endpoint-1 (G.711, byte 160, fixed-byte) connects to Endpoint-2 (G.711, byte 240, fixed-byte)
In this case, repacketization will occur because there are codec byte mismatches between endpoints and both endpoints are configured with the fixed-bytes option of the codec command.
•
Scenario 2—Endpoint-1 (G.711, byte 160) connects to Endpoint-2 (G.711, byte 240)
In this case, repacketization does not occur because neither endpoint is configured with the fixed-bytes option of the codec command. The current CLI codec byte negotiation is used.
•
Scenario 3—Endpoint-1 (G.711, byte 160, fixed-byte) connects to Endpoint-2 (G.711, byte 160, fixed-byte)
In this case, the fixed-bytes option of the codec command is configured at both endpoints, but Cisco IOS software detects that repacketization is not needed. No repacketization is performed.
•
Scenario 4—Endpoint-1 (G.711, byte 160, fixed-byte) connects to Endpoint-2 (G.711, byte 240)
Endpoint 1 uses fixed codec byte size 160 and Endpoint 2 likes to use codec byte size 240. In this case, repacketization occurs because of the fixed-bytes option configured on Endpoint-1.
Prerequisites
•
You should be familiar with the configuration information in the Universal Voice Transcoding Support for IP-to-IP Gateways document.
Restrictions
•
The codec repacketization feature described in this document applies to SIP-to-SIP voice network connections.
•
For the codec repacketization feature, the G.729r8 and G.723 codecs do not support a voice payload-size greater than 60 bytes.
•
The IP-IP Call Gain/Loss Control and Voice Quality Measurements features apply to Cisco UBE voice connections. That is, the H.323 protocol can also be used.
•
Secure Real-Time Transport Protocol (SRTP) is not supported in this feature.
Configuring Codec Repacketization
To configure codec repacketization on a voice gateway, you must configure codec byte size with different values for the incoming and outgoing Voice over IP (VoIP) dial peers.
•
Configuring Codec Repacketization the Incoming VoIP Dial Peer
•
Configuring Codec Repacketization the Outgoing VoIP Dial Peer
•
Verifying Codec Repacketization
Configuring Codec Repacketization the Incoming VoIP Dial Peer
To configure the incoming VoIP dial peer, complete the following task:
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice voip
4.
incoming called-number number
5.
codec codec-type bytes payload-size fixed-bytes
DETAILED STEPS
Command or Action PurposeStep 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
dial-peer voice voip
Example:Router(config)# dial-peer voice voip
Enters dial-peer configuration mode, and specifies VoIP as the method of voice encapsulation.
Step 4
incoming called-number number
Example:Router(config-dialpeer)# incoming called-number 12345
Specifies a digit string that can be matched by an incoming call to associate the call with the dial peer.
•
number—Series of digits that specify a pattern for the E.164 or private dialing plan telephone number. Valid entries are the digits 0 through 9, the letters A through D, and some special characters. (See the incoming called-number (dial-peer) command in the Cisco IOS Voice Command Reference for more information.)
Step 5
codec codec-type bytes payload-size fixed-bytes
Example:Router(config-dialpeer)# codec g711ulaw bytes 160 fixed-bytes
Specifies the voice coder rate of speech for a dial peer, the number of bytes in the voice payload of each frame, and indicates that the codec byte size is fixed and non-negotiable.
Configuring Codec Repacketization the Outgoing VoIP Dial Peer
To configure the outgoing VoIP dial peer, complete the following task:
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice tag voip
4.
destination-pattern number
5.
session target destination-address
6.
codec codec-type
DETAILED STEPS
Command or Action PurposeStep 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
dial-peer voice tag voip
Example:Router(config)# dial-peer voice 123 voip
Enters dial-peer configuration mode, defines a particular dial peer, and specifies the method of voice encapsulation as VoIP.
•
tag—Digits that define a particular dial peer. Range is from 1 to 2147483647.
Step 4
destination-pattern string
Example:Router(config)# destination-pattern 12345
Specifies either the prefix or the full E.164 telephone number to be used for a dial peer.
•
string—Series of digits that specify a pattern for the E.164 or private dialing plan telephone number. Valid entries are the digits 0 through 9, the letters A through D, and some special characters. (See the destination-pattern command in the Cisco IOS Voice Command Reference for more information.)
Step 5
session target ipv4:destination-address
Example:Router(config-dialpeer)# session target ipv4:10.1.1.1
Designates a network-specific address to receive calls from a VoIP dial peer.
•
ipv4:destination-address—IP address of the dial peer to receive calls.
Step 6
codec codec-type
Example:Router(config-dialpeer)# codec g711ulaw
Specifies the voice coder rate of speech for a dial peer.
Table 2 shows some commonly used mappings from codec bytes to codec ms packets.
Table 2 Packet Bytes and Packet Time Conversion for Codecs Supported in Repacketization (Transrating) Function
Codec Packet Bytes for 10 ms Packet Packet Bytes for 20 ms Packet Packet Bytes for 30 ms Packet Codec Bit Rate (bps), Packet Time in ms (PT), and Packet Byte Conversion Formulag711ulaw, g711alaw
80 bytes
160 bytes
240 bytes
64,000 bps; PB = PT x 8
g729abr8, g729ar8, g729br8, g729r81
10 bytes
20 bytes
30 bytes
8,000 bps; PB = PT
g722-64
80 bytes
160 bytes
240 bytes
64,000 bps; PB = PT x 8
g723r632
-
-
24 bytes
6,300 bps; PB = PT/30 x 24
Note: For PT = 60 ms, PB = 48 bytesg723r533
-
-
20 bytes
5,300 bps; PB = PT/30 x 20
Note: For PT = 60 ms, PB = 40 bytes
1 The supported packetization period for G.729r8 is limited to a maximum of 60 ms or payload size of 60 bytes.
2 The supported packetization period for G.723r63 is limited to a maximum of 60 ms or payload size of 48 bytes.
3 The supported packetization period for G.723r53 is limited to a maximum of 60 ms or payload size of 40 bytes.
Verifying Codec Repacketization
To verify that codec repacketization is turned on and working properly, use the following show commands:
Step 1
Use the show voip rtp connections command to display the active RTP connections. The following sample output shows four active RTP connections:
Router# show voip rtp connectionsVoIP RTP active connections :No. CallId dstCallId LocalRTP RmtRTP LocalIP RemoteIP1 37 38 16582 18236 10.1.1.2 10.1.1.72 38 37 16524 19542 10.1.1.2 10.1.1.13 39 40 17644 2000 10.1.1.2 10.1.1.24 41 40 16622 2000 10.1.1.2 10.1.1.2Step 2
Use the show sccp connections command to display information about the connections controlled by the Skinny Client Control Protocol (SCCP) transcoding and conferencing applications:
Router# show sccp connectionssess_id conn_id stype mode codec ripaddr rport sport3 4 xcode sendrecv g711u 100.1.1.2 2000 166223 3 xcode sendrecv g711u 100.1.1.2 2000 17644Total number of active session(s) 1, and connection(s) 2
Configuring IP-to-IP Call Gain/Loss Control
This feature enables the adjustment of the audio volume within a Cisco UBE call. As with codec repacketization, dissimilar networks that have different built-in loss/gain characteristics may experience connectivity problems. By adding the ability to control the loss/gain within the Cisco UBE, you can more easily connect your networks.
CautionFor gain/loss control, be aware that adding gain in a network with echo can generate feedback loud enough to cause hearing damage. Always exercise extreme caution when configuring gain into your network.
To configure IP-IP Call Gain/Loss Control on a voice gateway, you must configure the incoming and outgoing VoIP dial peers, perform the steps in this section. This section contains the following subsections:
•
Configuring IP-to-IP Call Gain/Loss Control on the Incoming VoIP Dial Peer
•
Configuring IP-to-IP Call Gain/Loss Control on the Outgoing VoIP Dial Peer
•
Verifying IP-IP Call Gain/Loss
Configuring IP-to-IP Call Gain/Loss Control on the Incoming VoIP Dial Peer
To configure the incoming VoIP dial peer, complete the following task:
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice tag voip
4.
codec-type
5.
incoming called-number number
6.
audio incoming level-adjustment value
7.
audio outgoing level-adjustment value
DETAILED STEPS
Command or Action PurposeStep 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
dial-peer voice tag voip
Example:Router(config)# dial-peer voice 123 voip
Enters dial-peer configuration mode, defines a particular dial peer, and specifies the method of voice encapsulation as VoIP.
•
tag—Digits that define a particular dial peer. Range is from 1 to 2147483647.
Step 4
incoming called-number number
Example:Router(config-dialpeer)# incoming called-number 12345
Specifies a digit string that can be matched by an incoming call to associate the call with the dial peer.
•
number—Series of digits that specify a pattern for the E.164 or private dialing plan telephone number. Valid entries are the digits 0 through 9, the letters A through D, and some special characters. (See the incoming called-number (dial-peer) command in the Cisco IOS Voice Command Reference for more information.)
Step 5
codec codec-type
Example:Router(config-dialpeer)# codec g711ulaw
Specifies the voice coder rate of speech for a dial peer.
•
value—Specifies the voice coder rate for speech.
Step 6
audio incoming level-adjustment value
Example:Router(config-dialpeer)# audio incoming level-adjustment
Enables the incoming IP-IP call gain/loss feature on either the incoming dial peer or the outgoing dial peer.
•
value—Range is -27 to 16.
Step 7
audio outgoing level-adjustment value
Example:Router(config-dialpeer)# audio outgoing level-adjustment
Enables the outgoing IP-IP call gain/loss feature on either the incoming dial peer or the outgoing dial peer.
•
value—Range is -27 to 16.
Configuring IP-to-IP Call Gain/Loss Control on the Outgoing VoIP Dial Peer
To configure the outgoing VoIP dial peer, complete the following task:
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
dial-peer voice tag voip
4.
destination-pattern number
5.
session target destination-address
6.
codec codec-type
7.
audio incoming level-adjustment value
8.
audio outgoing level-adjustment value
DETAILED STEPS
Command or Action PurposeStep 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
dial-peer voice tag voip
Example:Router(config)# dial-peer voice 123 voip
Enters dial-peer configuration mode, defines a particular dial peer, and specifies the method of voice encapsulation as VoIP.
•
tag—Digits that define a particular dial peer. Range is from 1 to 2147483647.
Step 4
destination-pattern string
Example:Router(config-dialpeer)# destination-pattern 12345
Specifies either the prefix or the full E.164 telephone number to be used for a dial peer.
•
string—Series of digits that specify a pattern for the E.164 or private dialing plan telephone number. Valid entries are the digits 0 through 9, the letters A through D, and some special characters. (See the destination-pattern command in the Cisco IOS Voice Command Reference for more information.)
Step 5
session target ipv4:destination-address
Example:Router(config-dialpeer)# session target ipv4:10.1.1.1
Designates a network-specific address to receive calls from a VoIP dial peer.
•
ipv4:destination-address—IP address of the dial peer to receive calls.
Step 6
codec codec-type
Example:Router(config-dialpeer)# codec g711ulaw
Specifies the voice coder rate of speech for a dial peer.
Step 7
audio incoming level-adjustment value
Example:Router(config-dialpeer)# audio incoming level-adjustment 5
Enables the incoming IP-IP call gain/loss feature on either the incoming dial peer or the outgoing dial peer.
•
value—Range is -27 to 16.
Step 8
audio outgoing level-adjustment value
Example:Router(config-dialpeer)# audio outgoing level-adjustment -5
Enables the outgoing IP-IP call gain/loss feature on either the incoming dial peer or the outgoing dial peer.
•
value—Range is -27 to 16.
Note
The DSP requires one level for each stream, so the value for audio incoming level-adjustment and the value for audio outgoing level-adjustment will be added together. If the combined values are outside of the limit the DSP can perform, the value sent to the DSP will be either the minimum (-27) or maximum (+16) supported by the DSP.
Verifying IP-IP Call Gain/Loss
To verify that IP-IP call gain/loss is turned on and working properly, use the following show commands:
Step 1
Use the show call active command to display the gain/loss statistics for active calls on the dial peer:
Router# show call activeStep 2
Use the show call history command to display the gain/loss statistics history on the dial peer:
Router# show call historyConfiguring Voice Quality Metrics
This feature adds voice quality measurements for the Cisco UBE voice call. Prior to this feature, the ability to gather statistics within the gateway required a TDM-to-IP call because the DSP performed statistics gathering. The Voice Quality Metrics feature enables statistics gathering on packet arrival (late/lost/early). From these statistics, a voice quality measurement is developed to give the quality of the call. The output is in a simple format, using a system of good, poor, and bad types of ratings.
The Voice Quality Metrics feature is enabled by the addition of the media monitoring [max-calls] command:
•
Under voice service voip, enter the media monitoring [max-calls] command to define the maximum number of monitoring calls. This creates a monitoring pool with a maximum number of elements.
•
You must also enter the media monitoring command at the dial-peer level to enable monitoring for the calls landing on the dial peer.
Note
Because each monitoring call uses a table of 500 entries to hold RTP packet header information, time stamp, etc. for the background statistics process, about 12150 bytes of extra memory are needed for a call using the Voice Quality Metrics function. The media monitoring command allows you to use different voice quality metrics to experiment with the memory impact on the gateway. When the media monitoring command is not configured, no data structure collects voice quality metrics, so no voice quality monitoring occurs.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
voice service voip
4.
mode border-element
5.
media monitoring [max-calls]
6.
end
7.
dial-peer voice tag voip
8.
media monitoring
DETAILED STEPS
Command or Action PurposeStep 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
voice service voip
Example:Router(config)# voice service voip
Enters voice-service configuration mode and specifies Voice over IP as the voice-encapsulation type.
Step 4
mode border-element
Example:Router(conf-voi-serv)# mode border-element
Enables the audio call-scoring of the media monitoring command. If you do not enter the mode border-element command, the media monitoring command is not available for Cisco UBE voice connections.
Note
The mode border-element command is for configuration on the Cisco 2900 and Cisco 3900 series platforms only. Do not use this command on the Cisco 2800 or Cisco 3800 series platforms.
Step 5
media monitoring [max-calls]
Example:Router(conf-voi-serv)# media monitoring 300
Enables media monitoring and specifies the maximum number of calls to be monitored.
•
max-calls—Range for this value is 1 to 302.
Step 6
end
Example:Router(conf-voi-serv)# end
•
Exits voice service configuration mode and returns to global configuration mode.
Step 7
dial-peer voice tag voip
Example:Router(config)# dial-peer voice 123 voip
Enters dial-peer configuration mode, defines a particular dial peer, and specifies the method of voice encapsulation as VoIP.
•
tag—Digits that define a particular dial peer. Range is from 1 to 2147483647.
Step 8
media monitoring
Example:Router(config-dialpeer)# media monitoring
Enables media monitoring for calls landing on the dial peer specified in Step 7.
Verifying Voice Quality Metrics
To verify that the voice quality metrics feature is turned on and working properly, use the following show commands:
•
show voice monitoring-channels
•
show call active voice
•
show call active voice stats
Step 1
Use the show voice monitoring-channels command to display monitoring statistics:
Router# show voice monitoring-channelsmax vq mon channels = 10 vq mon channels in use = 2 vq mon channels left =8Step 2
Use the show call active voice command to display statistics on the Cisco UBE if the Voice Quality Metrics feature is configured. An abbreviated sample of output follows:
Router# show call active voiceRxPakNumber=5496 RxSignalPak=0 RxComfortNoisePak=0 RxDuration=109900 RxVoiceDuration=109920 RxOutOfSeq=0 RxLatePak=0 RxEarlyPak=0 RxBadProtocol=0 LevelRxPowerMean=0 ErrRxDrop=0 ErrRxControl=0Step 3
Use the show call active voice stats command to display Concealment Statistics and R-Factor Statistics (G.107 MOS) on the Cisco UBE if the Voice Quality Metrics feature is configured. A sample of output follows for a voice call using G.711ulaw, VAD on, and at 5 percent packet loss rate:
Router# show call active voice statsDSP/CS: CR=0.0527, AV=0.0502, MX=0.0527, CT=1220, TT=24270, OK=50, CS=44, SC=0, TS=50, DC=0SP/RF: ML=3.9855, MC=0.0000, R1=79, R2=0, IF=15, ID=0, IE=0, BL=25, R0=94, VR=1.1In the sample output, the following can be noted:
•
The average conceal ratio (AV) is about 5 percent
•
The ratio of total conceal time and total speech time is about 5 percent (1220/24270)
•
BL for codec G.711 is 25 (based on G.113)
•
IE for codec G.711 is 0 (G.113)
•
R0 is 94 (G.107)
Table 3 defines the abbreviations used in the sample output.
SRST Support for G.722 Codec
SRST provides fail-over support for IP phones at remote branch offices that are supported by a central Cisco Unified Communications Manager system with the phones running the SCCP/SIP protocol across WAN links.
Phones are provisioned by Cisco Unified Communications Manager. This information is stored in the phones and then made available to the SRST router when the WAN link fails. SRST extracts the stored information from the phones when they register for service with SRST. SRST uses this information to automatically build the needed configuration.
Prior to Cisco IOS Release 15.0(1)M, G.711 ulaw has been the default narrowband codec for LAN. As the use of wideband codecs expands, G.722 is expected to be the default wideband codec. This increased use of the G.722 codec in LANs has created a need for SRST support with this codec.
This feature provides support for the G.722 codec in SRST mode. To enable G.722-64K codec support as the default codec in SRST mode, enter the codec g722-64k command in call-manager-fallback configuration mode:
Router(config)# call-manager-fallbackRouter(config-cm-fallback)# codec g722-64kThe following shows a sample configuration of call-manager-fallback with the G.722 codec configured:
Router# call-manager-fallback max-conferences 8 gain -6 transfer-system full-consult codec g722-64incoming called-number 52222Troubleshooting and Verifying Fundamental Cisco Unified Border Element Configuration and Operation
To troubleshoot or verify connections in an Cisco Unified Border Element, perform the steps in this section. This section contains the following subsections:
•
Verifying Fundamental Cisco Unified Border Element Configurations
Troubleshooting Tips
CautionUnder moderate traffic loads, these debug commands produce a high volume of output.
•
Use the debug voip ipipgw command to debug the Cisco Unified Border Element feature
•
The Sub-RTCP sender report (SR) and receiver report (RR) packets are feedback packets of RTP Senders and RTP Receivers respectively.
•
The SR includes a 20-byte sender information section for use by active senders.
•
Both the SR and RR forms include zero or more reception report blocks and each reception report block provides statistics about the data received from the particular source.
•
Use the debug voip rtcp sub-rtcp command to debug for LostPackets in the Media Statistics feature.
Router# debug voip rtcp sub-rtcpVOIP RTCP Subrtcp debugging is onOct 16 19:35:26.870: SUBRTCP:tx SR (15.5.34.5-17893)->(15.5.34.158,17795) rtcp-intv(5002 ms)Oct 16 19:35:26.870: SUBRTCP Sender Report dump Length - 32:80 FA 00 07 0F 25 22 05 80 C8 00 05 C8 DE 5D 7E DE C6 2A 6D 00 00 00 00 00 00 00 00 00 00 00 00Oct 16 19:35:26.878: SUBRTCP:tx SR (15.5.34.5-16991)->(15.5.34.6,18745) rtcp-intv(5005 ms)Oct 16 19:35:26.878: SUBRTCP Sender Report dump Length - 32:80 FA 00 07 05 CD 22 05 80 C8 00 05 C8 DE 5D 7E E0 D2 59 C1 00 00 00 00 00 00 00 00 00 00 00 00•
Use the debug voip statistics command to debug the Media Statistics feature in the Cisco Unified Border Element.
Router# debug voip rtp statisticsVOIP RTP Statistics debugging is onOct 16 19:38:20.000: RTP[15.5.34.6-0x1B5B2298]: loss(0) jitter(5 ms, 5992 us)Oct 16 19:38:22.556: RTP[15.5.34.6-0x1B5B2298]: loss(0) jitter(8 ms, 8054 us)For additional examples of show and debug command output and details on interpreting the output, see the following resources:
•
Cisco IOS Debug Command Reference, Release 12.4T
•
Cisco IOS Voice Troubleshooting and Monitoring Guide
•
Troubleshooting and Debugging VoIP Call Basics
•
Voice Gateway Error Decoder for Cisco IOS
Verifying Fundamental Cisco Unified Border Element Configurations
To verify Cisco Unified Border Element feature configuration and operation, perform the following steps (listed alphabetically) as appropriate.
Note
The word "calls" refers to call legs in some commands and output.
SUMMARY STEPS
1.
show call active video
2.
show call active voice
3.
show call history fax
4.
show call history video
5.
show call history voice
6.
show crm
7.
show dial-peer voice
8.
show running-config
9.
show voip rtp connections
DETAILED STEPS
Step 1
show call active video
Use this command to display the active video H.323 call legs.
Step 2
show call active voice
Use this command to display call information for voice calls that are in progress.
Step 3
show call active fax
Use this command to display the fax transmissions that are in progress.
Step 4
show call history video
Use this command to display the history of video H.323 call legs.
Step 5
show call history voice
Use this command to display the history of voice call legs.
Step 6
show call history fax
Use this command to display the call history table for fax transmissions that are in progress.
Step 7
show crm
Use this command to display the carrier ID list or IP circuit utilization.
Step 8
show dial-peer voice
Use this command to display information about voice dial peers.
Step 9
show running-config
Use this command to verify which H.323-to-H.323, H.323-to-SIP, or SIP-to-SIP connection types are supported.
Step 10
show voip rtp connections
Use this command to display active Real-Time Transport Protocol (RTP) connections.
Configuration Examples for Fundamental Cisco Unified Border Element
This chapter includes the following configuration examples:
•
Cisco Unified Border Element: Example
•
Local-to-Remote Network Using the Cisco Unified Border Element: Example
•
Remote-to-Local Network Using the Cisco Unified Border Element: Example
•
Remote-to-Remote Network Using a Cisco Unified Border Element: Example
•
Remote-to-Remote Network Using Two Cisco Unified Border Elements: Example
•
Codec Repacketization: Example
•
Voice Quality Metrics: Example
Cisco Unified Border Element: Example
Figure 3 shows an example configuration of the Cisco Unified Border Element feature.
Figure 3 Cisco Unified Border Element Feature Topology
For a detailed description of the actions that occur during a call, see Figure 1 The following examples show gateway and gatekeeper configuration.
Originating Gateway Configuration: Example
interface Ethernet0/0ip address 10.16.8.132 255.255.255.0half-duplexh323-gateway voip interfaceh323-gateway voip id GK408 ipaddr 10.16.8.123 1718h323-gateway voip h323-id GW408!dial-peer voice 919 voipdestination-pattern 919.......session target ras!gatewayOriginating Gatekeeper Configuration: Example
gatekeeperzone local GK408 usa 10.16.8.123zone remote GKVIA usa 10.16.8.24 1719zone prefix GKVIA 919*gw-type-prefix 1#*no shutdownCisco Unified Border Element Configuration: Example
!voice service voipno allow-connections any to potsno allow-connections pots to anyallow-connections h323 to h323h323ip circuit max-calls 1000ip circuit default only!!interface FastEthernet0/0ip address 10.16.8.145 255.255.255.0ip route-cache same-interfaceduplex autospeed autoh323-gateway voip interfaceh323-gateway voip id GKVIA ipaddr 10.16.8.24 1718h323-gateway voip h323-id IPIPGWh323-gateway voip tech-prefix 1#!!dial-peer voice 919 voipincoming called-number 919.......destination-pattern 919.......session target rascodec transparent!gatewayVia Zone Gatekeeper Configuration: Example
gatekeeperzone local GKVIA usa 10.16.8.24zone remote GK919 usa 10.16.8.146 1719 invia GKVIA outvia GKVIAzone prefix GK919 919*no shutdownTerminating Gateway: Example
interface Ethernet0/0ip address 10.16.8.134 255.255.255.0half-duplexh323-gateway voip interfaceh323-gateway voip id GK919 ipaddr 10.16.8.146 1718h323-gateway voip h323-id GW919h323-gateway voip tech-prefix 919!dial-peer voice 919 potsdestination-pattern 919.......port 1/0:1!gatewayTerminating Gatekeeper Configuration: Example
gatekeeperzone local GK919 usa 10.16.8.146gw-type-prefix 1#* default-technologyno shutdownLocal-to-Remote Network Using the Cisco Unified Border Element: Example
Figure 4 shows a local-to-remote network using the Cisco Unified Border Element feature.
Figure 4 Local-to-Remote Network Using the Cisco Unified Border Element Feature Topology
Note
For a detailed configuration example of a local-to-remote network using the Cisco Unified Border Element, see the following URL: :http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_
example09186a00801b0803.shtml
Remote-to-Local Network Using the Cisco Unified Border Element: Example
Figure 5 shows a remote-to-local network using the Cisco Unified Border Element feature.
Figure 5 Remote-to-Local Network Using the Cisco Unified Border Element Feature Topology
Note
For a detailed configuration example of a remote-to-local network using the Cisco Unified Border Element, see the following URL: http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_example
09186a0080203edc.shtml.
Remote-to-Remote Network Using a Cisco Unified Border Element: Example
Figure 6 shows a remote-to-remote network using an Cisco Unified Border Element.
Figure 6 Remote-to-Remote Network Using a Cisco Unified Border Element Topology
Note
For a detailed configuration example of a remote-to-remote network using the Cisco Unified Border Element, see the following URL: http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_example
09186a0080203edd.shtml.
Remote-to-Remote Network Using Two Cisco Unified Border Elements: Example
Figure 7 shows a remote-to-remote network using two Cisco Unified Border Elements.
Figure 7 Remote-to-Remote Network Using Two Cisco Unified Border Elements Topology
Note
For a detailed configuration example of a remote-to-remote network using two Cisco Unified Border Elements, see the following URL: http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_example
09186a0080203edb.shtml.Using the Cisco Unified Border Element to Assign DSCP Code Points to Gateway Traffic
The following example configures the Cisco Unified Border Element to assign DSCP code points to traffic that passes through the gateway:
dial-peer voice 1 voipincoming called-number .Tdestination-pattern .Tip qos dscp ef mediaip cos dscp af31 signalingsession target rascodec transparentUsing Class and Policy Maps to Control Bandwidth Allocation
The following example uses class and policy maps to control bandwidth allocation based on matching received DSCP code points:
class-map match-all Silver-Datamatch ip dscp af11match ip dscp af12match ip dscp af13class-map match-all Voice-Controlmatch ip dscp af31class-map match-all Gold-Datamatch ip dscp af21match ip dscp af22match ip dscp af23class-map match-all Voicematch ip dscp ef!!policy-map LLQclass Voicepriority percent 40class Voice-Controlbandwidth remaining percent 5class Gold-Databandwidth remaining percent 45class Silver-Databandwidth remaining percent 35class class-defaultbandwidth remaining percent 5random-detect dscp-basedrandom-detect dscp 2 70 128 10random-detect dscp 4 58 128 10random-detect dscp 6 44 128 10policy-map FairQueueclass class-defaultCodec Repacketization: Example
The following is a sample configuration of codec repacketization for a destinated callee number 52222:
dial-peer voice 416 voipdestination-pattern 52222session protocol sipv2session target ipv4:1.7.92.99codec g711ulaw bytes 160 fixed-bytes!dial-peer voice 4161 voipincoming called-number 52222session protocol sipv2codec g711ulaw bytes 80 fixed-bytesVoice Quality Metrics: Example
The following is a sample configuration of the voice quality metrics feature on a gateway that allows a maximum of 100 calls to be monitored, and calls under voip dial-peer 4161 to be monitored:
voice service voipmedia monitor 100allow-connections h323 to h323allow-connections h323 to sipallow-connections sip to h323allow-connections sip to sipdial-peer voice 4161 voipmedia monitoringWhere to Go Next
•
H.323-to-H.323 Connections on a Cisco Unified Border Element
•
H.323-to-SIP Connections on a Cisco Unified Border Element
•
SIP-to-SIP Connections on a Cisco Unified Border Element
•
Configuring Cisco Unified Border Element Videoconferencing
Additional References
The following sections provide additional references related to the Cisco UBE Configuration Guide.
Note
•
In addition to the references listed below, each chapter provides additional references related to Cisco Unified Border Element.
•
Some of the products and services mentioned in this guide may have reached end of life, end of sale, or both. Details are available at http://www.cisco.com/en/US/products/prod_end_of_life.html.
•
The preface and glossary for the entire voice-configuration library suite of documents is listed below.
Related Documents
Standards
Standard TitleH.323 Version 4 and earlier
H.323 (ITU-T VOIP protocols)
H.323 - H.245 Version 12, Annex R
H.323 (ITU-T VOIP protocols)
MIBs
RFCs
Technical Assistance
Feature Information for Cisco Unified Border Element Configuration Guide
Table 4 lists the features in this module and provides links to specific configuration information. Only features that were introduced or modified in Cisco IOS Release 12.3(1) or a later release appear in the table.
For information on a feature in this technology that is not documented here, see the "Cisco Unified Border Element Features Roadmap."
Note
Table 4 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.
Glossary
AMR-NB—Adaptive Multi-rate Narrow Band
DSP—Digital Signal Processor
ETSI—European Telecommunications Standards Institute
GSM—Groupe Speciale Mobile
RTP—Real-Time Transport Protocol
SCCP—Skinny Client Control Protocol
SIP—Session Initiation Protocol
SRTP—Secure Real-Time Transport Protocol
VoIP—Voice over Internet Protocol
TDM—Time Division Multiplexing
3GPP—Third Generation Partnership Project
3G—Third generation
Note
See Internetworking Terms and Acronyms for terms not included in this glossary.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker, iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0910R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2009 Cisco Systems, Inc. All rights reserved.








