|
|
|
@ -10,27 +10,33 @@ Daniel-Constantin Mierla
|
|
|
|
|
|
|
|
|
|
<miconda@gmail.com>
|
|
|
|
|
|
|
|
|
|
Edited by
|
|
|
|
|
|
|
|
|
|
Carsten Bock
|
|
|
|
|
|
|
|
|
|
ng-voice GmbH
|
|
|
|
|
|
|
|
|
|
Edited by
|
|
|
|
|
|
|
|
|
|
Olle E. Johansson
|
|
|
|
|
|
|
|
|
|
Edvina AB
|
|
|
|
|
|
|
|
|
|
Edited by
|
|
|
|
|
|
|
|
|
|
Alessandro Arrichiello
|
|
|
|
|
|
|
|
|
|
Hewlett Packard
|
|
|
|
|
|
|
|
|
|
Copyright © 2004 FhG FOKUS
|
|
|
|
|
Copyright © 2004 FhG FOKUS
|
|
|
|
|
|
|
|
|
|
Copyright © 2005 Voice Sistem
|
|
|
|
|
Copyright © 2005 Voice Sistem
|
|
|
|
|
|
|
|
|
|
Copyright © 2010 Daniel-Constantin Mierla (asipto.com)
|
|
|
|
|
Copyright © 2010 Daniel-Constantin Mierla (asipto.com)
|
|
|
|
|
|
|
|
|
|
Copyright © 2014 Olle E. Johansson, Edvina AB
|
|
|
|
|
Copyright © 2014 Olle E. Johansson, Edvina AB
|
|
|
|
|
|
|
|
|
|
Copyright © 2015 Alessandro Arrichiello, Hewlett Packard
|
|
|
|
|
Copyright © 2015 Alessandro Arrichiello, Hewlett Packard
|
|
|
|
|
__________________________________________________________________
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
@ -122,40 +128,40 @@ Alessandro Arrichiello
|
|
|
|
|
|
|
|
|
|
List of Examples
|
|
|
|
|
|
|
|
|
|
1.1. Set the "list_file" parameter
|
|
|
|
|
1.2. Set "db_url" parameter
|
|
|
|
|
1.3. Set "table_name" parameter
|
|
|
|
|
1.4. Set "setid_col" parameter
|
|
|
|
|
1.5. Set "destination_col" parameter
|
|
|
|
|
1.6. Set "flags_col" parameter
|
|
|
|
|
1.7. Set "priority_col" parameter
|
|
|
|
|
1.8. Set the "force_dst" parameter
|
|
|
|
|
1.9. Set the "flags" parameter
|
|
|
|
|
1.10. Set the "use_default" parameter
|
|
|
|
|
1.11. Set the "dst_avp" parameter
|
|
|
|
|
1.12. Set the "grp_avp" parameter
|
|
|
|
|
1.13. Set the "cnt_avp" parameter
|
|
|
|
|
1.14. Set the "dstid_avp" parameter
|
|
|
|
|
1.15. Set the "attrs_avp" parameter
|
|
|
|
|
1.16. Set the "sock_avp" parameter
|
|
|
|
|
1.1. Set the “list_file” parameter
|
|
|
|
|
1.2. Set “db_url” parameter
|
|
|
|
|
1.3. Set “table_name” parameter
|
|
|
|
|
1.4. Set “setid_col” parameter
|
|
|
|
|
1.5. Set “destination_col” parameter
|
|
|
|
|
1.6. Set “flags_col” parameter
|
|
|
|
|
1.7. Set “priority_col” parameter
|
|
|
|
|
1.8. Set the “force_dst” parameter
|
|
|
|
|
1.9. Set the “flags” parameter
|
|
|
|
|
1.10. Set the “use_default” parameter
|
|
|
|
|
1.11. Set the “dst_avp” parameter
|
|
|
|
|
1.12. Set the “grp_avp” parameter
|
|
|
|
|
1.13. Set the “cnt_avp” parameter
|
|
|
|
|
1.14. Set the “dstid_avp” parameter
|
|
|
|
|
1.15. Set the “attrs_avp” parameter
|
|
|
|
|
1.16. Set the “sock_avp” parameter
|
|
|
|
|
1.17. Use $avp(i:273) for hashing:
|
|
|
|
|
1.18. Use combination of PVs for hashing:
|
|
|
|
|
1.19. Set the "setid_pvname" parameter
|
|
|
|
|
1.20. Set the "attrs_pvname" parameter
|
|
|
|
|
1.21. Set the "ds_ping_method" parameter
|
|
|
|
|
1.22. Set the "ds_ping_from" parameter
|
|
|
|
|
1.23. Set the "ds_ping_interval" parameter
|
|
|
|
|
1.24. Set the "ds_probing_threshold" parameter
|
|
|
|
|
1.25. Set the "ds_inactive_threshold" parameter
|
|
|
|
|
1.26. Set the "ds_ping_reply_codes" parameter
|
|
|
|
|
1.27. Set the "ds_probing_mode" parameter
|
|
|
|
|
1.28. Set the "ds_hash_size" parameter
|
|
|
|
|
1.29. Set the "ds_hash_expire" parameter
|
|
|
|
|
1.30. Set the "ds_hash_initexpire" parameter
|
|
|
|
|
1.31. Set the "ds_hash_check_interval" parameter
|
|
|
|
|
1.32. Set the "outbound_proxy" parameter
|
|
|
|
|
1.33. Set the "ds_default_socket" parameter
|
|
|
|
|
1.34. Set the "ds_timer_mode" parameter
|
|
|
|
|
1.19. Set the “setid_pvname” parameter
|
|
|
|
|
1.20. Set the “attrs_pvname” parameter
|
|
|
|
|
1.21. Set the “ds_ping_method” parameter
|
|
|
|
|
1.22. Set the “ds_ping_from” parameter
|
|
|
|
|
1.23. Set the “ds_ping_interval” parameter
|
|
|
|
|
1.24. Set the “ds_probing_threshold” parameter
|
|
|
|
|
1.25. Set the “ds_inactive_threshold” parameter
|
|
|
|
|
1.26. Set the “ds_ping_reply_codes” parameter
|
|
|
|
|
1.27. Set the “ds_probing_mode” parameter
|
|
|
|
|
1.28. Set the “ds_hash_size” parameter
|
|
|
|
|
1.29. Set the “ds_hash_expire” parameter
|
|
|
|
|
1.30. Set the “ds_hash_initexpire” parameter
|
|
|
|
|
1.31. Set the “ds_hash_check_interval” parameter
|
|
|
|
|
1.32. Set the “outbound_proxy” parameter
|
|
|
|
|
1.33. Set the “ds_default_socket” parameter
|
|
|
|
|
1.34. Set the “ds_timer_mode” parameter
|
|
|
|
|
1.35. ds_select_dst usage
|
|
|
|
|
1.36. ds_mark_dst usage
|
|
|
|
|
1.37. ds_list_exist usage
|
|
|
|
@ -324,10 +330,10 @@ Chapter 1. Admin Guide
|
|
|
|
|
|
|
|
|
|
Path to the file with destination sets.
|
|
|
|
|
|
|
|
|
|
Default value is "/etc/kamailio/dispatcher.list" or
|
|
|
|
|
"/usr/local/etc/kamailio/dispatcher.list".
|
|
|
|
|
Default value is “/etc/kamailio/dispatcher.list” or
|
|
|
|
|
“/usr/local/etc/kamailio/dispatcher.list”.
|
|
|
|
|
|
|
|
|
|
Example 1.1. Set the "list_file" parameter
|
|
|
|
|
Example 1.1. Set the “list_file” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "list_file", "/var/run/kamailio/dispatcher.list")
|
|
|
|
|
...
|
|
|
|
@ -337,9 +343,9 @@ modparam("dispatcher", "list_file", "/var/run/kamailio/dispatcher.list")
|
|
|
|
|
If you want to load the sets of gateways from the database you must set
|
|
|
|
|
this parameter.
|
|
|
|
|
|
|
|
|
|
Default value is "NULL" (disable DB support).
|
|
|
|
|
Default value is “NULL” (disable DB support).
|
|
|
|
|
|
|
|
|
|
Example 1.2. Set "db_url" parameter
|
|
|
|
|
Example 1.2. Set “db_url” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "db_url", "mysql://user:passwb@localhost/database")
|
|
|
|
|
...
|
|
|
|
@ -349,9 +355,9 @@ modparam("dispatcher", "db_url", "mysql://user:passwb@localhost/database")
|
|
|
|
|
If you want to load the sets of gateways from the database you must set
|
|
|
|
|
this parameter as the database name.
|
|
|
|
|
|
|
|
|
|
Default value is "dispatcher".
|
|
|
|
|
Default value is “dispatcher”.
|
|
|
|
|
|
|
|
|
|
Example 1.3. Set "table_name" parameter
|
|
|
|
|
Example 1.3. Set “table_name” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "table_name", "my_dispatcher")
|
|
|
|
|
...
|
|
|
|
@ -360,9 +366,9 @@ modparam("dispatcher", "table_name", "my_dispatcher")
|
|
|
|
|
|
|
|
|
|
The column's name in the database storing the gateway's group id.
|
|
|
|
|
|
|
|
|
|
Default value is "setid".
|
|
|
|
|
Default value is “setid”.
|
|
|
|
|
|
|
|
|
|
Example 1.4. Set "setid_col" parameter
|
|
|
|
|
Example 1.4. Set “setid_col” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "setid_col", "groupid")
|
|
|
|
|
...
|
|
|
|
@ -371,9 +377,9 @@ modparam("dispatcher", "setid_col", "groupid")
|
|
|
|
|
|
|
|
|
|
The column's name in the database storing the destination sip URI.
|
|
|
|
|
|
|
|
|
|
Default value is "destination".
|
|
|
|
|
Default value is “destination”.
|
|
|
|
|
|
|
|
|
|
Example 1.5. Set "destination_col" parameter
|
|
|
|
|
Example 1.5. Set “destination_col” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "destination_col", "uri")
|
|
|
|
|
...
|
|
|
|
@ -383,9 +389,9 @@ modparam("dispatcher", "destination_col", "uri")
|
|
|
|
|
The column's name in the database storing the flags for the destination
|
|
|
|
|
URI.
|
|
|
|
|
|
|
|
|
|
Default value is "flags".
|
|
|
|
|
Default value is “flags”.
|
|
|
|
|
|
|
|
|
|
Example 1.6. Set "flags_col" parameter
|
|
|
|
|
Example 1.6. Set “flags_col” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "flags_col", "dstflags")
|
|
|
|
|
...
|
|
|
|
@ -395,9 +401,9 @@ modparam("dispatcher", "flags_col", "dstflags")
|
|
|
|
|
The column's name in the database storing the priority for destination
|
|
|
|
|
URI.
|
|
|
|
|
|
|
|
|
|
Default value is "priority".
|
|
|
|
|
Default value is “priority”.
|
|
|
|
|
|
|
|
|
|
Example 1.7. Set "priority_col" parameter
|
|
|
|
|
Example 1.7. Set “priority_col” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "priority_col", "dstpriority")
|
|
|
|
|
...
|
|
|
|
@ -408,9 +414,9 @@ modparam("dispatcher", "priority_col", "dstpriority")
|
|
|
|
|
when that is already set. If set to 0, will return error when the
|
|
|
|
|
destination address is already set.
|
|
|
|
|
|
|
|
|
|
Default value is "1".
|
|
|
|
|
Default value is “1”.
|
|
|
|
|
|
|
|
|
|
Example 1.8. Set the "force_dst" parameter
|
|
|
|
|
Example 1.8. Set the “force_dst” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "force_dst", 1)
|
|
|
|
|
...
|
|
|
|
@ -429,9 +435,9 @@ modparam("dispatcher", "force_dst", 1)
|
|
|
|
|
destination set in the AVP, and use these AVPs to contact next address
|
|
|
|
|
if the current-tried destination fails.
|
|
|
|
|
|
|
|
|
|
Default value is "0".
|
|
|
|
|
Default value is “0”.
|
|
|
|
|
|
|
|
|
|
Example 1.9. Set the "flags" parameter
|
|
|
|
|
Example 1.9. Set the “flags” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "flags", 3)
|
|
|
|
|
...
|
|
|
|
@ -443,9 +449,9 @@ modparam("dispatcher", "force_dst", 1)
|
|
|
|
|
useful when wanting to send the call to an anouncement server saying:
|
|
|
|
|
"the gateways are full, try later".
|
|
|
|
|
|
|
|
|
|
Default value is "0".
|
|
|
|
|
Default value is “0”.
|
|
|
|
|
|
|
|
|
|
Example 1.10. Set the "use_default" parameter
|
|
|
|
|
Example 1.10. Set the “use_default” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "use_default", 1)
|
|
|
|
|
...
|
|
|
|
@ -463,9 +469,9 @@ Note
|
|
|
|
|
|
|
|
|
|
You must set this parameter if you want to do load balancing fail over.
|
|
|
|
|
|
|
|
|
|
Default value is "null" - don't add AVPs.
|
|
|
|
|
Default value is “null” - don't add AVPs.
|
|
|
|
|
|
|
|
|
|
Example 1.11. Set the "dst_avp" parameter
|
|
|
|
|
Example 1.11. Set the “dst_avp” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "dst_avp", "$avp(dsdst)")
|
|
|
|
|
...
|
|
|
|
@ -479,9 +485,9 @@ Note
|
|
|
|
|
|
|
|
|
|
You must set this parameter if you want to do load balancing fail over.
|
|
|
|
|
|
|
|
|
|
Default value is "null" - don't add AVP.
|
|
|
|
|
Default value is “null” - don't add AVP.
|
|
|
|
|
|
|
|
|
|
Example 1.12. Set the "grp_avp" parameter
|
|
|
|
|
Example 1.12. Set the “grp_avp” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "grp_avp", "$avp(dsgrp)")
|
|
|
|
|
...
|
|
|
|
@ -495,9 +501,9 @@ Note
|
|
|
|
|
|
|
|
|
|
You must set this parameter if you want to do load balancing fail over.
|
|
|
|
|
|
|
|
|
|
Default value is "null" - don't add AVP.
|
|
|
|
|
Default value is “null” - don't add AVP.
|
|
|
|
|
|
|
|
|
|
Example 1.13. Set the "cnt_avp" parameter
|
|
|
|
|
Example 1.13. Set the “cnt_avp” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "cnt_avp", "$avp(dscnt)")
|
|
|
|
|
...
|
|
|
|
@ -512,9 +518,9 @@ Note
|
|
|
|
|
You must set this parameter if you want to do load balancing on call
|
|
|
|
|
load (alg 10).
|
|
|
|
|
|
|
|
|
|
Default value is "null" - don't add AVP.
|
|
|
|
|
Default value is “null” - don't add AVP.
|
|
|
|
|
|
|
|
|
|
Example 1.14. Set the "dstid_avp" parameter
|
|
|
|
|
Example 1.14. Set the “dstid_avp” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "dstid_avp", "$avp(dsdstid)")
|
|
|
|
|
...
|
|
|
|
@ -525,9 +531,9 @@ Note
|
|
|
|
|
|
|
|
|
|
Note
|
|
|
|
|
|
|
|
|
|
Default value is "null" - don't add AVP.
|
|
|
|
|
Default value is “null” - don't add AVP.
|
|
|
|
|
|
|
|
|
|
Example 1.15. Set the "attrs_avp" parameter
|
|
|
|
|
Example 1.15. Set the “attrs_avp” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "attrs_avp", "$avp(dsattrs)")
|
|
|
|
|
...
|
|
|
|
@ -542,9 +548,9 @@ Note
|
|
|
|
|
If you want to do load balancing fail over, you have to set this
|
|
|
|
|
parameter to use the correct socket for each gateway.
|
|
|
|
|
|
|
|
|
|
Default value is "null" - don't add AVPs.
|
|
|
|
|
Default value is “null” - don't add AVPs.
|
|
|
|
|
|
|
|
|
|
Example 1.16. Set the "sock_avp" parameter
|
|
|
|
|
Example 1.16. Set the “sock_avp” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "sock_avp", "$avp(dssocket)")
|
|
|
|
|
...
|
|
|
|
@ -558,7 +564,7 @@ Note
|
|
|
|
|
You must set this parameter if you want do hashing over custom message
|
|
|
|
|
parts.
|
|
|
|
|
|
|
|
|
|
Default value is "null" - disabled.
|
|
|
|
|
Default value is “null” - disabled.
|
|
|
|
|
|
|
|
|
|
Example 1.17. Use $avp(i:273) for hashing:
|
|
|
|
|
...
|
|
|
|
@ -575,9 +581,9 @@ Note
|
|
|
|
|
The name of the PV where to store the set ID (group ID) when calling
|
|
|
|
|
ds_is_from_list() with no parameter.
|
|
|
|
|
|
|
|
|
|
Default value is "null" - don't set PV.
|
|
|
|
|
Default value is “null” - don't set PV.
|
|
|
|
|
|
|
|
|
|
Example 1.19. Set the "setid_pvname" parameter
|
|
|
|
|
Example 1.19. Set the “setid_pvname” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "setid_pvname", "$var(setid)")
|
|
|
|
|
...
|
|
|
|
@ -587,9 +593,9 @@ Note
|
|
|
|
|
The name of the PV where to store the attributes of matching address
|
|
|
|
|
when calling ds_is_from_list().
|
|
|
|
|
|
|
|
|
|
Default value is "null" - don't set PV.
|
|
|
|
|
Default value is “null” - don't set PV.
|
|
|
|
|
|
|
|
|
|
Example 1.20. Set the "attrs_pvname" parameter
|
|
|
|
|
Example 1.20. Set the “attrs_pvname” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "attrs_pvname", "$var(attrs)")
|
|
|
|
|
...
|
|
|
|
@ -600,9 +606,9 @@ Note
|
|
|
|
|
the gateways. Pinging gateways feature depends on ds_ping_interval
|
|
|
|
|
parameter.
|
|
|
|
|
|
|
|
|
|
Default value is "OPTIONS".
|
|
|
|
|
Default value is “OPTIONS”.
|
|
|
|
|
|
|
|
|
|
Example 1.21. Set the "ds_ping_method" parameter
|
|
|
|
|
Example 1.21. Set the “ds_ping_method” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_ping_method", "INFO")
|
|
|
|
|
...
|
|
|
|
@ -613,9 +619,9 @@ Note
|
|
|
|
|
to the failed gateways. This method is only available, if compiled with
|
|
|
|
|
the probing of failed gateways enabled.
|
|
|
|
|
|
|
|
|
|
Default value is "sip:dispatcher@localhost".
|
|
|
|
|
Default value is “sip:dispatcher@localhost”.
|
|
|
|
|
|
|
|
|
|
Example 1.22. Set the "ds_ping_from" parameter
|
|
|
|
|
Example 1.22. Set the “ds_ping_from” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_ping_from", "sip:proxy@sip.somehost.com")
|
|
|
|
|
...
|
|
|
|
@ -625,11 +631,11 @@ Note
|
|
|
|
|
With this parameter you can define the interval for sending a request
|
|
|
|
|
to a gateway marked as inactive upon a failed request routing to it.
|
|
|
|
|
This parameter is only used, when the TM-Module is loaded. If set to
|
|
|
|
|
"0", the pinging of inactive gateway is disabled.
|
|
|
|
|
“0”, the pinging of inactive gateway is disabled.
|
|
|
|
|
|
|
|
|
|
Default value is "0".
|
|
|
|
|
Default value is “0”.
|
|
|
|
|
|
|
|
|
|
Example 1.23. Set the "ds_ping_interval" parameter
|
|
|
|
|
Example 1.23. Set the “ds_ping_interval” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_ping_interval", 30)
|
|
|
|
|
...
|
|
|
|
@ -643,9 +649,9 @@ Note
|
|
|
|
|
The number of attempts can be set with this parameter. This parameter
|
|
|
|
|
can be modified via ser config framework.
|
|
|
|
|
|
|
|
|
|
Default value is "1" (set inactive with first failure).
|
|
|
|
|
Default value is “1” (set inactive with first failure).
|
|
|
|
|
|
|
|
|
|
Example 1.24. Set the "ds_probing_threshold" parameter
|
|
|
|
|
Example 1.24. Set the “ds_probing_threshold” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_probing_threshold", 10)
|
|
|
|
|
...
|
|
|
|
@ -658,9 +664,9 @@ Note
|
|
|
|
|
with this parameter. This parameter can be modified via ser config
|
|
|
|
|
framework.
|
|
|
|
|
|
|
|
|
|
Default value is "1" (set active with first success).
|
|
|
|
|
Default value is “1” (set active with first success).
|
|
|
|
|
|
|
|
|
|
Example 1.25. Set the "ds_inactive_threshold" parameter
|
|
|
|
|
Example 1.25. Set the “ds_inactive_threshold” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_inactive_threshold", 10)
|
|
|
|
|
...
|
|
|
|
@ -683,9 +689,9 @@ Note
|
|
|
|
|
the case of no response from the remote server, and this internal code
|
|
|
|
|
408 is accepted as vaild value.
|
|
|
|
|
|
|
|
|
|
Default value is "" (only 200 OK is accepted).
|
|
|
|
|
Default value is “” (only 200 OK is accepted).
|
|
|
|
|
|
|
|
|
|
Example 1.26. Set the "ds_ping_reply_codes" parameter
|
|
|
|
|
Example 1.26. Set the “ds_ping_reply_codes” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_ping_reply_codes", "class=2;code=403;code=488;class=
|
|
|
|
|
3")
|
|
|
|
@ -707,9 +713,9 @@ Note
|
|
|
|
|
selected gateways to be probed continually, regardless of state
|
|
|
|
|
changes.
|
|
|
|
|
|
|
|
|
|
Default value is "0".
|
|
|
|
|
Default value is “0”.
|
|
|
|
|
|
|
|
|
|
Example 1.27. Set the "ds_probing_mode" parameter
|
|
|
|
|
Example 1.27. Set the “ds_probing_mode” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_probing_mode", 1)
|
|
|
|
|
...
|
|
|
|
@ -721,9 +727,9 @@ Note
|
|
|
|
|
a hash table with 256 slots). It must be greater than 0 to enable call
|
|
|
|
|
load dispatching feature (alg 10).
|
|
|
|
|
|
|
|
|
|
Default value is "0".
|
|
|
|
|
Default value is “0”.
|
|
|
|
|
|
|
|
|
|
Example 1.28. Set the "ds_hash_size" parameter
|
|
|
|
|
Example 1.28. Set the “ds_hash_size” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_hash_size", 9)
|
|
|
|
|
...
|
|
|
|
@ -733,9 +739,9 @@ Note
|
|
|
|
|
Expiration time in seconds to remove the load on a destination if no
|
|
|
|
|
BYE was received meanwhile.
|
|
|
|
|
|
|
|
|
|
Default value is "7200".
|
|
|
|
|
Default value is “7200”.
|
|
|
|
|
|
|
|
|
|
Example 1.29. Set the "ds_hash_expire" parameter
|
|
|
|
|
Example 1.29. Set the “ds_hash_expire” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_hash_expire", 3600)
|
|
|
|
|
...
|
|
|
|
@ -746,9 +752,9 @@ Note
|
|
|
|
|
200 for INVITE was received meanwhile and state updated with
|
|
|
|
|
ds_load_update().
|
|
|
|
|
|
|
|
|
|
Default value is "7200".
|
|
|
|
|
Default value is “7200”.
|
|
|
|
|
|
|
|
|
|
Example 1.30. Set the "ds_hash_initexpire" parameter
|
|
|
|
|
Example 1.30. Set the “ds_hash_initexpire” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_hash_initexpire", 60)
|
|
|
|
|
...
|
|
|
|
@ -758,9 +764,9 @@ Note
|
|
|
|
|
Time interval in seconds to scan internal hash table with call load
|
|
|
|
|
dispatching data for expired items.
|
|
|
|
|
|
|
|
|
|
Default value is "30".
|
|
|
|
|
Default value is “30”.
|
|
|
|
|
|
|
|
|
|
Example 1.31. Set the "ds_hash_check_interval" parameter
|
|
|
|
|
Example 1.31. Set the “ds_hash_check_interval” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_hash_check_interval", 60)
|
|
|
|
|
...
|
|
|
|
@ -771,7 +777,7 @@ Note
|
|
|
|
|
|
|
|
|
|
By default no outbound proxy is defined.
|
|
|
|
|
|
|
|
|
|
Example 1.32. Set the "outbound_proxy" parameter
|
|
|
|
|
Example 1.32. Set the “outbound_proxy” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "outbound_proxy", "sip:outbound.example.com")
|
|
|
|
|
...
|
|
|
|
@ -784,7 +790,7 @@ Note
|
|
|
|
|
By default no default socket is defined, the first configuration script
|
|
|
|
|
listen directive is used.
|
|
|
|
|
|
|
|
|
|
Example 1.33. Set the "ds_default_socket" parameter
|
|
|
|
|
Example 1.33. Set the “ds_default_socket” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_default_socket", "udp:192.168.0.125:5060")
|
|
|
|
|
...
|
|
|
|
@ -802,9 +808,9 @@ Note
|
|
|
|
|
performances, because the main timer can be overloaded by taking care
|
|
|
|
|
of transactions retransmissions and expirations of items in memory.
|
|
|
|
|
|
|
|
|
|
Default value is "0".
|
|
|
|
|
Default value is “0”.
|
|
|
|
|
|
|
|
|
|
Example 1.34. Set the "ds_timer_mode" parameter
|
|
|
|
|
Example 1.34. Set the “ds_timer_mode” parameter
|
|
|
|
|
...
|
|
|
|
|
modparam("dispatcher", "ds_timer_mode", 1)
|
|
|
|
|
...
|
|
|
|
@ -840,22 +846,22 @@ Note
|
|
|
|
|
be an integer or a variable holding an integer.
|
|
|
|
|
* alg - the algorithm used to select the destination address. The
|
|
|
|
|
parameter can be an integer or a variable holding an interger.
|
|
|
|
|
+ "0" - hash over callid
|
|
|
|
|
+ "1" - hash over from URI.
|
|
|
|
|
+ "2" - hash over to URI.
|
|
|
|
|
+ "3" - hash over request-URI.
|
|
|
|
|
+ "4" - round-robin (next destination).
|
|
|
|
|
+ "5" - hash over authorization-username (Proxy-Authorization or
|
|
|
|
|
+ “0” - hash over callid
|
|
|
|
|
+ “1” - hash over from URI.
|
|
|
|
|
+ “2” - hash over to URI.
|
|
|
|
|
+ “3” - hash over request-URI.
|
|
|
|
|
+ “4” - round-robin (next destination).
|
|
|
|
|
+ “5” - hash over authorization-username (Proxy-Authorization or
|
|
|
|
|
"normal" authorization). If no username is found, round robin
|
|
|
|
|
is used.
|
|
|
|
|
+ "6" - random destination (using rand()).
|
|
|
|
|
+ "7" - hash over the content of PVs string. Note: This works
|
|
|
|
|
+ “6” - random destination (using rand()).
|
|
|
|
|
+ “7” - hash over the content of PVs string. Note: This works
|
|
|
|
|
only when the parameter hash_pvar is set.
|
|
|
|
|
+ "8" - select destination sorted by priority attribute value
|
|
|
|
|
+ “8” - select destination sorted by priority attribute value
|
|
|
|
|
(serial forking ordered by priority).
|
|
|
|
|
+ "9" - use weight based load distribution. You have to set the
|
|
|
|
|
+ “9” - use weight based load distribution. You have to set the
|
|
|
|
|
attribute 'weight' per each address in destination set.
|
|
|
|
|
+ "10" - use call load distribution. You have to set the
|
|
|
|
|
+ “10” - use call load distribution. You have to set the
|
|
|
|
|
attribute 'duid' (as an unique string id) per each address in
|
|
|
|
|
destination set. Also, you must set parameters 'dstid_avp' and
|
|
|
|
|
'ds_hash_size'.
|
|
|
|
@ -870,7 +876,7 @@ Note
|
|
|
|
|
on each address can change.
|
|
|
|
|
This algorithm can be used only for dispatching INVITE
|
|
|
|
|
requests as it is the only SIP method creating a SIP call.
|
|
|
|
|
+ "11" - use relative weight based load distribution. You have
|
|
|
|
|
+ “11” - use relative weight based load distribution. You have
|
|
|
|
|
to set the attribute 'rweight' per each address in destination
|
|
|
|
|
set. Active host usage probability is rweight/(SUM of all
|
|
|
|
|
active host rweights in destination group).
|
|
|
|
@ -880,7 +886,7 @@ Note
|
|
|
|
|
For example, 100 calls in 3-hosts group with rweight params
|
|
|
|
|
1/2/1 will be distributed as 25/50/25. After third host
|
|
|
|
|
failing distribution will be changed to 33/67/0.
|
|
|
|
|
+ "X" - if the algorithm is not implemented, the first entry in
|
|
|
|
|
+ “X” - if the algorithm is not implemented, the first entry in
|
|
|
|
|
set is chosen.
|
|
|
|
|
* limit - the maximum number of items to be stored in AVP list for
|
|
|
|
|
further failovers (the first selected destination and default
|
|
|
|
@ -1090,11 +1096,11 @@ onreply_route {
|
|
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
* _state_ : state of the destination address
|
|
|
|
|
+ "a": active
|
|
|
|
|
+ "i": inactive
|
|
|
|
|
+ "t": trying
|
|
|
|
|
+ "d": disabled
|
|
|
|
|
The states "a", "i" or "t" can be followed by "p" to set probing
|
|
|
|
|
+ “a”: active
|
|
|
|
|
+ “i”: inactive
|
|
|
|
|
+ “t”: trying
|
|
|
|
|
+ “d”: disabled
|
|
|
|
|
The states “a”, “i” or “t” can be followed by “p” to set probing
|
|
|
|
|
mode (e.g. 'ap', 'ip' or 'tp').
|
|
|
|
|
* _group_: destination group id
|
|
|
|
|
* _address_: address of the destination in the _group_
|
|
|
|
@ -1148,11 +1154,11 @@ onreply_route {
|
|
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
* _state_ : state of the destination address
|
|
|
|
|
+ "a": active
|
|
|
|
|
+ "i": inactive
|
|
|
|
|
+ "t": trying
|
|
|
|
|
+ "d": disabled
|
|
|
|
|
The states "a", "i" or "t" can be followed by "p" to set probing
|
|
|
|
|
+ “a”: active
|
|
|
|
|
+ “i”: inactive
|
|
|
|
|
+ “t”: trying
|
|
|
|
|
+ “d”: disabled
|
|
|
|
|
The states “a”, “i” or “t” can be followed by “p” to set probing
|
|
|
|
|
mode (e.g. 'ap', 'ip' or 'tp').
|
|
|
|
|
* _group_: destination group id
|
|
|
|
|
* _address_: address of the destination in the _group_
|
|
|
|
@ -1195,8 +1201,8 @@ kamcmd dispatcher.set_state ip 2 sip:127.0.0.1:5080
|
|
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
* _state_ : state of sending keepalives
|
|
|
|
|
+ "0": inactive (don't send)
|
|
|
|
|
+ "1": active (send)
|
|
|
|
|
+ “0”: inactive (don't send)
|
|
|
|
|
+ “1”: active (send)
|
|
|
|
|
|
|
|
|
|
If the state parameter is missing, the current state is returned. When
|
|
|
|
|
state is changed, new and old values of the state are returned. Default
|
|
|
|
@ -1666,4 +1672,5 @@ Chapter 2. Frequently Asked Questions
|
|
|
|
|
|
|
|
|
|
How can I report a bug?
|
|
|
|
|
|
|
|
|
|
Please follow the guidelines provided at: http://sip-router.org/tracker
|
|
|
|
|
Please follow the guidelines provided at:
|
|
|
|
|
https://github.com/kamailio/kamailio/issues
|
|
|
|
|