Copyright © 2009 voice-system.ro
| Revision History | |
|---|---|
| Revision $Revision: 5886 $ | $Date: 2009-07-16 12:54:34 +0200 (Thu, 16 Jul 2009) $ |
Table of Contents
List of Examples
db_url parameterdb_table parameterload_balance usageThe Load-Balancer module comes to provide traffic routing based on load. Shortly, when OpenSIPS routes calls to a set of destinations, it is able to keep the load status (as number of ongoing calls) of each destination and to choose to route to the less loaded destination (at that moment). OpenSIPS is aware of the capacity of each destination - it is preconfigured with the maximum load accepted by the destinations. To be more precise, when routing, OpenSIPS will consider the less loaded destination not the destination with the smallest number of ongoing calls, but the destination with the largest available slot.
Please refer to the Load-Balancer tutorial from the OpenSIPS website: http://www.opensips.org/index.php?n=Resources.DocsTutLoadbalancing.
The following modules must be loaded before this module:
Dialog - Dialog module
database - one of the DB modules
The function performs load-balancing over the available destinations in order to find the less loaded destination that can provide the requested resources and belong to a requested group.
Meaning of the parameters is as follows:
grp - group id for the destinations; the destination may be grouped in several groups you can you for differnet scenarios.
resources - string containing a semi-colon list of resources required by the current call.
Function returns true is a new destination URI is set pointing to the selected destiantion. NOTE that the RURI will not be changed by this function.
This function can be used from REQUEST_ROUTE, BRANCH_ROUTE, REPLY_ROUTE and FAILURE_ROUTE.
Example 1.3. load_balance usage
...
if (load_balance("1","trascoding;conference")) {
# dst URI points to the new destination
xlog("sending call to $du\n");
t_relay();
exit;
}
...
Trigers the reload of the load balancing data from the DB.
MI FIFO Command Format:
:lb_reload:_reply_fifo_file_ _empty_line_
Changes the capacity for a resource of a destination. The function receives as parameters the ID (as per DB) of the destination along with the name of the resource you want to resize.
MI FIFO Command Format:
:lb_resize:_reply_fifo_file_ 11 /*dstination id*/ voicemail /*resource name*/ 56 /* new resource capacity*/ _empty_line_
3.1. | Where can I find more about OpenSIPS? |
Take a look at http://www.opensips.org/. | |
3.2. | Where can I post a question about this module? |
First at all check if your question was already answered on one of our mailing lists:
E-mails regarding any stable OpenSIPS release should be sent to
If you want to keep the mail private, send it to
| |
3.3. | How can I report a bug? |
Please follow the guidelines provided at: https://github.com/OpenSIPS/opensips/issues. |