本文主要是介绍OpenSIPS Dispatcher 模块 使用指南,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
便于大伙学习,翻译了官方文档。如有不妥之处,请见谅,望联系。
目录表:
1.管理指南
1.1 概况
1.2 依赖
1.3 导出参数( Exported Parameters)
1.4 导出函数(Exported Function)
1.5 导出MI函数
1.6 导出事件
1.7 安装和运行
正文部分:
1.1 概况
1.2 依赖
1.3 导出参数( Exported Parameters)
1.4 导出函数(Exported Function)
1.4.1 ds_select_dst(set, alg [, (flags M max_results)*])
该方法从给定的地址集中挑选一个目的地。它会覆写SIP请求($du)的“destination URI”值。
以下是各个参数的意义:
- set - 分区名称,后面跟冒号、领取到目的地址的集合ID或集合ID列表(接受变量)。如果缺少分区名称,将使用默认分区。
- alg - 用于选择目标地址的算法(接受变量):
- “0”: 在callid上哈希
- “1”:在“from uri“上哈希
- “2”: 在“to uri“上哈希
- “3”:在“request uri”上哈希
- “4”:加权轮询(下一个目的地)
- “5”:通过授权用 户名( authorization-username )哈希
- “6”:随机(使用rand())
- “7”: 哈希 PVs字符串的内容。注意:仅当设置参数hash_pvar时,此方法才有效。
- “8”: 选择集合中的第一个条目
- “9”: pvar_algo_pattern参数用于确定每个服务器上的负载。如果未指定参数,则选择集合中的第一个条目
- “X”: 如果未实现该算法,则选择集合中的第一个条目
-
- flags M max_results - 如果指定,这将是在启动时指定的先前版本中的标志。这些标志是:
- 'f'/ 'F':支持failover。
- 'u'/'U': 用户唯一。 将指定仅uri用户部分将用于哈希。
- 'S'/'s':强制目的地。如果目的地址已经设置,将跳过覆写目的地址。
- 'D'/'d':默认。 使用目的地中的最后一个地址作为最后一个选项来发送消息。
-
你也可以使用PVs指定这些标志。这些标志按分区保留。
第二个参数max_results表示最多只能将max_results的最大值放入指定的avp中以进行failover操作。这样可以有许多目的地,但 如果某个数字注定会在任何地方失败,则可以限制无用的流量。 从2.1版开始,最后一个参数可以由flags和max_results的列表表示,并用逗号分隔。你可以仅指定标志,也可以仅指定max_results参数,但是如果要一起指定它们,则必须使用'M'字符,如下实例:flags M max_results。
如果设置了'flags'中的字符'f',则目标集中的其余地址将存储在AVP列表中。你可以使用"ds_next_dst()"来使用下一个地址来实现到所有可能目的地的串行分支。如果使用多个调度组,则根据列表中每个调度ID的位置来构造AVP列表:第一个具有较高的优先级,其次是第二个,依此类推。
可以在REQUEST_ROUTE,BRANCH_ROUTE和FAILURE_ROUTE中使用此函数。
例子 1.33 ds_select_dst 的用法
...
ds_select_dst("1", "0");
...
ds_select_dst("part2 : 1", "0", "5");
...
ds_select_dst("part3 : 1", "0", "fUsD");
...
ds_select_dst("part4 : 2,3", "0,1", "fuD M 5, fuS M 2");
...
# dispatch over multiple dispatching groups
$var(part_name) = "p4"
$var(setid) = "1, 2";
$var(alg) = "4, 2";
$var(flags) = " sFDU M 2, fuS M 3";
ds_select_dst("$var(part_name):$var(setid)","$var(alg)","$var(flags)");
...
1.5 导出MI函数
1.6 导出事件
1.7 安装和运行
附注:持续更新
这篇关于OpenSIPS Dispatcher 模块 使用指南的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!