Difference between revisions of "M4 Dial Peers"

From Kolmisoft Wiki
Jump to navigationJump to search
m
 
(35 intermediate revisions by 8 users not shown)
Line 1: Line 1:
=Usage=
Go to '''Routing -> Dial Peers'''
<br><br>
[[File:Dial peers menu.png]]
[[File:M2_Dial_peers_list.png]]
<br><br>
You can Refine the search results by providing a Dial Peer Name.
<br><br>
[[File:M2 Dial peers.png]]
<br><br>
=Description=
=Description=


Dial Peer is a logical routing entity (group of [[M2 Termination Points | Termination Points]] with predefined rules) which allows to control how calls should be routed.
Dial Peer is a logical routing entity (group of [[M4 Termination Points | Termination Points]] with predefined rules) that allows control of how calls should be routed.


It consists of several rules and includes [[M2 Termination Points | Termination Points]] over which calls should be routed.
It consists of several rules and includes [[M4 Termination Points | Termination Points]] over which calls should be routed.


Dial Peers are grouped together into [[M2 Routing Groups | Routing Groups]] which then are assigned to [[M2 Origination Points | Origination Points]].
Dial Peers are grouped together into [[M4 Routing Groups | Routing Groups]] which then are assigned to [[M4 Origination Points | Origination Points]].


In order to temporary remove a Dial Peer it can be set as inactive so it won't be used in determining a call's route.
In order to temporarily remove a Dial Peer it can be set as inactive so it won't be used in determining a call's route.


