Configure Number Translation with Voice Translation Profiles

Introduction

This document describes how to configure number translation with the Voice Translation Profiles.

Prerequisites

Requirements

There are no specific requirements for this document.

Components Used

The information in this document is based on the Voice Gateways that run Cisco IOS®Software Release 12.2(11)T or later.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.

Conventions

Refer to theCisco Technical Tips Conventionsfor more information on document conventions.

Background Information

Voice Translation Profiles introduce a new scheme to translate numbers. The older translation rules are to be gradually phased out of the system. Cisco strongly recommends you only use one scheme of translation rules. If you mix the old and new schemes, you can have unforeseen results. Central to the new scheme is the ability to perform regular expression matches and replace sub strings. The Stream Editor (SED) utility is used to translate numbers. See the Related Information section for more information on SED.

This document describes highlighted features and configurations for new Voice Translation Profiles and specific examples for the most common scenarios.

The translation rules replace a sub string of the input number if the number matches the match pattern, number plan, and type present in the rule. The SED utility is used to check for a match based on the match pattern. Another ability of the translation rules is the ability to block calls on specific numbers. These rules are specified with a special keyword called 'reject'.

Features:

New translation rules come after regular expression that match in a way similar to SED:

• An escape sequence similar to UNIX via backslashes is supported.

• The keywords NULL and ANY are not supported in new translation rules, but these keywords can be replaced by regular expressions similar to SED.

• Up to fifteen translation rules can be defined per translation rule table.

• Up to 1000 translation profiles can be defined. Up to 128 translation rules can be defined.

Configure

This section presents you with the information used to configure the features described in this document.

Note: Use the Command Lookup Tool to find more information on the commands used in this document. Only registered Cisco users can access internal Cisco tools and information.

Assign Translation Profiles

New translation rules can be referenced by a translation profile. You can define these types of call numbers in a translation profile:

• Called

• Calling

• Redirect-called

Each type of call number in the profile can have different translation rules.

Once a translation profile is defined, it can be referenced by:

• Trunk Group—Two different translation profiles can be defined in a trunk group in order to perform number translation for incoming and outgoing POTS calls. If an outgoing translation profile is defined in a trunk group, the number translation is done while the outgoing call is setup.

• Source IP Group—A translation profile can be defined in a source IP group in order to perform number translation for incoming VoIP calls.

• Dial Peer—Two different translation profiles can be defined in a dial peer in order to perform number translation for incoming and outgoing calls.

• Voice Port—The translation profile can be defined in a voice port in order to perform number translation for incoming and outgoing POTS calls. If a voice port is also a trunk group member, then the incoming translation profile of a voice port overrides the translation profile of a trunk group.

• Non-Facility Associated Signaling (NFAS) Interface—The translation profile can be defined for an NFAS interface through the translation-profile command line from the global voice service pots configuration in order to perform the number translation for incoming and outgoing NFAS calls. This translation profile has a higher precedence than the translation profile of a voice port and trunk group in case a channel also belongs to a voice port and/or trunk group with the translation profile defined.

• VoIP Incoming—The translation profile can be defined globally for all incoming VoIP (h323/sip) calls in order to perform number translation. If an incoming H.323/SIP call is associated with a Source IP Group with a translation profile defined, then the translation profile of the Source IP Group overrides the global translation profile for incoming VoIP calls.

Voice Translation-rule Command

Issue the voice translation-rulecommand in global configuration mode in order to define a translation rule for voice calls. Use thenoform of this command in order to delete the translation rule.

• voice translation-rule number

• no voice translation-rule number

Note: The number parameter is the unique identifier for the translation rule. The range is from 1 to 2147483647. There is no default.

rule (voice translation-rule)

In order to define a translation rule, use the  rule command in voice translation-rule configuration mode. In order to delete the translation rule, use thenoform of this command.

• Match and Replace Rule

  rule precedence /match-pattern/ /replace-pattern/
  
  [type {match-type replace-type} [plan {match-type replace-type}]] 
  
  no rule precedence
   

• Reject Rule

  rule precedence reject /match-pattern/ [type match-type [plan match-type]]
  
  no rule precedence
   

