SIPp脚本编写方法基础m1.docx

SIPp 脚本编写方法基础 作者 王伟 版本号 目录 1. 初始化区 1. 脚本格式 1.1. 基于 XML 进行扩展 SIPp 的测试脚本遵循标准的 XML 版本的语法规范， XML 即“可扩展标记 语言” eXtensible Markup Language的缩写， W3C 组织与 1998 年发布 XML 规 范。 1.2. DTD扩展语法规则 SIPp 的执行目录中，存在一个文件。该文件为标准的 xml 扩展语法规则， 在该文件中，对 send、 recv、 pause等元素增加了定义，包括其属性列表等内 容，可作为脚本文件格式的校验。 1.3. 脚本结构 一个标准的 SIPp 脚本，文件起始应为通用的 xml 前导区和 DTD文件定义区 如图所示： 接下来使用 scenario 和/scenario 包括的部分，即为脚本的正文部分。 sipp 脚本正文部分，包含如下几个区域： 在初始化区域中，通常用来进行全局变量的定义和赋值等操作，在脚 本未进行逻辑流程前，预先完成初始化动作。 初始化区是在脚本正文的最开始，通过使用命令 init和/init ，并 在其之间插入一些 nop和label命令即可实现，在初始场景中的变量， 仅用于全局变量，并不会应用于呼叫。例如下图中，在初始化区对 THINKTIME 进行赋值： 2. 逻辑执行区 逻辑执行区中包括了业务流程的相关内容，比如接收消息、发送消 息、暂停时长、分支判断、媒体播放、内外部命令执行等操作。 逻辑执行区是脚本的最关键部分，编写 sipp 脚本，主要也就是针对 该部分进行编写和调试。 3. 变量抑制区 该部分是为了避免在脚本逻辑区定义了大量的变量，但实际并未使用 导致运行时报错无法执行的问题，不论定义了多少变量，这些变量有无 被使用，只需要添加进变量抑制区的列表中，脚本均可正常执行。该部 分仅有一个命令 Reference / ， variables 属性为所需抑制的变量列 表。如下图所示： 4. 定时器自定义区 该区域主要作用为：针对消息响应时长（ ResponseTime）以及呼叫持 续时长（ CallLength ）的 Timer 进行自定义间隔的配置，以获取所需的 显示范围，例如自定义 timer 配置为： 则在 sipp 运行时，查看运行统计界面呈现如下： 1.4. 注释 sipp脚本注释的语法格式为 !--xxx-- ，支持多行注释，如： 2. 脚本类型 SIPp 脚本根据使用场景不同，主要分为 UAC、 UAS、 3PCC 和 OCC4 种类 型，每种类型均有其特定的使用方式，内部逻辑也有所不同。 2.1. UAC 顾名思义， UAC 类型的脚本主要是模拟 sip会话中的 UAC 侧，即负责发起 会话的 client 端。如注册客户端、主叫用户、订阅者等。通常的 UAC 脚本逻辑 区会以 send作为业务流程的起始。 UAC 脚本一旦启动，如果不设置起始暂停时 长的参数，通常会立即开始执行。 2.2. UAS UAS 与 UAC 相对，主要模拟 sip会话的 UAS 侧，启动后即进入被动接收状 态，通常作为 server端使用，如注册服务器、被叫用户、通知者、业务网关等。 通常的 UAS 脚本逻辑区会以 recv作为业务流程的起始。 UAS 脚本启动后，即绑 定相关本地 socket，进入接收消息的状态。 2.3. 3PCC（三方通话） SIPp 工具允许多个脚本实例间进行交互，完成较为复杂的业务流程。如三 方通话等业务，因此该种脚本在普通脚本的基础上，更多地使用内部 cmd 交互 命令，如 recvcmd、 sendcmd等在不同脚本间传递会话参数，配合完成复杂流程 的测试实现。 sipp还提供了扩展的 3pcc 模式，支持 master和 slave的脚本角色。 该类型的脚本编写和调试较为复杂，本文档中不再赘述，如有兴趣可以翻阅 sipp 的使用手册等文档，其中有详细说明。 2.4. OCC（Out-of-call） OCC （Out-of-call ）脚本作为特殊类型的脚本，通常不会单独使用，而是与 UAC 脚本配合使用（也只能与 UAC 脚本配合， UAS 等类型脚本无法支持 -occsn 等执行命令）。主要作用为扩展 UAC