© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Dial Plans on Cisco IOS Gateways Implementing PSTN Dial Plans

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v PSTN Dial Plan Requirements PSTN RequirementsDial 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.GWGK v Inbound PSTN Calls PSTN Phone Phone User dials Call setup from PSTN: DNIS H.323 Gateway DID XXX H.323 call setup: DNIS Phone1-1 rings Gateway modifies DNIS to 2001 and routes to CallManager. 3

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Outbound PSTN Calls PSTN Phone Phone PSTN phone rings. Call setup: DNIS ANI´ H.323 Gateway DID: XXX H.323 call setup: DNIS ANI User dials Gateway modifies DNIS and ANI. 3

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v ISDN Dial Plan Requirements ISDN RequirementsDial 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.GWGK v Inbound ISDN Calls PSTN Phone Phone User dials San Jose DID range: XXX Call setup from PSTN: ANI TON National 2 H.323 Gateway CM H.323 call setup: ANI Phone1-1 rings. ANI Gateway prepends 91 to ANI due to TON. 3

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v 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.GWGK v Digit Manipulation (Cont.) 1. Inbound voice port digit manipulation 2. Global number expansion 3. Match inbound dial peer 4. Voice translation profile 5. CLID Inbound dial peer match Outbound dial peer match 1. Match outbound dial peer 2. Voice translation profile 3. CLID 1. Match outbound dial peer 2. Voice translation profile 3. Digit strip 4. Prefix 5. Forward digits 6. CLID 1. Global voice translation profiles 2. Global number expansion 3. Match inbound dial peer 4. CLID 5. Voice translation profile POTS VoIP

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Simple Digit Manipulation for POTS Dial Peers PSTN Phone CommandDNIS no digit-strip digit-strip (default) forward-digits prefix 9 and digit-strip dial-peer voice 9 pots destination 9T H.323 Gateway DID: XXX User dials

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Digit Manipulation with Number Expansion PSTN Phone num-exp dial-peer voice 9 pots destination 9T H.323 Gateway DID: XXX User dials Number is inflated to and routed to PSTN. Phone rings. 123

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Digit Manipulation Using clid The clid command is used to modify the calling number: clid network-number number [second-number strip] –Configures a network number in the router for CLID clid second-number strip –Prevents the second network number from being sent in the CLID information clid restrict –Prevents the calling party number from being presented clid strip [name] –Removes the calling party number or name information from the CLID information and prevents the calling party number from being presented

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v 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.GWGK v Profile Voice Translation Rules and Profiles (Cont.) CalledRule Rule Rule Calling Redirected Called Incoming Outgoing Dial Peer Voice Port VoIP Incoming Source IP Group Trunk Group NFAS SRST

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Voice Translation Rules and Profiles (Cont.) CharDescription ^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.GWGK v Voice Translation Rule Search-and-Replace Examples RuleInput StringOutput String /^9/ // /^2001/ /3001/ /^[23]…/ /4000/2025 or /^2…/ /801&/ /^2…/ /801\0/ /.*/ /91&/ type national national type national type national

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Voice Translation Rule Search-and-Replace Examples (Cont.) \(9\)\([^10].*\)\1\ //// Search Replace OutputInput Translation Rule: /\(9\)\([^10].*\)/ /\11408\2/

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Voice Translation Profile Example: Search and Replace PSTN-IN CalledRule 1 Rule 2 Calling Redirected Called 1/^ / /2/ 1/^.*/ /9&/ type subscriber scubscriber 2/^.*/ /91&/ type national national 3/^.*/ /9011&/ type international international voice translation-rule 1 rule 1 /^ / /2/ voice translation-rule 2 rule 1 /^.*/ /9&/ type subscriber subscriber rule 2 /^.*/ /91&/ type national national rule 3 /^.*/ /9011&/ type international international voice translation-profile pstn-in translate called 1 translate calling 2

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Voice Translation Profile Example: Call Blocking BLOCK Called Rule 1 Calling Redirected Called 1reject /408555* voice translation-rule 1 rule 1 reject /408555*/ voice translation profile block translate calling 1 Dial-peer voice 111 pots Call-block translation-profile incoming block Call-block disconnect-cause incoming invalid_number

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Voice Translation Profiles vs. dialplan-pattern dialplan-pattern for Cisco Unified CallManager Express and Cisco SRST: Creates another dial peer for every ephone-dn: –Destination pattern = DID number of the directory number –Also used for outbound PSTN calls for correct ANI –Can be used to register the DID number with a gatekeeper Problem: –Increases the number of dial peers and works only for ephone-dn Solution: –Use voice translation profiles on the voice port

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v FXS Phone Cisco Unified CallManager Express with dialplan-pattern PSTN telephony-service dialplan-pattern extension-length 4 dial-peer voice 2001 pots port 1/0/0 destination-pattern Analog phone will not ring. No match on User dials Easy to deploy, with some caveats on non-ephone-dn dial peers. CME DID: XXX X

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Cisco Unified CallManager Express with Voice Translation Profiles PSTN voice translation-rule 1 rule 1 /^ / /2/ voice translation-profile pstn-in translate called 1 voice-port 0/0/0:23 translation-profile incoming pstn-in dial-peer voice 2001 pots port 1/0/0 destination-pattern Phone rings. Profile modifies DNIS to User dials Replaces the dial plan pattern and covers inbound and outbound routing of any dial peers. FXS Phone CME DID: XXX

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v 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.GWGK v 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.GWGK v 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.GWGK v 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.GWGK v 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.GWGK v 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.GWGK v 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.GWGK v PSTN Dial Plan Scenario PSTNIP WAN Phone Phone Phone Phone San Jose Chicago Router1 H.323 Router3 CME CM1: CM2: Users should be able to reach the other site via an extension. DID: XXXX DID: XXXX

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Step 1: Configure Digit Manipulation for Inbound Calls Router1 H.323 Router3 CME voice translation-rule 1 rule 1 /^ / /2/ voice translation-rule 2 rule 1 /^.*/ /9&/ type subscriber subscriber rule 2 /^.*/ /91&/ type national national rule 2 /^.*/ /9011&/ type international international voice translation-profile pstn-in translate called 1 translate calling 2 voice-port 0/0/0:23 translation-profile incoming pstn-in voice translation-rule 1 rule 1 /^ / /3/ voice translation-rule 2 rule 1 /^.*/ /9&/ type subscriber subscriber rule 2 /^.*/ /91&/ type national national rule 2 /^.*/ /9011&/ type international international voice translation-profile pstn-in translate called 1 translate calling 2 voice-port 0/0/0:23 translation-profile incoming pstn-in

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Step 2: Define Dial Peers Router1 H.323 Router3 CME 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:23 dial-peer voice 20 voip destination-pattern 2... session-target ipv4: codec g711ulaw dial-peer voice 21 voip preference 1 destination-pattern 2... session-target ipv4: codec g711ulaw

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Step 3: Configure Inbound Dial-Peer Matching Router1 H.323 Router3 CME 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: codec g711ulaw dial-peer voice 21 voip answer-address 2... preference 1 destination-patter 2... session-target ipv4: 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.GWGK v Step 4: Configure Digit Manipulation for Outbound Calls Router1 H.323 Router3 CME voice translation-rule 3 rule 1 /^2/ / / voice translation-profile pstn-out translate calling 3 voice-port 0/0/0:23 translation-profile outgoing pstn- out voice translation-rule 3 rule 1 /^3/ / / voice translation-profile pstn-out translate calling 3 voice-port 0/0/0:23 translation-profile outgoing pstn- out

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Step 5: Configure Digit Manipulation for Intersite Calls Router1 H.323 Router3 CME num-exp num-exp

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Inbound PSTN Call Flow PSTN H.323 Gateway DID: XXX 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: codec g711ulaw ANI DNIS OutgoingIncoming ANI DNIS OutgoingIncoming ANI DNIS OutgoingIncoming

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Outbound PSTN Call Flow PSTN H.323 Gateway DID: XXX 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: codec g711ulaw voice-port 0/0/0:23 translation-profile outgoing pstn-out ANI DNIS OutgoingIncoming ANI DNIS OutgoingIncoming ANI DNIS OutgoingIncoming

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v Verifying PSTN Dial Plans show dialpeer voice summary router# Router1#show dial-peer voice summary dial-peer hunt 0 AD PRE PASS OUT TAG TYPE MIN OPER PREFIX DEST-PATTERN FER THRU SESS-TARGET STAT PORT 9 pots up up 9T 0 up 1/0:23 20 voip up up syst ipv4: voip up up syst ipv4: Displays a summary of all dial peers Destination Pattern Preference Voice PortSession Target Administrative and Operational State

© 2006 Cisco Systems, Inc. All rights reserved.GWGK v 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.GWGK v 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.GWGK v 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.GWGK v