Syntax Description

Example

This example initiates translation rule 150. This includes two rules:

Router(config)#voice translation-rule 150

Router(cfg-translation-rule)#rule 1 reject /^919\(.(\)/

Router(cfg-translation-rule)#rule 2 /\(^...\)853\(...\)/ /\1525\2/

The voice translation rules use characters similar to Regular Expression Syntax (regexp), but there are some minor differences and limitations. Most of the limitations are of no real concern since only digit manipulation is performed.

/^$/

/ /

/^.*/

/ /

//

//

/^392\(.*\)/

/555\1/ 

/^\(555\)\(....\)/ 

/444\2/

/^555\(....\)/

/444\1/ 

/\(^...\)555\(....\)/

/\1444\2/

/\(^...\)\(555\)\(....\)/

/\1444\3/

/\(.*\)1212$/

/\13434/

/\(.*\)1212/

/\13434/

/444/  

/555/

/^[135]/

/9/

/^[1-35]/

/9/

/^[^1-35]/ 

/9/

/^1#/

//

/^1\#\(.*\)/ 

/\1/

/^1\*/

//

/^1\*\(.*\)/ 

/\1/

/^5+/

/9/

/^\(555\)+\(.*\)/

/444\2/

/^9?1?\(919\)/

/\1/

/1234/

/00&00/

/1234/

/00\000/

Translation Profile Configuration

voice translation-profile <name>
translate called <translation-rule num>
translate calling <translation-rule num> 
translate redirect-called <translation-rule num>
 no 

voice translation-profile <name>

translate called <translation rule #>

translate calling <translation rule #>

translate redirect-called <translation rule #>

Based on the signaling type of the incoming call, the calling number is equivalent to Automatic Number Identifier (ANI) or the calling line id. The redirect-called number is equivalent to redirect Dialed Number Identification Service (DNIS) or the original called number.

VoIP Incoming Configuration

voip-incoming translation-profile <name>

voip-incoming translation-profile

This VoIP incoming translation profile configuration example assigns the translation profile named global-definition to all incoming VoIP calls.

Router(config)#voip-incoming translation-profile global-definition

Dial Peer Configuration

Inbound Dial Peer

dial-peer voice <num> [pots|voip|vofr|voatm]
translation-profile [incoming | outgoing] <name>

To Block Calls

dial-peer voice <num> [pots|voip]
 call-block translation-profile incoming <name>
 call-block disconnect-cause incoming <cause>
 carrier-id source <name>

call-block translation-profile incoming <name>

call-block disconnect-cause incoming <cause>

carrier-id source <name>

translation-profile incoming <name>

Outbound Dial Peer

dial-peer voice <num> pots
 carrier-id target <name>
 trunkgroup <num> [preference_num]
 trunkgroup <num> [preference_num]
 translation-profile outgoing <name>

carrier-id target <name>

translation-profile outgoing <name>

trunkgroup <number> [preference_num]

Voice Port Configuration

voice-port <number>
 translation-profile [incoming | outgoing] <name>
 trunk-group <name> [preference]

translation-profile incoming

trunk-group

Controller Translation Profile

The controller translation profile is used for an incoming NFAS call or outgoing NFAS call which is routed through a trunk group.

voice service pots
 translation-profile [incoming | outgoing] controller [T1 | E1] <unit#> <name>

translation-profile

[incoming | outgoing]

controller

[T1 | E1] <unit#>

<name>

Trunk Group Configurations

