Upload
yvette-deal
View
220
Download
1
Embed Size (px)
Citation preview
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-1
Gateway Deployments
Implementing H.323 Gateways
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-2
Overview of H.323 Gateways
H.323 gateways perform these services:• Translation between audio, video, and data formats
• Conversion between call setup signals and procedures
• Conversion between communication control signals and procedures
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-3
H.323 Call Flow
H.323 Gateway
PSTN
Bearer or MediaRTP Stream
Setup
Connect
Signaling
Call Proceeding
Alerting
SignalingRelease Complete
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-4
Why H.323?
Advantages of H.323 gateways:• Dial plan can be configured directly on the gateway.
• Translations can be defined per gateway.
• Regional conditions can be met within multisite deployments.
• Call routing configuration can be more specific than on Cisco CallManager.
• There is no need for extra SRST-related call routing configuration.
• There is no dependency on the Cisco Unified CallManager version.
• More voice interface types are supported.
• ISDN NFAS is supported.
• Fax support is advanced.
• Call preservation was enhanced for PRI calls since Cisco IOS Software Release 12.4(9)T.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-5
Example: Regional Requirements
Calling party: 43917216111Type: international
U.S. Gateway
Germany Gateway
I’ve got an external call. To call back, I need to dial 901143917216111.
I’ve got an external call. To call back, I need to dial 00043917216111.
Calling Mel in the United States.
Translate calling and route to destination.
Mel Max
Calling Max in Germany.
Translate calling and route to destination.
1
2
3
4
5
7
6
Madrid
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-6
h323-gateway voip bind srcaddr ip-address
router(config-if)#
• Sets the IP address that is used as H.323 signaling source
H.323 Commands (Cont.)
Configuring a router interface as a gateway:
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-7
dtmf-relay
router(config-dial-peer)#
• Specifies how DTMF tones are forwarded
rtp payload-type type
router(config-dial-peer)#
• Identifies the payload type of an RTP packet
H.323 Commands (Cont.)
Configuring a DTMF relay:
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-8
voice class codec tag
router(config)#
• Enters voice class codec configuration mode and assigns an identification tag
H.323 Commands (Cont.)
Configuring voice classes
voice class type
router(config)#
• Enters voice class configuration mode for special voice classes like H.323 and assigns an identification tag
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-9
H.323 Commands (Cont.)
Configuring codecs
voice-class type tag
router(config-dial-peer)#
• Specifies the voice class parameters voice class to be used
codec codec
router(config-dial-peer)#
• Specifies the single codec used
codec preference codec-type [bytes payload-size]
router(config-class)#
• Adds a codec to the class and defines its preference
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-10
H.323 Commands (Cont.)
Tuning H.323 timers:
h225 timeout tcp call-idle value minutes
router(conf-voi-serv)#
• Defines the H.323 TCP call-idle timeout value
h225 timeout setup seconds
router(conf-voi-serv)#
• Defines the H.323 setup timeout value
h225 timeout tcp establish seconds
router(config-class)#
• Defines the H.323 TCP establish timeout value
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-11
Integrating H.323 Gateways with Cisco Unified CallManager
Perform at least these steps to integrate an H.323 voice gateway into Cisco Unified CallManager:
1. Make sure that H.323 is enabled and specify the H.323 source address on the voice gateway.
2. Configure POTS and VoIP dial peer on the gateway.
3. Add a new gateway on Cisco Unified CallManager.
4. Configure the IP address and device pool for the gateway on Cisco Unified CallManager.
5. Add a new route pattern pointing to the gateway on Cisco Unified CallManager.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-12
Phone1-12001
Phone1-22002
Integrating H.323 Gateways with Cisco Unified CallManager: Enable H.323
PSTN
Router1H.323
voice service voip h323 ccm-compatible no shutdown!interface FastEthernet0/0 ip address 10.1.1.1 255.255.255.0 h323-gateway voip bind srcaddr 10.1.1.1 no shutdown
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-13
Phone1-12001
Phone1-22002
Integrating H.323 Gateways with Cisco Unified CallManager: Define the POTS Dial Peer
PSTN
Router1H.323
dial-peer voice 9 pots destination-pattern 9T incoming called-number 2... direct-inward-dial port 1/0:23
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-14
Phone1-12001
Phone1-22002
Integrating H.323 Gateways with Cisco Unified CallManager: Add the First VoIP Dial Peer
PSTN
Router1H.323
voice class h323 1 h225 timeout tcp establish 3!dial-peer voice 21 voip preference 1 destination-pattern 2... voice-class h323 1 session target ipv4:10.1.1.2 incoming called-number 9 codec g711alaw
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-15
Phone1-12001
Phone1-22002
Integrating H.323 Gateways with Cisco Unified CallManager: Add the Second VoIP Dial Peer
PSTN
Router1H.323
dial-peer voice 22 voip preference 2 destination-pattern 2... voice-class h323 1 session target ipv4:10.1.1.3 incoming called-number 9 codec g711alaw
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-16
PSTN
Router1H.323
Integrating H.323 Gateways with Cisco Unified CallManager: Add the Gateway
Phone1-12001
Phone1-22002
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-17
PSTN
Router1H.323
Integrating H.323 Gateways with Cisco Unified CallManager: Configure Parameters
Phone1-12001
Phone1-22002
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-18
PSTN
Router1H.323
Integrating H.323 Gateways with Cisco Unified CallManager: Define the Route Pattern
Phone1-12001
Phone1-22002
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-19
show dial-peer voice tag
router#
• Displays detailed information about the specified dial peer
show dial-peer voice summary
router#
• Displays a summary of all active dial peers
Verifying an H.323 Integration with Cisco Unified CallManager
Dial-peer show and debug commands:
debug voip dialpeer
router#
• Displays default debug output for all active VoIP dial peers
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-20
Verifying an H.323 Integration with Cisco Unified CallManager (Cont.)
H.323 debug commands:
debug h225 asn1
router#
• Displays ASN.1 content of H.225 messages on the router
debug h225 q931
router#
• Displays H.225 Q931 information element details
debug h245 events
router#
• Displays H.245 events on the router
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-21
Summary
• H.323 gateways are used to interconnect H.323 VoIP networks to networks that are using different signaling and/or bearer types.
• An H.323 call flow consists of signaling and transmission of bearer and media packets.
• H.323 allows extremely flexible decentralized call processing and call handling.
• When implementing H.323 gateways, also consider DTMF and fax.
• To configure an H.323 gateway, you must define at least the H.323 voice service, voice ports, and VoIP and POTS dial peers.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-22
Summary (Cont.)
• To integrate an H.323 gateway into Cisco Unified CallManager, at least a new gateway and a route pattern.
• To verify the Cisco Unified CallManager integration of a gateway, there are useful show and debug commands available on Cisco IOS voice gateways.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-23
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-24
Gateway Deployments
Implementing MGCP Gateways
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-25
Overview of MGCP Gateways
• Call processing is done by a call agent such as Cisco Unified CallManager.
• MGCP gateways translate voice streams between audio signals and the IP packet network.
• Configuration commands for MGCP define this information:
– The path between the call agent and the gateway
– The type of gateway
– The type of calls handled by the gateway
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-26
Overview of MGCP Gateways (Cont.)
• MGCP uses endpoints and connections to construct a call.
– Endpoints:
• Sources of or destinations for data
• Physical or logical locations in a device
– Connections:
• Point-to-point
• Multipoint
• MGCP uses UDP for establishing audio connections over IP networks.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-27
MGCP Call Flow
MGCP Gateway
RQNT
PSTN
Signaling
Bearer or MediaRTP Stream
RQNT Response
NTFY
CRCX
CRCX Response
MDCX
MDCX Response
NTFY
DLCX
DLCX ResponseSignaling
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-28
Why MGCP?
Advantages of MGCP gateways:• Centralized dial plan configuration on the Cisco Unified
CallManager
• Centralized gateway configuration on the Cisco Unified CallManager
• Simple Cisco IOS gateway configuration
• Supports QSIG supplementary services with Cisco Unified CallManager
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-29
Why MGCP? (Cont.)
H.323 versus MGCP gateways:H.323 MGCP
Pros
Dial plan directly on the gateway
Translations defined per gateway
Regional requirements can be met
More specific call routing
Advanced fax support
Centralized dial-plan configuration
Centralized gateway configuration
Simple gateway configuration
Easy implementation
Support of QSIG supplementary services
Cons Complex configuration Extra SRST-related call routing configuration
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-30
MGCP Configuration Considerations
TFTP Server onCisco Unified CallManager
Cisco Unified CallManagerAdministration
MGCPGateway
Configuration is done via the web-based Cisco Unified CallManager Administration page.
The MGCP gateway downloads the
configuration from the Cisco Unified
CallManager TFTP server.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-31
ccm-manager config server ip-address
Router(config)#
• Identifies the server from which the MGCP configuration should be downloaded
ccm-manager config
router(config)#
• Enables the MGCP configuration download from the configured server
Basic MGCP Configuration
Configuring The MGCP configuration server:
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-32
Basic MGCP Configuration (Cont.)
ccm-manager config server 192.168.1.1ccm-manager config
ccm-manager mgcpccm-manager music-on-holdccm-manager config server 192.168.1.1ccm-manager config!mgcpmgcp call-agent 192.168.1.1 2427 service-type mgcp version 0.1mgcp dtmf-relay voip codec all mode out-of-bandmgcp rtp unreachable timeout 1000 action notifymgcp modem passthrough voip mode nsemgcp package-capability rtp-packageno mgcp package-capability res-packagemgcp package-capability sst-packageno mgcp package-capability fxr-packagemgcp package-capability pre-packageno mgcp timer receive-rtcpmgcp sdp simplemgcp rtp payload-type g726r16 static!mgcp profile default
Manually configured
Configuration after TFTP download
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-33
mgcp
Router(config)#
• Enables the MGCP protocol
mgcp call-agent ip-address
router(config)#
• Specifies the primary Cisco Unified CallManager
MGCP Commands
Enable MGCP and define the MGCP call agent:
ccm-manager mgcp
router(config)#
• Enables the MGCP gateway to support Cisco Unified CallManager
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-34
ccm-manager redundant-host ip-address
Router(config)#
• Identifies up to two backup Cisco Unified CallManager servers
ccm-manager switchback mode
router(config)#
• Configures switchback mode for returning control to the primary Cisco Unified CallManager
MGCP Commands (Cont.)
Configuring MGCP redundancy:
ccm-manager fallback-mgcp
router(config)#
• Enables the MGCP fallback feature
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-35
ccm-manager music-on-hold
Router(config)#
• Enables music-on-hold
ccm-manager music-on-hold bind interface
router(config)#
• Binds the multicast MOH feature to a designated interface
MGCP Commands (Cont.)
Configuring MOH and DTMF:
mgcp dtmf-relay voip codec {all | low-bit-rate} mode {cisco | nse | out-of-band}
Router(config)#
• Defines DTMF relay parameters
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-36
Integrating MGCP Gateways with Cisco Unified CallManager
Perform at least these steps to integrate an MGCP-controlled voice gateway into Cisco Unified CallManager:
1. Add a new MGCP gateway on Cisco Unified CallManager.
2. Configure the device hardware on Cisco Unified CallManager.
3. Configure the ports on Cisco Unified CallManager.
4. Add a new route pattern pointing to the gateway on Cisco Unified CallManager.
5. Enable MGCP and define the Cisco Unified CallManager as the call agent on the voice gateway.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-37
PSTN
Router1MGCP
Integrating MGCP Gateways with Cisco Unified CallManager: Add the Gateway
Phone1-12001
Phone1-22002
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-38
PSTN
Router1MGCP
Integrating MGCP Gateways with Cisco Unified CallManager: Configure the Device
Phone1-12001
Phone1-22002
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-39
PSTN
Router1MGCP
Integrating MGCP Gateways with Cisco Unified CallManager: Configure the Port
Phone1-12001
Phone1-22002
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-40
PSTN
Router1MGCP
Integrating MGCP Gateways with Cisco Unified CallManager: Define the Route Pattern
Phone1-12001
Phone1-22002
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-41
Phone1-12001
Phone1-22002
Integrating MGCP Gateways with Cisco Unified CallManager: Enable MGCP
PSTN
Router1MGCP
ccm-manager config server 10.1.1.1ccm-manager config
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-42
show mgcp
Router#
• Displays the MGCP settings on the gateway
show ccm-manager
router#
• Displays the Cisco Unified CallManager failover options
Verifying an MGCP Integration with Cisco Unified CallManager
MGCP show commands:
show ccm-manager fallback-mgcp
router#
• Displays whether MGCP fallback is enabled and whether it is active or not (on or off)
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-43
show mgcp endpoint
Router#
• Displays endpoints controlled by MGCP
show isdn status
router#
• Displays information about the status of ISDN Layers 1 to 3
Verifying an MGCP Integration with Cisco Unified CallManager (Cont.)
MGCP show commands (Cont.):
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-44
Summary
• Within an MGCP environment, call routing is done on Cisco Unified CallManager.
• Within an MGCP environment, MGCP signaling is done between Cisco Unified CallManager and the gateway while RTP traffic is transferred between the phone and the gateway.
• MGCP simplifies and centralizes configuration.
• The MGCP configuration is downloaded from the Cisco Unified CallManager TFTP server by the gateway.
• There are several MGCP commands available on Cisco IOS gateways.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-45
Summary (Cont.)
• To integrate an MGCP gateway into Cisco Unified CallManager, you must configure the device settings on the Cisco Unified CallManager.
• You use show commands to view the MGCP status on Cisco IOS gateways.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-46
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-47
Dial Plans on Cisco IOS Gateways
Implementing Dial Plans
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-48
PSTN Dial Plan Requirements
PSTN Requirements Dial Plan Components
Inbound call routing
• Call routing and path selection for inbound PSTN dial peer to outbound VoIP or local dial peer
• Digit manipulation to transform inbound DNIS to endpoints
Outbound call routing
• Call routing and path selection for inbound VoIP or local dial peer to outbound PSTN dial peer
• Digit manipulation to transform outbound DNIS to PSTN requirements
Correct ANI presentation • Digit manipulation to transform ANI to meet PSTN requirements
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-49
Inbound PSTN Calls
PSTN
Phone1-12001
Phone1-22002
1
User dials 14085552001.
Call setup from PSTN:
DNIS 4085552001
2
H.323 GatewayDID 4085552XXX
H.323 call setup: DNIS 2001
4
5
Phone1-1 rings.
13125556666
Gateway modifies DNIS to 2001 and
routes to CallManager.
3
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-50
Outbound PSTN Calls
PSTN
Phone1-12001
Phone1-22002
5
PSTN phone rings.Call setup:DNIS 13125556666
ANI´4085552001
4
H.323 GatewayDID: 4085552XXX
H.323 call setup: DNIS 913125556666
ANI 2001
2
1
User dials 913125556666.
3125556666
Gateway modifies DNIS and ANI.
3
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-51
ISDN Dial Plan Requirements
ISDN Requirements Dial Plan Components
Correct PSTN inbound ANI presentation
depending on TON
Digit manipulation to transform inbound PSTN ANI according to TON
Correct ISDN numbering plan and TON presentation
Manipulate ISDN numbering plan or TON to meet PSTN/PBX requirements
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-52
Inbound ISDN Calls
PSTN
Phone1-12001
Phone1-22002
1
User dials 14085552001.
San JoseDID range: 4085552XXX
Call setup from PSTN:
ANI 3125556666TON National
2
H.323 Gateway
CM 192.168.1.1
H.323 call setup: ANI 913125556666
4
5
Phone1-1 rings.ANI 913125556666
13125556666
Gateway prepends 91 to ANI due to
TON.
3
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-53
Digit Manipulation
Various mechanisms for digit manipulations:• Simple digit manipulation to strip off or prefix digits for POTS dial
peers:
– digit-strip
– forward-digits
– prefix
– clid
• Number expansion to globally inflate or deflate numbers:
– num-exp
– Typically used for short dials and site codes
• Voice translation rules and profiles:
– Powerful and complex digit manipulation using regular expressions
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-54
Digit Manipulation (Cont.)
1. Inbound voice port digit manipulation
2. Global number expansion3. Match inbound dial peer4. Voice translation profile5. CLID
Inbound dial peermatch
Outbound dial peermatch
1. Match outbound dial peer2. Voice translation profile3. CLID
1. Match outbound dial peer2. Voice translation profile3. Digit strip4. Prefix5. Forward digits6. CLID
1. Global voice translation profiles
2. Global number expansion3. Match inbound dial peer4. CLID5. Voice translation profile
POTS
POTS VoIP
VoIP
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-55
Simple Digit Manipulation for POTSDial Peers
PSTN
Phone1-12001 13125556666
Command DNIS
no digit-strip 913125556666
digit-strip (default) 13125556666
forward-digits 4 6666
prefix 9 and digit-strip 913125556666
dial-peer voice 9 pots destination 9T
H.323 GatewayDID: 4085552XXX
User dials 913125556666.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-56
Digit Manipulation with Number Expansion
PSTN
Phone1-12001 13125556666
num-exp 6666 913125556666dial-peer voice 9 pots destination 9T
H.323 GatewayDID: 4085552XXX
User dials 6666. Number is inflated to 91312555666 and routed to
PSTN.
Phone rings.
1 2 3
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-57
Voice Translation Rules and Profiles
• Voice translation rules define up to 15 sub rules to manipulate digits, TONs, and numbering plans.
• Voice translation profiles reference up to three rules:
– Called: Translation rule for the called number
– Calling: Translation rule for the calling number
– Redirect-called: Translation rule for the redirect number
• Voice translation profiles can be referenced by:
– Dial peers, voice ports, any inbound VoIP call, specific range of source IP addresses in VoIP calls, trunk groups, NFAS controllers, or SRST
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-58
Profile
Voice Translation Rules and Profiles (Cont.)
Called Rule
1 2 3 4 5
6 7 8 9 10
11 12 13 14 15
Rule
1 2 3 4 5
6 7 8 9 10
11 12 13 14 15
Rule
1 2 3 4 5
6 7 8 9 10
11 12 13 14 15
Calling
RedirectedCalled
Incoming
Outgoing
Dial Peer
Voice Port
VoIP Incoming
Source IP Group
Trunk Group
NFAS
SRST
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-59
Voice Translation Rules and Profiles (Cont.)
Char Description
^ Match the expression at the start of a line.
$ Match the expression at the end of the line.
/ Delimiter that marks the start and end of both the matching and replacement strings.
\ Escape the special meaning of the next character.
- Indicates a range when not in the first or last position. Used with the'[' and ']'.
[list] Match a single character in a list.
[^list] Do not match a single character specified in the list.
. Match any single character.
* Repeat the previous regular expression zero or more times.
+ Repeat the previous regular expression one or more times.
? Repeat the previous regular expression zero or one time (use CTRL-V in order to enter in IOS).
\(\) Groups regular expressions. Use \1-9 to refer to matched groups.
& Match the substring (matched string). Can also use \0.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-60
Voice Translation Rule Search-and-Replace Examples
Rule Input String Output String
/^9/ // 914085556666 14085556666
/^2001/ /3001/ 2001 3001
/^[23]…/ /4000/ 2025 or 3051 4000
/^2…/ /801&/ 2001 8012001
/^2…/ /801\0/ 2001 8012001
/.*/ /91&/ type national national 3125552001 type national 913125552001 type national
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-61
Voice Translation Rule Search-and-Replace Examples (Cont.)
\(9\) \([^10].*\) \1 \21408
9 5551234 9 55512341408
/ / / /
Search Replace
OutputInput
Translation Rule: /\(9\)\([^10].*\)/ /\11408\2/
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-62
Voice Translation Profile Example: Search and Replace
PSTN-IN
Called Rule 1
Rule 2Calling
RedirectedCalled
1 /^4085552/ /2/
1 /^.*/ /9&/ type subscriber scubscriber
2 /^.*/ /91&/ type national national
3 /^.*/ /9011&/ type international international
voice translation-rule 1 rule 1 /^4085552/ /2/voice translation-rule 2 rule 1 /^.*/ /9&/ type subscriber subscriber rule 2 /^.*/ /91&/ type national national rule 3 /^.*/ /9011&/ type international internationalvoice translation-profile pstn-in translate called 1 translate calling 2
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-63
Cisco Unified CallManager Express with Voice Translation Profiles
PSTN
voice translation-rule 1 rule 1 /^4085552/ /2/voice translation-profile pstn-in translate called 1voice-port 0/0/0:23 translation-profile incoming pstn-indial-peer voice 2001 pots port 1/0/0 destination-pattern 2001
13125556666
Phone rings. Profile modifies DNIS to 2001.
User dials 14085552001.
3 2 1
Replaces the dial plan pattern and
covers inbound and outbound routing of
any dial peers.
FXS Phone1-12001
CMEDID: 4085552XXX
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-64
digit-strip
router(config-dial-peer)#
• Enables stripping of matched digits (default)
prefix digits
router(config-dial-peer)#
• Prefixes the specified digits after the pattern has matched
forward-digits [0-32]|all|extra
router(config-dial-peer)#
• Specifies how many digits to forward, right-justified
Digit Manipulation Commands
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-65
num-exp dialed-digits substitution
router(config)#
• Matches on dialed digits and replaces them (wildcards allowed)
voice translation-rule rule-tag
router(config)#
• Creates or modifies a voice translation rule with the specified numeric tag
rule precedence /match/ /replace/ [type {match-type replace-type} [plan {match-plan replace-plan}]]
router(cfg-translation-rule)#
• Creates a match-and-replace rule
Digit Manipulation Commands (Cont.)
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-66
Digit Manipulation Commands (Cont.)
voice translation-profile profile-name
router(config)#
• Creates or modifies a voice translation profile with the specified name
translate {called | calling | redirect-called} translation-rule-number
router(cfg-translation-profile)#
• Binds a translation rule to a profile
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-67
Digit Manipulation Commands (Cont.)
translation-profile {incoming | outgoing} name
router(dial-peer)#
• Binds a translation profile to a dial peer
test voice translation-rule number input-test-string [type match-type [plan match-plan] ]
router#
• Tests a translation rule with a user-defined test string
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-68
destination-pattern [+]string[T]
router(config-dial-peer)#
• Defines the destination pattern of a dial peer that will be used during outbound dial-peer matching
incoming called-number [+]string[T]
router(config-dial-peer)#
• Specifies the incoming called number that will be used during inbound dial-peer matching
answer-address [+]string[T]
router(config-dial-peer)#
• Specifies the incoming calling number will be used during inbound dial-peer matching
Call Routing and Path Selection Commands
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-69
direct-inward-dial
router(config-dial-peer)#
• Uses the inbound POTS DNIS to match the outbound dial peer (usually required for any DID PSTN trunk)
Call Routing and Path Selection Commands (Cont.)
preference [0-9]
router(config-dial-peer)#
• Specifies the preference of a dial peer; lower number = high priority default=0
no dial-peer outbound status-check pots
router(config)#
• Disables status checking of outbound POTS dial peers during call setup; always includes dial peer in call routing, even if POTS status is down; and useful for some ISDN links
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-70
Configuring PSTN Dial Plans
1. Configure digit manipulation for inbound calls.
2. Define dial peers.
3. Configure inbound dial-peer matching.
4. Configure digit manipulation for outbound calls.
5. Configure digit manipulation for intersite calls.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-71
PSTN Dial Plan Scenario
PSTN
IP WANPhone1-1
2001Phone1-2
2002Phone2-1
3001Phone2-2
3002
San Jose Chicago
Router1H.323
Router3CME
3125556666
CM1: 192.168.1.1CM2: 192.168.1.2
Users should be able to reach the other
site via an extension.
DID: 312555XXXXDID: 408555XXXX
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-72
Step 1: Configure Digit Manipulation for Inbound Calls
Router1H.323
Router3CME
voice translation-rule 1 rule 1 /^4085552/ /2/voice translation-rule 2 rule 1 /^.*/ /9&/ type subscriber subscriber rule 2 /^.*/ /91&/ type national national rule 2 /^.*/ /9011&/ type international internationalvoice translation-profile pstn-in translate called 1 translate calling 2voice-port 0/0/0:23 translation-profile incoming pstn-in
voice translation-rule 1 rule 1 /^3125553/ /3/voice translation-rule 2 rule 1 /^.*/ /9&/ type subscriber subscriber rule 2 /^.*/ /91&/ type national national rule 2 /^.*/ /9011&/ type international internationalvoice translation-profile pstn-in translate called 1 translate calling 2voice-port 0/0/0:23 translation-profile incoming pstn-in
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-73
Step 2: Define Dial Peers
Router1H.323
Router3CME
dial-peer voice 9 pots destination-pattern 9T direct-inward-dial port 0/0/0:23
dial-peer voice 9 pots destination-pattern 9T direct-inward-dial port 0/0/0:23dial-peer voice 20 voip destination-pattern 2... session-target ipv4:192.168.1.1 codec g711ulawdial-peer voice 21 voip preference 1 destination-pattern 2... session-target ipv4:192.168.1.2 codec g711ulaw
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-74
Step 3: Configure Inbound Dial-Peer Matching
Router1H.323
Router3CME
dial-peer voice 9 pots destination-pattern 9T incoming called-number 2... direct-inward-dial port 0/0/0:23dial-peer voice 20 voip answer-address 2... destination-patter 2... session-target ipv4:192.168.1.1 codec g711ulawdial-peer voice 21 voip answer-address 2... preference 1 destination-patter 2... session-target ipv4:192.168.1.2 codec g711ulaw
dial-peer voice 9 pots destination-pattern 9T incoming called-number 3... direct-inward-dial port 0/0/0:23
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-75
Step 4: Configure Digit Manipulation for Outbound Calls
Router1H.323
Router3CME
voice translation-rule 3 rule 1 /^2/ /4085552/voice translation-profile pstn-out translate calling 3voice-port 0/0/0:23 translation-profile outgoing pstn-out
voice translation-rule 3 rule 1 /^3/ /3125553/voice translation-profile pstn-out translate calling 3voice-port 0/0/0:23 translation-profile outgoing pstn-out
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-76
Step 5: Configure Digit Manipulation for Intersite Calls
Router1H.323
Router3CME
num-exp 3... 913125553... num-exp 2... 914085552...
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-77
Inbound PSTN Call Flow
PSTN
H.323 GatewayDID: 4085552XXX 3125556666
dial-peer voice 9 pots destination-pattern 9T incoming called-number 2... direct-inward-dial port 0/0/0:23
voice-port 0/0/0:23 translation-profile incoming pstn-in
dial-peer voice 20 voip answer-address 2... destination-patter 2... session-target ipv4:192.168.1.1 codec g711ulaw
1
2
3
123
ANI
DNIS
9131255566663125556666
20014085552001
OutgoingIncoming
ANI
DNIS
913125556666913125556666
20012001
OutgoingIncoming
ANI
DNIS
913125556666913125556666
20012001
OutgoingIncoming
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-78
Outbound PSTN Call Flow
PSTN
H.323 GatewayDID: 4085552XXX 3125556666
dial-peer voice 9 pots destination-pattern 9T incoming called-number 2... direct-inward-dial port 0/0/0:23
dial-peer voice 20 voip answer-address 2... destination-patter 2... session-target ipv4:192.168.1.1 codec g711ulaw
voice-port 0/0/0:23 translation-profile outgoing pstn-out
1
2
3
321
ANI
DNIS
20012001
913125556666913125556666
OutgoingIncoming
ANI
DNIS
20012001
13125556666913125556666
OutgoingIncoming
ANI
DNIS
40855520012001
1312555666613125556666
OutgoingIncoming
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-79
Verifying PSTN Dial Plans
show dialpeer voice summary
router#
Router1#show dial-peer voice summarydial-peer hunt 0 AD PRE PASS OUTTAG TYPE MIN OPER PREFIX DEST-PATTERN FER THRU SESS-TARGET STAT PORT9 pots up up 9T 0 up 1/0:2320 voip up up 2... 0 syst ipv4:192.168.1.121 voip up up 2... 1 syst ipv4:192.168.1.2
• Displays a summary of all dial peers
Destination Pattern Preference
Voice PortSession Target
Administrative and Operational State
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-80
Verifying PSTN Dial Plans (Cont.)
debug isdn q931
router#
• Debugs ISDN Layer 3 information, which includes DNIS and ANI information
debug voip dialpeer
router#
• Debugs dial-peer matching
debug voice translation
router#
• Debugs voice-translation-rule operation
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-81
Summary
• Interworking with the PSTN requires appropriate call routing and digit manipulation.
• Digit manipulation based on a TON and numbering plan is required for ISDN networks.
• Voice translation profiles are powerful tools for digit manipulation but sometimes can be replaced by more simple mechanisms.
• Voice translation profiles consist of voice translation rules that use regular expressions for match and replace.
• Voice translation profiles can be used to work around issues with the dialplan-pattern command.
• Voice translation rules are configured to be used within voice translation profiles.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-82
Summary (Cont.)
• Call routing and path selection are configured using dial peers.
• Configuring a PSTN dial plan includes configuration of digit manipulation, inbound dial peers, inbound dial-peer matching and outbound dial-peer matching.
• Verify correct dial-peer matching and digit manipulation using show and debug commands.
© 2006 Cisco Systems, Inc. All rights reserved. BSCI v3.0—6-83