Tmedia Routing

Revision as of 09:42, 13 February 2014

Static routing table

Gateway -> Routes

Basic route matching

The static routing table uses the parameters from the incoming call to find a route and make the routing decision. These parameters are called incoming call attributes. Three parameters are verified:
A route will match an incoming call if all the route matching parameters above are met.

Multiple routes may match for a call.

The following criteria are available for basic route matching:

• Called number
• Calling number
• Incoming Network Access Point (NAP)

Calling / called number matching

Calling / called number matching works as follows:

• Field can be empty: this means any number will match
• Field can be a specific number: this means the exact number must match
• Field can be a regular expression match:

    Number Routing filter example:
     Ex. /^1?450[0-9]{7}$/
     This number must match an optional 1, followed by 450, then 7 digits

NAP matching

The Network Access Point can be SS7, ISDN, CAS or SIP.

Basic (per-route) call attributes remapping

Once the route(s) have been chosen, some call parameters can be modified using the parameters of the route:

Outgoing call parameters remapping

• Remapped Called Number: New called number used on the outgoing calls
• Remapped Calling Number: New calling number used on the outgoing calls
• Remapped NAP: determines on which Network Access Point (NAP) the outgoing calls are sent.
• Outgoing call remapped Profile: Select the profile to use with the outgoing call when this route is used, otherwise NAP's default profile is used.

Incoming call parameters remapping

Some parameters of the incoming call can also be modified:

• Incoming call remapped Profile:Select the profile to use with the incoming call when this route is used, otherwise NAP's default profile is used. (Release 2.7.102 and above)

Calling / called number remapping options

Calling / called number remapping works as follows:

• Field can be empty: this means the incoming called/calling is used for the outgoing call.
• Field can be a specific number: this means this number will be used in the called/calling fields.
• Field can be a regular expression: It requires a replace function to be used to replace the incoming number.
  

    For example, post routing translation (remap)

     Ex. /^450([0-9]*)$/\514\2

     This regular expression replaces 450 with 514

For complete example, checkout How To Use Regular Expressions

Multiple routes matching

The parameters above (both for incoming and outgoing call) are independent on each route.
If there is more than one route, the first route will be randomly chosen from the list of possible routes.

Ordering the routes

It is possible to prioritize the routes using the Priority and Load Sharing to Routing Script.

Route retry

If multiple route match for a call, call retry may be done on subsequent routes upon failure making outgoing call on a route. For more information about route retry, please see refer to the following page: Route Retry.

Routes limitation

Up to 2000 routes can be entered in the static routing table.

Note that when the number of routes is growing large, it may be a sign that more advanced routing should be used.

For more routes than this, please check out Label Routing or contact TelcoBridges Support

Exporting / importing routes

You can import or export static routing table using the web portal. Go to:

Gateway -> Routes -> Route table actions -> Export Static Routes 

or

Gateway -> Routes -> Route table actions -> Import Static Routes 

This is the default configuration of the Media Gateway

Standard Scripts

Gateway -> Routing scripts 

Standard scripts are used to modify the behavior of the static routing.  It allows to prioritize routes, load share amongst multiple endpoints, or modify some call parameters. It can be enabled on any system in just a few steps. Here is a list of Scripts supported today:

• Simple routing (simple_routing.rb): Script used for the static routing table
• NAP priority routing (nap_priority_routing.rb): This script routes calls according to a priority setting of outgoing NAPs. Each NAP has its own priority setting. The [:prio] field column need to be added in the NAPs page. A smaller [:prio] value has more priority. If more than 1 route matches, the route with the lowest NAP priority will be selected first. There is an improvement to this script using the nap_group_weight_load_balancer.rb filter.
• Route priority routing (route_priority_routing.rb): This script routes calls according to a priority setting of Routes. Each Route has its own priority setting. The [:prio] field column need to be added in each route. A smaller [:prio] value has more priority. If more than 1 route matches, the one with the lowest priority value will be selected first.
  
• Percentage routing (percentage_routing.rb): This script allows to do load sharing amongst multiple NAPs. Each NAP has its own load sharing setting. The [:percent_target] field column need to be added in the NAPs page. This is useful to envenly route call to different providers. The calculation of percentage for each nap is done by using the cumulative number of outgoing calls made to each nap. There is an improvement to this script using the nap_group_weight_load_balancer.rb filter.
• ASR routing (asr_routing.rb): This script routes calls according to the ASR values of the destination naps. This kind of routing will try to improve overall system ASR by always using the best naps. It will also help client perception by cleanly dropping calls that would almost certainly fail anyway.
• Nature of Address and Numbering plan indicator remapping (noa_npi_remap.rb): Allows to modify the NOA and NPI values on outgoing calls.
• Least Cost Routing (least_cost_routing.rb): This script routes calls according to the cost values (which may depend on the time) of the routes. This is useful for cases when a route's popularity (cost) depends on the time of the day. This is done by adding different columns to the static routing tables (for example [:cost_0_6]) and filling them up with values for each routes.