trunk group <name>
 carrier-id <name>
 hunt-scheme { [least-idle [even|odd] [up|down] |
             least-used [even|odd] [up|down] |
             longest-idle [even|odd] [up|down |
             random
             round-robin [even|odd] [up|down] |
             sequential [even|odd] [up|down] 
 translation-profile incoming <name>
 translation-profile outgoing <name>

trunk group <name> [<preference>]

carrier-id <name>

hunt-scheme

description

translation-profile

Trunk Group Member Configurations

interface serial <slot/port>:<num>
   trunk-group <name> [<preference>]

interface bri <number>
   trunk-group <name> [<preference>]

voice-port <number>
   trunk-group <name> [<preference>]
 
/* ds0-group trunk group configuration example */

controller T1 1/0
   ds0-group 1 timeslots 1-10 type e&m-fgd
   ds0-group 2 timeslots 12-20 type e&m-fgd
   cas-custom 1
    trunk-group 11
   cas-custom 2
    trunk-group 22

Source IP Group Configurations

voice source-group <name>
  access-list <num>
  carrier-id source <name>
  carrier-id target <name>
  description <text>
  disconnect-cause <user-selected-reason>
  translation-profile incoming <name>
       h323zone-id <text>

voice source-group <name>

access-list

carrier-id source <name>

carrier-id target <name>

description

disconnect-cause

translation-profile incoming

h323zone-id

CallManager Fallback Configuration

You can also apply Translation profiles in a Cisco CallManager fallback configuration. When applied under thecall-manager-fallback mode, the calls are translated only when the IP phones fallback to SRST mode. Under normal circumstances (when phones are registered to Cisco CallManager servers), the call made by the phones are not translated. The translation-profileunder the  call-manager-fallbackaffect the incoming and outgoing calls to the router from the IP phone. This is a different behavior than when you apply the translation-profile under a dial-peer . The  incoming and  outgoing commands are related to the IP phone. The  incoming command changes the parameters of calls that come from the IP phone. The  outgoing command changes the values of calls that go out of the router to the IP phone.

voice translation-rule 1
 rule 1 /^.*/ /5551234/
!
!
voice translation-profile srst-in
 translate calling 1
!
call-manager-fallback
 translation-profile incoming srst-in
!

When the IP phone makes a call, the calling number of the incoming calling number changes and is then processed by the router. The router routes the call with that calling number. In this example, all calls from IP phones to the router show the calling number as 5551234. This includes the calls between IP phones. In order to change the calling number to calls that leave the router to the PSTN only, apply the  translation-profile in the  dial-peer potsso that IP phone to IP phone calls are not affected.

Refer to the Cisco IOS Voice Command Reference for information on thecall-manager-fallback command.

Call Blocking Configuration Examples

Call Blocking All Calls on a Dial Peer

Configure a voice translation rule that matches any number.

!
voice translation-rule 1 
 rule 1 reject /^.*/      

!--- Matches any number string and rejects the call.

!

!--- Apply the rule to a translation profile for called, 
!--- calling, or redirect-called numbers.

!
voice translation profile call_block 
 translate calling 1      

!--- Invokes voice translation rule 1 in order to determine which calls 
!--- to reject based on the calling number.

!

!--- Include the translation profile within a dial peer definition. 
!--- You can use incoming called-number to only match this dial peer at certain times.

!
dial-peer voice 100 pots     

!--- This can be any dial peer that matches the desired inbound call.

 incoming called-number 3927393     

!--- Matches this dial peer for inbound POTS calls 
!--- that go to the number string listed.

 call-block translation-profile incoming call_block
 
!--- Invokes the voice translation profile “call_block” 
!--- on inbound POTS calls that match this peer in order to 
!--- determine which calls to reject.

 call-block disconnect-cause incoming call-reject     

!--- Sets the cause code to “call-reject” for blocked calls.

Call Blocking Specific Calling Numbers

Configure a voice translation rule to block the desired calling number you want to block. This example uses 9193927393.

voice translation-rule 1
 rule 1 reject /9193927393/      

!--- Matches the defined number string and rejects the call.

!
!--- Apply the rule to a translation profile for the calling number. 
!--- You could also reject based on called or redirect-called numbers.
!
voice translation-profile call_block
 translate calling 1      

!--- Invokes voice translation rule 1 in order to determine 
!--- which calls to reject based on the calling number.

!

!--- Include the translation profile within a dial peer definition.

!
dial-peer voice 100 pots
 call-block translation-profile incoming call_block      

!--- Invokes the voice translation profile “call_block” on 
!--- inbound POTS calls that match this peer 
!--- in order to determine which calls to reject.

 call-block disconnect-cause incoming call-reject
 incoming called-number       

!--- Matches this peer for all inbound POTS calls.

 port 1/1:23

Call Blocking Specific Called Numbers

Configure a voice translation rule to match the desired called number you want to block. This example uses 3927393.

!
voice translation-rule 1
 rule 1 reject /3927393/      

!--- Matches the defined number string and rejects the call.

!

!--- Apply the rule to a translation profile for the called number. 
!--- You could also reject based on calling or redirect-called numbers.

!
voice translation-profile call_block
 translate called 1      

!--- Invokes voice translation rule 1 in order to determine which 
!--- calls to reject based on the called number.

!

!--- Include the translation profile within a dial peer definition.

!
dial-peer voice 100 voip
 call-block translation-profile incoming call_block     
 
!--- Invokes the voice translation profile “call_block” on 
!--- inbound POTS calls that match this peer 
!--- in order to determine which calls to reject.

 call-block disconnect-cause incoming call-reject
 incoming called-number

Translate Any Number to a Specific Number

voice translation-rule 1
 rule 1 /\(.*\)/ /300/     

!--- Matches any number string and replaces it with 300.

!
voice translation-profile my_profile
 translate called 1     

!--- Invokes voice translation rule 1 in order to translate the called number.

!
dial-peer voice 1000 pots     

!--- This can be any dial peer that matches the inbound call.

 translation-profile incoming my_profile     

!--- Invokes voice translation profile “my_profile” for incoming calls.

 direct-inward-dial
 incoming called-number .
 port 1/0:23

Router#
Router#test voice translation-rule 1 5551234
Matched with rule 1
Original number: 5551234        Translated number: 300
Original number type: none      Translated number type: none
Original number plan: none      Translated number plan: none

Translate Inbound Seven Digit Numbers to Four Digits

voice translation-rule 1     

!--- Matches any number string that begins with 498 and 
!--- changes those three digits to null (removes them).

   rule 1 /^498/ //
  !
  !
  voice translation-profile Voice    

!--- Invokes voice translation rule 1 to translate the called number.

   translate called 1
  !
  dial-peer voice 225 pots
   translation-profile incoming Voice     

!--- Invokes voice translation profile “Voice” for incoming calls.

   direct-inward-dial
   port 1/0:23

Router#test voice translation-rule 1 4985555
  Matched with rule 1
  Original number: 4985555 Translated number: 5555
  Original number type: none      Translated number type: none
  Original number plan: none      Translated number plan: none

Prefix the Inbound Called Number

voice translation-rule 1     

!--- Matches any number string and places 555 in front of the original number.

 rule 1 // /555/
!
voice translation-profile prefix     

!--- Invokes voice translation rule 1 in order to translate the called number.

 translate called 1
!
dial-peer voice 1 pots
    translation-profile incoming prefix    

!--- Invokes voice translation profile “prefix” for incoming calls.


Router#test voice translation-rule 1 1234
Matched with rule 1
Original number: 1234   Translated number: 5551234
Original number type: none      Translated number type: none
Original number plan: none      Translated number plan: none

Change Outbound Calls with a Plan and Type of Unknown to ISDN and National

voice translation-rule 1
 rule 1 // // type unknown national plan unknown isdn     

!--- Matches any number string with a plan and type of 
!--- unknown. Also changes the type to national and the plan to isdn.

!
voice translation-profile isdn_map
 translate called 1     

!--- Invokes voice translation rule 1 in order to translate the called number.

!
dial-peer voice 1 pots
    translation-profile outgoing isdn_map     

!--- Invokes voice translation profile “isdn_map” for outgoing calls.

kearly01#test voice translation-rule 1 5551234 type unknown plan unknown 
Matched with rule 1
Original number: 5551234        Translated number: 5551234
Original number type: unknown   Translated number type: national
Original number plan: unknown   Translated number plan: isdn

Prefix the Calling Number

voice translation-rule 1     

!--- Matches number strings that start with 4 
!--- and places 9059514 in the beginning 4 place. 
!--- It serves the same type of function for the number 0.


 rule 1 /^4/ /9059514/
 rule 2 /^0/ /9059510/
!
voice translation-profile Prefix     

!--- Invokes voice translation rule 1 in order to translate the calling number.

 translate calling 1
!
dial-peer voice 100 pots
 translation-profile outgoing Prefix     

!--- Invokes voice translation profile “Prefix” for outgoing calls.

Make Phones Go Out Specific Ports

voice translation-rule 29     

!--- Matches anything that starts with a 9 and replaces the 9 with 29.

 rule 1 /^9/ /29/
!
voice translation-rule 39     

!--- Matches anything that starts with a 9 and replaces the 9 with 39.

 rule 1 /^9/ /39/
!
voice translation-profile FXS29     

!--- Invokes voice translation profile “FXS29” in order to translate the called number.

 translate called 29
!
voice translation-profile FXS39     

!--- Invokes voice translation profile “FXS39” in order to translate the called number.

 translate called 39
!
voice-port 1/1/0
 connection plar 8005     

!--- Sends inbound calls directly to the IP phone with 8005 DN.

!
voice-port 1/1/1
 connection plar 8006     

!--- Sends inbound calls directly to the IP phone with 8006 DN.

!
dial-peer voice 110 pots     

!--- Since calls from 8005 that begin with a 9 are changed 
!--- to begin with 29, all these calls match this dial peer 
!--- and go out port 1/1/0 (when not in SRST mode).

 destination-pattern 29T
 port 1/1/0
!
dial-peer voice 111 pots     

!--- Since calls from 8006 that begin with a 9 are changed 
!--- to begin with 39, all these calls match this dial peer 
!--- and go out port 1/1/1 (when not in SRST mode).

 destination-pattern 39T
 port 1/1/1
!
dial-peer voice 1000 voip     

!--- To Cisco CallManager.

 preference 1
 destination-pattern .T
 voice-class h323 1
 session target ipv4:10.1.0.13
 dtmf-relay h245-alphanumeric
 ip qos dscp cs5 media
!
dial-peer voice 29 voip
 translation-profile incoming FXS29     

!--- Matches calls from the IP phone with a DN of 8005, and invokes 
!--- voice translation profile FXS29 in order to change numbers that start 
!--- with a 9 to begin with 29.

 answer-address 8005
!
dial-peer voice 39 voip
 translation-profile incoming FXS39          

!--- Matches calls from the IP phone with a DN of 8006, 
!--- and invokes voice translation profile FXS39 in order to change 
!--- numbers that start with a 9 to begin with 39.

 answer-address 8006

Make Calls from Specific Ports go to the Desired VoIP Peer with the Same Called Number

voice translation-rule 27     

!--- Matches anything that starts with a 7 and replaces the 7 with 27.

 rule 1 /^7/ /27/
!
voice translation-rule 37     

!--- Matches anything that starts with a 7 and replaces the 7 with 37.

 rule 1 /^7/ /37/
!
voice translation-profile FXS27     

!--- Invokes voice translation profile “FXS27” in order to translate the called number.

 translate called 27
!
voice translation-profile FXS37     

!--- Invokes voice translation profile “FXS37” in order to translate the called number.

 translate called 37
!
dial-peer voice 270 voip     

!--- Matches the called number of 27 which is 
!--- translated from port 2/0. You can use a translation 
!--- profile in order to change the number back to 7 here if needed.

 destination-pattern 27
 session target ipv4:10.1.1.2
!
dial-peer voice 370 voip     

!--- Matches the called number of 37 which is translated 
!--- from port 2/1. You can use a translation profile in order to 
!--- change the number back to 7 here if needed.

 destination-pattern 37
 session target ipv4:10.1.1.3
!
dial-peer voice 27 pots
 translation-profile incoming FXS27     

!--- Matches calls from port 2/0, and invokes voice translation 
!--- profile FXS27 in order to change numbers that start with a 7 to begin with 27.

 port 2/0
!
dial-peer voice 37 pots
 translation-profile incoming FXS37          

!--- Matches calls from port 2/1, and invokes voice translation 
!--- profile FXS37 in order to change numbers that start with a 7 to begin with 37.

 port 2/1

Verify

Certainshowcommands are supported by theOutput Interpreter Tool, which allows you to view an analysis of  show command output.

Note: Only registered Cisco users have access to internal Cisco tools and information.

You can use the  test voice translation-rule  command to test the behavior of the rule.

In order to test the functionality of a translation rule, use the test voice translation-rulecommand in privileged EXEC mode.

test voice translation-rule number input-test-string [type match-type [plan match-type]]

Example

voice translation-rule 1
  rule 1 /^555\(....\)/ /444\1/
  rule 2 /777/ /888/ type national unknown plan any isdn

kearly01#test voice translation-rule 1 5551234
Matched with rule 1
Original number: 5551234        Translated number: 4441234
Original number type: none      Translated number type: none
Original number plan: none      Translated number plan: none

kearly01#test voice translation-rule 1 7771234 
7771234 Didn't match with any of rules

kearly01#test voice translation-rule 1 7771234 type national plan isdn
Matched with rule 2
Original number: 7771234        Translated number: 8881234
Original number type: national  Translated number type: unknown
Original number plan: isdn      Translated number plan: isdn

The translation rule is used with this test:

Note: The  show voice translation-rule  and  show voice translation-profile commands can also be useful.

kearly01#show voice translation-rule 1 
Translation-rule tag: 1

        Rule 1:
        Match pattern: ^555\(....\)
        Replace pattern: 444\1
        Match type: none                Replace type: none
        Match plan: none                Replace plan: none

        Rule 2:
        Match pattern: 777
        Replace pattern: 888
        Match type: national            Replace type: unknown
        Match plan: any                 Replace plan: isdn

kearly01#show voice translation-profile 
Translation Profile: mytranslation
        Rule for Calling number: 
        Rule for Called number: 1
        Rule for Redirect number:

Troubleshoot

This section provides information you can use to troubleshoot your configuration.

Note: Refer to Important Information on Debug Commands before you issue  debug commands.

WIth the same translation rule, usedebug voice translationand then run thetest voice translation-rulecommand again.

kearly01#test voice translation-rule 1 7771234                        
7771234 Didn't match with any of rules

*Apr  4 14:44:31.665: //-1/xxxxxxxxxxxx/RXRULE/regxrule_match: 
No match; number=7771234 rule precedence=1

*Apr  4 14:44:31.665: //-1/xxxxxxxxxxxx/RXRULE/regxrule_match: 
Error: type didn't match; in.type=0x9 rule.type = 0x2

*Apr  4 14:44:31.665: //-1/xxxxxxxxxxxx/RXRULE/regxrule_match: 
No match; number=7771234 rule precedence=1

*Apr  4 14:44:31.665: //-1/xxxxxxxxxxxx/RXRULE/regxrule_match: 
Error: type didn't match; in.type=0x9 rule.type = 0x2test voice trans

The debugs show the rule does not match. Once you change the type and plan, it matches.

kearly01#test voice translation-rule 1 7771234 type national plan isdn
Matched with rule 2
Original number: 7771234        Translated number: 8881234
Original number type: national  Translated number type: unknown
Original number plan: isdn      Translated number plan: isdn

*Apr  4 14:44:51.665: //-1/xxxxxxxxxxxx/RXRULE/regxrule_match:
No match; number=7771234 rule precedence=1

*Apr  4 14:44:51.665: //-1/xxxxxxxxxxxx/RXRULE/regxrule_match: 
No match; number=7771234 rule precedence=1

*Apr  4 14:44:51.669: //-1/xxxxxxxxxxxx/RXRULE/regxrule_match:
 No match; number=7771234 rule precedence=1

*Apr  4 14:44:51.669: //-1/xxxxxxxxxxxx/RXRULE/sed_subst: 
Successful substitution; pattern=7771234 matchPattern=777 
replacePattern=888 replaced pattern=8881234

*Apr  4 14:44:51.669: //-1/xxxxxxxxxxxx/RXRULE/regxrule_subst_num_type: 
Match Type = national, Replace Type = unknown Input Type = national

*Apr  4 14:44:51.669: //-1/xxxxxxxxxxxx/RXRULE/regxrule_subst_num_plan: 
Match Plan = any, Replace Plan = isdn Input Plan = isdn

Related Information

• Voice Translation Rules in Media Gateways
• Troubleshooting Cisco IP Telephony
• Cisco Technical Support & Downloads