Difference between revisions of "M4 Termination Points"

From Kolmisoft Wiki
Jump to navigationJump to search
Line 34: Line 34:




=== CallerID ===
== CallerID ==


* '''Name''' - set name part for CallerID.<br>
* '''Name''' - set name part for CallerID.<br>

Revision as of 10:34, 11 October 2019

Description

Termination Point is connection to some final entity (device/line/trunk/provider/supplier/etc) where call will be terminated.

Call comes from Origination Points and goes to Termination Point.

Termination Points are assigned to Dial Peers.

General

  • Progress Timeout – allows to limit the maximum time we will wait before we get media (whether it's early media, ringing or answer). Leave 0 for unlimited.
  • Ringing Timeout – allows to limit the ringing duration in seconds. Leave 0 for unlimited. Minimal value is 10 seconds.
  • Call Timeout – allows to limit answered call duration. Leave 0 for unlimited.

Termination Point Settings

TerminationPoint.jpg

  • Act as Termination Point - turns on/turns of Termination Point. If selected No and saved, all settings of Termination Point will be erased.
  • Active - activates/deactivates Termination Point.
  • Source Transformation - special Source Transformation rules used to modify Source number.
  • Destination Transformation - special Destination Transformation rules used to modify outgoing number.
  • Tariff - Tariff used for Termination Point accounting.
  • Capacity - limits the number of concurrent calls to this termination point.
  • Source (CallerID) Allow - regular expression (regexp) for CallerIDs that are allowed to go through this termination point (use regexp .* if you want to allow all CallerIDs to go through this termination point).
  • Source (CallerID) Deny - regular expression (regexp) for CallerIDs that are NOT allowed to go through this termination point (leave empty if you do not want to disallow any CallerIDs).
  • Register - should we register the provider?
  • Login/Username - username if your provider asks for it.
  • Password - password used for authentication by your provider.

Codecs

Define which Codecs will be offered when dialing Terminator (in the order they are listed).

  • Enforce leg A Codecs to leg B - if this option is enabled in Terminator settings, M2 will ignore selected Terminator Codecs and will offer the same Codecs (in same order) from leg A to leg B. More information can be found here.


CallerID

  • Name - set name part for CallerID.
  • Number - set number part for CallerID.
  • Random Number from Number Pool - set random number from Number Pool. Only number part for CallerID is set.
    • Random - Send random CallerID from Number Pool.
    • Pseudorandom with Deviation - Range can vary from 0 to 9999999. If 0 is chosen, then all numbers will be chosen same amount of times. If 9999999 is set, then numbers will be completely random.

Advanced Settings

  • Grace Time - Grace time in seconds.
  • Custom SIP Header - adds custom header to SIP request. Format is header: value (for example x-My-Custom-Header: my value). Do not omit space after colon character.
  • Limit up to X Calls, during Y seconds - allows to control Calls per Second (CPS).
  • Disable Q.850 Reason - by default M2 returns Q.850 Reason header in SIP responses to Originator. This can be disabled by setting this option to "yes".
  • Forward RPID - by default M2 forwards RPID header from Originator to Terminator. This can be disabled by setting this option to "no".
  • Forward PAI - by default M2 forwards PAI header from Originator to Terminator. This can be disabled by setting this option to "no".
  • Bypass Media - when set, the media (RTP) from the originating endpoint is sent directly to the destination endpoint and vice versa. The signaling (SIP) for both endpoints still goes through M2, but the media is point-to-point.

Advanced Termination Point Settings

  • Interpret NO ANSWER as FAILED - makes NO ANSWER calls interpretation as FAILED.
  • Interpret BUSY as FAILED - makes BUSY calls interpretation as FAILED
  • Periodic check - if enabled, periodic SIP OPTIONS requests will be sent to Termination Point to check if it is reachable. If Periodic Check is enabled and Termination Point does not respond to OPTIONS request then Termination Point will be marked as unreachable and will be skipped when making calls. Once Termination Point starts to respond to OPTIONS request it will be marked as reachable and calls will be routed through this Termination Point. Termination Points are checked every 5 minutes.
  • Sticky Contact – if this option is enabled, M2 uses only first SIP Contact header received from Termination Point. Sometimes Terminators change Contact header in the middle of SIP dialog and in some cases this may lead to unpredicted behavior (for example Terminator changes Contact header to wrong address and calls do not terminate properly). Use this option only if you know what you are doing. This option applies only to Termination points.
  • Disable SIP URI encoding - enable or disable SIP URI encoding. If enabled, then some characters in SIP URI (Invite, To) are encoded in percent-encoding. For example if you send number 123#99999, encoded SIP URI will be sent to Provider as 123%2399999 (note that # is replaced by %23). If your Provider does not accept encoded SIP URI, you may disable this feature and characters like # will not be encoded.
  • Use PAI if CallerID is anonymous - if enabled, when Originator is sending anonymous CallerID and PAI header is present, then number from PAI header is used as CallerID when sending call to Terminator.

Subnetting

It is possible to set subnetwork for Termination Point. Instead of IP address, you can set subnet in IP Address input field. Subnet should be written in CIDR notation (for example 192.168.0.1/28). When call is routed through Termination Point which uses subnet, random IP address from that subnet will be chosen for outgoing call.

M2 subnet value range is 4-30.

You can use online subnet calculator to check first and last usable IP address from given subnet.

IP range

If you need to set multiple IP addresses for single Termination Point and Subnetting does not meet your needs, then you can set IP ranges. Ranges are written in the following format:

xxx.xxx.xxx.xxx-yyy

Note that you can set range only for last octet in IP address.

When call is routed through Termination Point which uses IP range, random IP address from that range will be chosen for outgoing call. For example, if we have IP range 192.168.0.100-150, then random IP address from range 192.168.0.100 - 192.168.0.150 will be generated.

See also