<br><br>
<br><br>
= General settings =
[[File:Dial_peers_general.png]]
<br>
* '''Active''' - enable or disable Dial Peer.
* '''Name''' - Dial Peer name.
* '''Stop Hunting''' - if the call is routed through Dial Peer which has '''Stop Hunting''' enabled, then routing stops when all Termination Points in this Dial Peer fail (unless there are Dial Peers from Failover Routing Group, see '''Skip Failover Routing Group'''). If Stop Hunting is disabled, then the call can be routed through the next Dial Peer.
* '''Skip Failover Routing Group''' - if call is routed through Dial Peer which has '''Skip Failover Routing Group''' enabled, then Failover Routing Group will be skipped.
* '''Minimal Rate Margin''' - use only those Termination Points which generate profit (per minute) equal to or higher than defined in this field. For example, if the user pays you 1 euro per minute when calling a specific destination and the Minimal Rate Margin is set to 0.3, then only Termination Points that have a rate of 0.7 euro/min or cheaper will be used. The user pays you 1 euro, your self-cost is 0.7 euro and you get 0.3 euro profit. Termination Points with a rate higher than 0.7 euro/min would be skipped, because profit is less than 0.3 euro/min. The default value is 0, which means that you allow your minimal profit for calls to be 0 (the user pays you the same as you pay your provider). If the value is negative, a loss is possible.<br/>
* '''Minimal Rate Margin Percent''' - same as 'Minimal Rate Margin' but instead of absolute values, you can use percentages. For example, if you pay your provider 1 EUR/min and your Minimal Rate Margin Percent is set to 50%, then only calls with a user rate equal to or higher than 1.5 EUR/min are allowed to call. After 1 min of the call, you will pay 1 EUR to your provider, and the user will pay you 1.5 EUR. Your profit will be 0.5 EUR which is 50% more than what you paid to your provider. If your Minimal Rate Margin is -30%, then you allow some losses in your calls. If you pay 1 EUR to your provider after 1 minute of the call, then the user should pay you 0.7 EUR or more. You will pay 1 EUR and you will get 0.7 EUR which is 30% less than what you paid.<br>
* '''No Follow''' - if checked, then only one Termination Point in this Dial Peer will be used. If the call fails, then other Termination Points in this Dial Peer will not be used. '''Only usable when TP priority is set to percent'''.
* '''TP Priority''' - select how Terminators are sorted inside Dial Peer. Note that Originator's Routing algorithm has higher sorting priority. For example, if the Originator's Routing algorithm is by '''price''' and Dial Peer TP Priority is by '''weight''', then firstly Terminators in Dial Peer will be sorted by '''price''' and if two or more Terminators have the same price, then these Terminators will be reordered by '''weight''' (Dial Peer Priority).
* '''Secondary TP Priority''' - works similarly to TP Priority. For example, if the Originator's Routing algorithm is by '''price''', Dial Peer TP Priority is by '''weight''' and Secondary TP Priority is '''percent''', then firstly Terminators in Dial Peer will be sorted by '''price''' and if two or more Terminators have the same price, then these Terminators will be reordered by '''weight''' (Dial Peer Priority) if two or more Terminators have the same weight, then Terminators will be reordered by '''percent''' (Secondary TP Priority). If selected '''none''', then secondary sorting will not be applied.
* '''Call Limit''' - allows limiting calls for this Dial Peer. Leave 0 for unlimited.
<br>


= Routing by Destination/Number B =
= Routing by Destination/Number B =
Line 17: Line 48:


Destination by Regexp - describes which destinations should be allowed<br/>
Destination by Regexp - describes which destinations should be allowed<br/>
Destination by Tariff - describes which destinations should be allowed for selected Tariff and matched by Destinations Mask (which is equivalent to SQL LIKE function)<br/>
Destination by Tariff - describes which destinations should be allowed from selected Tariff and matched by Destinations Mask (which is equivalent to SQL LIKE function). If you want to match all destinations in the selected Tariff, then just enter % character in Destination Mask<br/>
NOTE: This Tariff is only used to select prefixes in the Routing. This Tariff is not used in Billing.<br>
Destination deny regexp - describes which destinations should be denied
Destination deny regexp - describes which destinations should be denied


Line 30: Line 62:


= Assigning Termination Points =
= Assigning Termination Points =
adad
Routing > Dial Peers > pressing on the button in the TP List column
<br/><br/>
[[File:M2_assigned_termination_points.png]]
<br/><br/>
Termination Point can be assigned to Dial Peer by pressing on ASSIGN TERMINATION POINT button (1), selecting Termination Point from the Termination Points drop-down list (2), setting Percent (3), Weight (4), and pressing the ASSIGN button (5).<br/>
Active in Dial Peer column (6) show if Termination Point is active in current Dial Peer.<br/>
Pressing on the Termination Points name (7) redirects to the Termination Points edit page.<br/>
Pressing on '''Percent''' (8) allows it to be '''updated''' (to save it just press anywhere else).<br/>
Pressing on '''Weight''' (9) allows it to be '''updated''' (to save it just press anywhere else).<br/>
REMOVE button (10) removes Dial Peers's relationship with Termination Point (not the Termination Point)<br/>
Set CPS (11) and Call Limit (12) for specific Termination Points in this DP. Leave 0 for unlimited.<br/>
Active column (13) shows if Termination Point is active. Termination Point status can be changed on the Termination Points edit page.


= See also=  
= See also=  
* [[M2 Regexp Examples|Regexp Examples]]
* [[M4 Routing Logic|M4 Routing Logic]]
* [[M4 Regexp Examples|Regexp Examples]]
* [[M4 Disconnect Code Changes|Disconnect Code Changes]]
* [[M4 Routing according to destination and callerid numbers]]

Latest revision as of 10:52, 29 November 2022

Usage

Go to Routing -> Dial Peers

Dial peers menu.png

M2 Dial peers list.png

You can Refine the search results by providing a Dial Peer Name.

M2 Dial peers.png

Description

Dial Peer is a logical routing entity (group of Termination Points with predefined rules) that allows control of how calls should be routed.

It consists of several rules and includes Termination Points over which calls should be routed.

Dial Peers are grouped together into Routing Groups which then are assigned to Origination Points.

In order to temporarily remove a Dial Peer it can be set as inactive so it won't be used in determining a call's route.



General settings

Dial peers general.png


  • Active - enable or disable Dial Peer.
  • Name - Dial Peer name.
  • Stop Hunting - if the call is routed through Dial Peer which has Stop Hunting enabled, then routing stops when all Termination Points in this Dial Peer fail (unless there are Dial Peers from Failover Routing Group, see Skip Failover Routing Group). If Stop Hunting is disabled, then the call can be routed through the next Dial Peer.
  • Skip Failover Routing Group - if call is routed through Dial Peer which has Skip Failover Routing Group enabled, then Failover Routing Group will be skipped.
  • Minimal Rate Margin - use only those Termination Points which generate profit (per minute) equal to or higher than defined in this field. For example, if the user pays you 1 euro per minute when calling a specific destination and the Minimal Rate Margin is set to 0.3, then only Termination Points that have a rate of 0.7 euro/min or cheaper will be used. The user pays you 1 euro, your self-cost is 0.7 euro and you get 0.3 euro profit. Termination Points with a rate higher than 0.7 euro/min would be skipped, because profit is less than 0.3 euro/min. The default value is 0, which means that you allow your minimal profit for calls to be 0 (the user pays you the same as you pay your provider). If the value is negative, a loss is possible.
  • Minimal Rate Margin Percent - same as 'Minimal Rate Margin' but instead of absolute values, you can use percentages. For example, if you pay your provider 1 EUR/min and your Minimal Rate Margin Percent is set to 50%, then only calls with a user rate equal to or higher than 1.5 EUR/min are allowed to call. After 1 min of the call, you will pay 1 EUR to your provider, and the user will pay you 1.5 EUR. Your profit will be 0.5 EUR which is 50% more than what you paid to your provider. If your Minimal Rate Margin is -30%, then you allow some losses in your calls. If you pay 1 EUR to your provider after 1 minute of the call, then the user should pay you 0.7 EUR or more. You will pay 1 EUR and you will get 0.7 EUR which is 30% less than what you paid.
  • No Follow - if checked, then only one Termination Point in this Dial Peer will be used. If the call fails, then other Termination Points in this Dial Peer will not be used. Only usable when TP priority is set to percent.
  • TP Priority - select how Terminators are sorted inside Dial Peer. Note that Originator's Routing algorithm has higher sorting priority. For example, if the Originator's Routing algorithm is by price and Dial Peer TP Priority is by weight, then firstly Terminators in Dial Peer will be sorted by price and if two or more Terminators have the same price, then these Terminators will be reordered by weight (Dial Peer Priority).
  • Secondary TP Priority - works similarly to TP Priority. For example, if the Originator's Routing algorithm is by price, Dial Peer TP Priority is by weight and Secondary TP Priority is percent, then firstly Terminators in Dial Peer will be sorted by price and if two or more Terminators have the same price, then these Terminators will be reordered by weight (Dial Peer Priority) if two or more Terminators have the same weight, then Terminators will be reordered by percent (Secondary TP Priority). If selected none, then secondary sorting will not be applied.
  • Call Limit - allows limiting calls for this Dial Peer. Leave 0 for unlimited.


Routing by Destination/Number B

M2 dp destination by tariff.png


Destination by Regexp - describes which destinations should be allowed
Destination by Tariff - describes which destinations should be allowed from selected Tariff and matched by Destinations Mask (which is equivalent to SQL LIKE function). If you want to match all destinations in the selected Tariff, then just enter % character in Destination Mask
NOTE: This Tariff is only used to select prefixes in the Routing. This Tariff is not used in Billing.
Destination deny regexp - describes which destinations should be denied



Routing by Source/CallerID/Number A

Source regexp - describes which Source/CallerID/Number A should be allowed
Source deny regexp - which should be denied



Assigning Termination Points

Routing > Dial Peers > pressing on the button in the TP List column

M2 assigned termination points.png

Termination Point can be assigned to Dial Peer by pressing on ASSIGN TERMINATION POINT button (1), selecting Termination Point from the Termination Points drop-down list (2), setting Percent (3), Weight (4), and pressing the ASSIGN button (5).
Active in Dial Peer column (6) show if Termination Point is active in current Dial Peer.
Pressing on the Termination Points name (7) redirects to the Termination Points edit page.
Pressing on Percent (8) allows it to be updated (to save it just press anywhere else).
Pressing on Weight (9) allows it to be updated (to save it just press anywhere else).
REMOVE button (10) removes Dial Peers's relationship with Termination Point (not the Termination Point)
Set CPS (11) and Call Limit (12) for specific Termination Points in this DP. Leave 0 for unlimited.
Active column (13) shows if Termination Point is active. Termination Point status can be changed on the Termination Points edit page.

See also