You can learn how to setup Standard Scripts in your gateway by following these steps: How to Setup Standard Scripts

Other standard routing scripts implement Filters and are covered in the next section.

Filters

Gateway -> Routing scripts 

Adds functionnalities to standard scripts. Filters can be added to any standard script in a few steps. For example, you may want to remove the '1' prefix for uniformed routing, select the SIP Request URI to route the call instead of the called number, etc.

Two types of filter exist:

• Before filter: Adds pre-processing on incoming parameters
• After filter: Adds post-processing on outgoing parameters

Filter Scripts examples:

• Request-URI routing (ruri.rb): Will route the call on SIP RURI instead of the to: field
• Modify the Nature of Address (noa_npi_remap.rb): We can use this to change the NOA to national or international
• Remove Loop (FilterRemoveLoop.rb): Will prevent calls from being routed back to the sender
• Load sharing on NAP groups or on route groups (nap_group_weight_retry_with_overload.rb): This is a powerful script that allows to regroup NAPs of the same kind, distribute load among them and prioritize one group versus another.  Alternatively, you can do the same on routes. You need to add two columns to the NAPs (or the routes), one called "group" and one called "weight". Groups of lower value will have a higher priority (group=0 has more priority than group=10). The calls will be distributed according to the weight value. To have an equal number of calls on each destination, use the same weight value (weight=10). See Adding Load Sharing to Routing Script
  
• Black and White listing (black_white_listing.rb): With this script, any called or calling number prefix can be blacklisted or whitelisted. This script can be assigned globally, or per NAP. It reads a .csv file which has the called and calling number list. See Adding White or Black listing to Routing Script

Here's how to add Filter to normal scripts: How to setup Filters

Label routing

Gateway -> Routing scripts
Gateway -> FileDb
Gateway -> Routesets 

Label routing was created because in some cases, there can be no regular expressions on the called number to define a route.

Problem: Having thousands of destination numbers (N), and possibly one route per number per Network Provider (M), resulting in N*M routes
Solution: Create labels for each groups of numbers (L) and let the system deduce the route, resulting in L*M routes, where L < N

A Label is a virtual group of destination numbers. This virtual group has a list of numbers assigned to it in a CSV file.
This process does the routing in 2 stages:
1st stage - Find a Label: Find longest prefix match entry for the called number. This leads to only one destination Label. This is the Digitmap file.
2nd stage - Find the NAPs serving a Label: All routes tied to this Label are eligible for routing the call. This is the routeset definition file.

What are the advantages compared to static routing?

• Can have thousands of numbers
• It has a non linear search algorithms so there is no overhead of having large amount of numbers. Label routing was tested with more than 100,000 numbers
• Variables can be added to the routeset definition file to use other filter scripts and have even more flexibility.

Example usage:

• NPA-NXX routing
• Blacklisting
• Tandem switch

See here for complete details: Label routing and Adding Label Routing to any Routing Script

Custom Routing Scripts

Gateway -> Routing scripts 

Customers can create their own routing functions using a Scriptable Routing Engine based on ruby. These functions can be imported and exported from the Web portal.
These scripts can do complex routing algorithms and post routing translation, as well as other advanced functions. It is also possible to modify standard Scripts, or filters, to achieve more complex scenarios
The functions have control over many call parameters such as:

• Calling
• Called
• Nature of Address
• Calling Presentation
• Calling Screening
• Redirecting Number
• Original Called Number, etc.
  

The complete list is in the Routing Script Tutorial

Custom routing script are kept on Software upgrades. Versionning of routing scripts needs to be handled by the operator of the unit. The new scripts (with the same names, but a new version) can be manually replaced directly in the routing script page.
It is possible to test routing scripts directly from the web portal before activating them in a live system.
For complete details check the Scriptable Routing Engine

Playing prompts

It is possible to use routing scripts to ask for prompts playback at various call states. Please check Playing prompts announcements or tones.

Recording calls

It is possible to use routing scripts to ask for recording incoming and/or outgoing call legs to audio files. Please check Recording Calls.

Route retry

The routing engine returns all matching routes to the system. The TMG-CONTROL then generates an outgoing call using the first route of the list. If the call fails, the TMG-CONTROL may or may not generate another call according to the error code received.

The route retry will proceed with another route if the return code is:

• Service unavailable
• Circuit not available
• Etc.

The route retry will not proceed with another route if the return code is:

• User busy
• Unallocated number
• Etc.

It is possible to modify the route retry sequence (continue or discontinue) to handle unsuccessful routes, please refer to the nap profile. For more details see the route retry page.
These parameters can be modified here:

Profiles -> default [Edit] -> Edit Reason Cause mapping 

Route retry is enabled by default. Timers and conditions on route retry can be adjusted from the configuration:

Gateway -> Configurations -> Advanced 

NOTE:The route retry feature is available for other types of routing as well.

For more details, please check Route Retry page

Related actions

Refer to the appropriate Toolpack release:

• Web Portal v2.7: Routes Configuration
• Web Portal v2.6: Routes Configuration