CCME How To - Dial-peer digit manipulation using Translation Profiles

To learn more about this tutorial contact us [email protected]

or visit our site www.ipmax.it/support WWW.IPMAX.IT

Dial Peers

Digit manipulation

using

Translation Profiles

CISCO

Call Manager Express 8.6

mailto:[email protected]?subject=General Information

http://www.ipmax.it/Section/Index/Supporto/07?lang=EN

http://www.ipmax.it/




1. Application enviroment

Here are some of the most common reasons for which it is required the digits manipulation:

• To translate a full PSTN number (eg an10 digits E.164 number) to an extension shorter so that the internal and external calls can be

made to a single extension.

• To ensure that users dial an access code for PSTN calls (the classic 0). Then this access code must be removed before forwarding

the call over the PSTN.

• Block calls to specific numbers.

• To redirect calls to specific numbers.

The CCME has several methods to manipulate digits. The next section will cover the digit manipulation by the command:

translation-profile.

Dial-Peer digit manipulation using Translation Profiles

Cisco Call manager Express 8.6

CCME

01






Translation profiles work similarly to the access control lists (ACLs) on a router.

• Your first task is to create the voice-translation rule with a unique tag for identification.

• Every voice translation-rule can contain up to 15 rules.

• The next step is to create a voice-translation profile and set the rules to be used for the numbers called or callers.

• Finally, the voice translation-profile is applied to the dial-peer PSTN or VoIP. If desired, it can also be set globally on the voice

gateway. This profile can be applied to incoming or outgoing on the dial-peer.

CCME

02



1. Application enviroment






• Translation profiles are extremely flexible.

• They can be used to provide more granular control of scenarios change compared to other tools of manipulation of figures.

03

2. Implementation

The following example creates the translation rule 1:

CME#

CME#configure terminal

Enter configuration commands, one per line. End with CNTL/Z

CME(config)#voice translation-rule 1

CME(cfg-translation-rule)#

At this point you are in cfg-translation-rule mod








I make a premise

We subscribed with our telephone operator, DID (Direc Inward Dial) for the numbers:

02.92.90.91-00 02.92.90.91-99

Here in Italy are permitted numbers with variable length.

I.e. the numbers: 2.92.90.91.7 & 2.92.90.91.07 are identical. All indicate the extension 07.

The correct syntax of a translation rule is:

rule <1-15> / numeric string to be checked / / numeric string to replace /

The following rules allow you to convert penultimate and / or the last digit of a call from PSTN, in a new three digit number, in the range

1xx.

04

CME(cfg-translation-rule)# rule 5 /^2929091$[0-9]$$/ /10\1/

CME(cfg-translation-rule)# rule 10 /^2929091$.*$$/ /1\1/

CME(cfg-translation-rule)# exit

CME(config)# exit

CME#



2. Implementation






To be clear, we test the voice translation-rule 1 with the command:

test voice translation-rule <1-15> <number to be tested>

05

CME#test voice translation-rule 1 29290911 Matched with rule 5

Original number: 29290911 Translated number: 101

Original number type: none Translated number type: none

Original number plan: none Translated number plan: none









Depending on the length of the called number the voice translation-rule 1 will pass the rule between 5 and 10, while maintaining the

conversion to three digits for internal numbering.



2. Implementation






To complete the configuration, the voice translation-rule 1 must be activated within a translation-profile as follows:

06

CME(config)# voice translation-profile PSTN-IN

CME(cfg-translation-profile)# translate called 1

CME(cfg-translation-profile)# exit

CME(config)# exit

CME#

Above the translation rule 1 is activated for incoming calls (parameter "called") in the translation-profile tagged PSTN-IN.

CME(config)# dial-peer voice 10 pots

CME(config-dial-peer)# translation-profile incoming PSTN-IN

CME(config-dial-peer)# incoming called-number 292909T

CME(config-dial-peer)# direct-inward-dial

CME(config-dial-peer)# exit

CME(config)# exit

CME#

The dial-peer 10 will activate whenever the CCME receive an incoming call ("incoming") containing the numbers 292909nnx.

Finally we are able to receive calls on our CCME and then deliver the call properly inward desired!

Now the translation profile must be associated with a POTS dial-peer. Here 10.



2. Implementation






The following commands are used to start the debug and verify the correct procedures:

CME#

CME#debug isdn q931

debug isdn q931 is ON.

CME#

CME#debug voice translation

VoIP Translation Rule debugging is enabled

CME#

07



3. Verify






02

We make a call from PSTN to our CCME.

3218774532 is calling our CCME number 292909123

CME#

Sep 22 18:43:07.171: ISDN BR1/1/0 Q931: RX <- SETUP pd = 8 callref = 0x04

Bearer Capability i = 0x8090A3

Standard = CCITT

Transfer Capability = Speech

Transfer Mode = Circuit

Transfer Rate = 64 kbit/s

Channel ID i = 0x81

Preferred, B1

Calling Party Number i = 0x0183, '3218774532'

Plan:ISDN, Type:Unknown

Called Party Number i = 0xA1, '292909123'

Plan:ISDN, Type:National

Sending Complete

08



3. Verify






02

At this point the CCME identifies the correct rule for converting the called number from the PSTN.

The CCME thus identifies the rule 10 for proper conversion, while the rule 5 does not pass verification

Then replacement operations are made as specified in rule 10

CME#

Sep 22 …: //-1/x…x/RXRULE/regxrule_profile_match_internal: Matched with rule 10 in ruleset 1

Sep 22 …: //-1/x…x/RXRULE/regxrule_match: No match; number=292909123 rule precedence=5

Sep 22 …: //-1/x…x/RXRULE/sed_subst: Successful substitution; pattern=292909123 matchPattern=^2929091(.*)$

replacePattern=1\1 replaced pattern=123

Sep 22 …: //-1/x…x/RXRULE/regxrule_subst_num_type: Match Type = none, Replace Type = none Input Type = national

Sep 22 …: //-1/x…x/RXRULE/regxrule_subst_num_plan: Match Plan = none, Replace Plan = none Input Plan = isdn

CME#

09



3. Verify






02

Here's the sequence of call progress: in progress, ringing, off-hook, and finally, the phone conversation with extension123!

CME#

Sep 22 18:43:07.235: ISDN BR1/1/0 Q931: TX -> CALL_PROC pd = 8 callref = 0x84

Channel ID i = 0x89

Exclusive, B1

Sep 22 18:43:07.335: ISDN BR1/1/0 Q931: TX -> ALERTING pd = 8 callref = 0x84

Facility i = 0x9FAA068001018201018B0100A109020204B30201018000

Protocol Profile = Networking Extensions

CME#

CME#Sep 22 18:43:37.427: ISDN BR1/1/0 Q931: TX -> CONNECT pd = 8 callref = 0x84

Channel ID i = 0x89

Exclusive, B1

Sep 22 18:43:37.515: ISDN BR1/1/0 Q931: RX <- CONNECT_ACK pd = 8 callref = 0x04

CME#

Sep 22 18:43:37.515: %ISDN-6-CONNECT: Interface BRI1/1/0:1 is now connected to 123 N/A

CME#s

10



3. Verify






More Needs?

Services and

Solutions Products

Remote

IpService Security

Via Ponchielli, 4

20063 Cernusco sul Naviglio (MI) –

Italy

+39 02 9290 9171

[email protected]

About us

IPMAX is the ideal partner for companies

seeking quality in products and services.

IPMAX guarantees method and professionalism

to support its customers in selecting technologies

with the best quality / price ratio, in the design,

installation, commissioning and operation




http://www.ipmax.it/Section/Index/Solutions_AND_Services/03

http://www.ipmax.it/Prodotti/Index2/Intro/Intro/02

http://www.ipmax.it/Section/Index/Support/07

http://www.ipmax.it/Prodotti/Detail/SECURITY/03/509


Technology

CCME How To - Dial-peer digit manipulation using Translation Profiles