SIPp
1 安装及概述：
SIPp是一个测试SIP协议性能的工具软件。这是一个GPL的开放源码软件。
它包含了一些基本的SipStone用户代理工作流程（UAC和UAS），并可使用INVITE和B YE建立和释放多个呼叫。它也可以读XML的场景文件，即描述任何性能测试的配置文件。它能动态显示测试运行的统计数据（呼叫速率、信号来回的延迟，以及消息统计）。周期性地把CSV统计数据转储，在多个套接字上的TCP和UDP，利用重新传输管理的多路复用。在场景定义文件中可以使用正规表达式，动态调整呼叫速率。
SIPp可以用来测试许多真实的SIP设备，如SIP代理，B2BUAs,SIP媒体服务器，SIP/x网关，SIP PBX，等等，它也可以模仿上千个SIP代理呼叫你的SIP系统。
SIPp的网址：http://sipp.sourceforge.net/，这里可以下载最新版的SIPp软件，并且有英文资料可供查阅。
1.1 SIPp安装
SIPp提供Linux，Windows和HPUX平台的版本。Windows平台上的安装很简单，下面说一下Linux下的安装。
首先，可以从 http://sourceforge.net/projects/sipp/files/sipp/3.2/ 下载最新版的SIPp，解压之后就得到一个rpm文件，你可以使用rpm命令来完成安装。如果你拿到的是绿色版的SIPp，那么你需要对其重新编译才能使用。SIPp是用C++写的，因此系统必须支持G++才可成功编译。
SIPp支持四种不同的安装模式：
1) 没有TLS支持与密码验证支持：
a) # tar -xvf sipp-1.1rc6.tar.gzb)
# cd sipp-1.1.rc6c)
# makeMake
出来的sipp文件就是一个可执行的文件，只需要搭配场景xml文件与csv文件即可进行SIP测试，这是最常用的安装。
2) 拥有TLS支持与密码验证支持，但是不支PCAP语音播放：
a) # tar -xvf sipp-1.1rc6.tar.gzb)
# cd sipp-1.1.rc6c)
# make ossl
这样编译出来的文件就加入了TLS至于与密码验证支持功能sipp软件了。
3) 支持PCAP Play，但是没有密码验证支持：(PCAP Play即为可以进行RTP语音，但是没有407 AUTH验证)
a) # tar -xvf sipp-1.1rc6.tar.gzb)
# cd sipp-1.1.rc6c)
# make pcapplay
4) 支持PCAP 声音文件播放，而且支持密码验证支持：(支持407 auth验证支持)
a) # tar -xvf sipp-1.1rc6.tar
b) # cd sipp-1.1.rc6
c) # make pcapplay_ossl
1.2 SIPp使用
用SIPp做测试的时候需要准备五个文件：uac.bat, uas.bat, uac.xml, uas.xml, data.csv。
uac.bat：调用sipp命令，并传入相应参数的批处理文件，模拟UAC（例如主叫）。
uas.bat：调用sipp命令，并传入相应参数的批处理文件，模拟UAS（例如被叫），当然也可不准备此文件直接输入sipp命令执行程序，但是写成文件执行更加方便可靠。
uac.xml：根据需要编写的uac侧的sip信号流程。
uas.xml：根据需要编写的uas侧的sip信号流程。
data.csv：用于uac.xml和uas.xml中需要引入的相应数据。
下面就举例来说明这五个文件的编写方法和用法。
1.2.1 uac.bat：
例：
sipp -sn uac 172.31.89.4:5060 -r 1 -rp 3000 -inf data.csv -p 7098 -i 172.31.89.242 -s 8001 -sf uac_onecall.xml –m 1000 –l 900
各个参数说明：
172.31.89.4:5060：远端地址和端口（在脚本中用[remote_ip]，[remote_port]引入）
-r 1 -rp 3000：每三秒钟发一个呼
-inf data.csv：引入数据配置文件
-p 7098：本地端口（在脚本中用[local_port]引入）
-i 172.31.89.242：本地地址（在脚本中用[local_ip]引入）
-s 8001：被叫号码（在脚本中用[service]引入）
-sf uac_onecall.xml：引入脚本文件，根据需要模拟的呼叫流程编写
-sn uac :执行默认的uac流程，如需执行自己编写的流程文件，命令中应不含此参数
-m 1000:发送1000次呼叫后停止并退出。
-l 900 :最大同时保持呼叫量，默认值为3*caps值*呼叫时长，当因种种原因导致现存呼叫总数达到此值时，SIPp将停止产生新的呼叫，等待现存呼叫总数低于此值时才继续产生呼叫。
1.2.2 data.csv：
例：
SEQUENTIAL
8000;
第一行为取号码方式，通常为SEQUENTIAL或RANDOM
此例中只有一个数据，引入时用[field0]，如果有多个数据，用分号隔开，在引用时编号递增如[field1],[field2]。
1.2.3 uac.xml：
例：
<scenario name="branch_client">
<send retrans="500">
<![CDATA[
INVITE sip:[service]@[remote_ip] SIP/2.0
Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch];rport
Allow: INVITE,CANCEL,ACK,BYE,OPTIONS,REFER,NOTIFY,MESSAGE,SUBSCRIBE,INFO
From: "[field0]" <sip:[field0]@[local_ip]>;tag=[call_number]
To: "[service]" <sip:[service]@[remote_ip]>
Call-ID: [call_id]
CSeq: 1 INVITE
Contact: <sip:[field0]@[local_ip]:[local_port]>
Max-Forwards: 70
Content-Type: application/sdp
Content-Length:[len]
v=0
o=[field0] 00 INIP4 [local_ip]
s=SIP Call
t=0 0
c=IN IP4 [local_ip]
m=audio [media_port] RTP/AVP 0
a=rtpmap:0 PCMU/8000
]]>
</send>
注：
1．需要sipp命令赋值的参数，请参考关于uac.bat的说明
[local_ip]、[local_port]、[remote_ip]、[remote_port]、[service]
2．sipp自动检测生成的参数：
[call_number]、[call_id]、[cseq]、[len]、[branch]
3．从数据配置文件引入的参数，请参考data.csv，第一个值为field0
4．CSeq: 1 INVITE：此处本来应该写成CSeq: [cseq] INVITE，而在对应的ACK中写成CSeq: [cseq] ACK，但在INVITE和ACK的中间夹杂有PRACK的时候，ACK如果写成上述形式，将不能与INVITE对应，所以可以写死。
5. 在测试业务时，应在头域中添加<Route：被叫侧地址>以保证呼叫会从AS路由到被叫，否则AS会发消息到默认的地址。
<recv response="100" optional="true">
</recv>
注：按照预期，发出INVITE之后有可能受到100 Trying，也有可能收不到，所以加上可选标记
<recv response="180">
</recv>
注：此时如果收到180以外的响应，会异常退出。
<recv response="200">
</recv>
<send>
<![CDATA[
ACK sip:[service]@[remote_ip] SIP/2.0
Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch];rport
[last_From:]
[last_To:]
Call-ID: [call_id]
Contact: <sip:[field0]@[local_ip]:[local_port]>
CSeq: 1 ACK
Max-Forwards: 70
Content-Length: 0
]]>
</send>
注：发送请求的时候不需要也不可能重新填写所有字段（比如说From字段是不需要，因为一个dialog里的From字段都是相同的；而To字段是没办法自己填写，必需从上一个响应中引入，因为To-tag是远端加上的，本地并不知道），所以可以用[last_字段名]的方式从上一个消息中取得。
通常From，To字段从上一个消息中取得，200的ACK时，Via从初始INVITE拷贝就可以，此时branch参数会自动生成跟初始INVITE不一样的值；非200的ACK时，采用从上一个消息引入的方式。
<pause milliseconds="30000"/>
注：在通话状态维持30秒，以模拟实际通话持续通话的时间。
<nop>
<action>
<exec play_pcap_audio="C:\711.pcap"/>
<exec play_pcap_video="C:\h263.pcap"/>
</action>
</nop>
注：在通话状态如果有需要的话可以发送媒体流。前提是在相应的目录下有媒体流文件
<send retrans="500">
<![CDATA[
BYE sip:[service]@[remote_ip] SIP/2.0
Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch];rport
[last_From:]
[last_To:]
Call-ID: [call_id]
CSeq: 2 BYE
Max-Forwards: 70
Content-Length: 0
]]>
</send>
注：加入retrans参数之后可在没收到响应的情况下，在设定的时间之后重传，此例中为500毫秒。
<recv response="200">
</recv>
<pause milliseconds="3000"/>
<!-- definition of the response time repartition table (unit is ms) -->
<ResponseTimeRepartition value="10, 20, 30, 40, 50, 100, 150, 200"/>
<!-- definition of the call length repartition table (unit is ms) -->
<CallLengthRepartition value="10, 50, 100, 500, 1000, 5000, 10000"/>
</scenario>
2 常见问题：
1．Unable to bind main socket, errno = 125。
想绑定的本地端口已经被占用，换一个应该就可以了。
2、 while expecting '180' response, received 'SIP/2.0 200 OK
脚本中在发出INVITE之后要收100或者180，结果直接就收到了200。可以在180后面也加上optional="true"就行。
3、消息发出后无响应
需要确认远端即服务器端系统正常，并且uac.bat中的远端地址和端口正确，另外可能需要将本地地址加入为服务器的可信节点。
4、Can't open PCAP file '711.pcap'.
需要确认媒体流文件确实存在且路径正确，并且媒体流文件可用。
2.1 uas.bat
例：
sipp -sn uac 172.31.89.4:5060 -inf data.csv -i 172.31.89.242 -p 8890 -s 8001 -sf uas_onecall.xml
关于各个参数的说明请参考uac.bat的说明
2.2 uas.xml
例：
<scenario name="branch_server">
<recv request="INVITE">
<action>
<ereg regexp=".*" search_in="hdr" header="CSeq:" assign_to="6" />
<ereg regexp=".*" search_in="hdr" header=“Via:" assign_to="5" />
</action>
</recv>
正则表达式使用说明：在本例中原本是不需要使用的，但在很多情况下需要使用，所以列出来说明一下。当sequence中带有PRACK时，UAS发送INVITE的200 OK时，某些字段（比如Via和Cseq）则不能使用[last_字段名]方式从上一个收到的消息中引入，因为此时上一个消息是PRACK，而不是INVITE，所以需要先将INVITE的这两个字段保存下来供以后使用。上面的用法便是将INVITE的CSeq字段的值保存为数字6，在以后发送INVITE的200 OK的时候使用，方式为：CSeq: [$6]
<send>
<![CDATA[
SIP/2.0 100 Trying
[last_Via:]
[last_From:]
[last_To:]
[last_Call-ID:]
[last_CSeq:]
Content-Length: 0
]]>
</send>
注：基本上所有的字段都可以从上一个消息中引入。
<send>
<![CDATA[
SIP/2.0 180 Ringing
[last_Via:]
[last_From:]
[last_To:];tag=[call_number]
[last_Call-ID:]
[last_CSeq:]
[last_Record-Route:]
Contact: <sip:[local_ip]:[local_port]>
P-Asserted-Identity: "[service]" <sip:[service]@[local_ip]>
Content-Length:[len]
]]>
</send>
注：To字段从上一个消息中引入的时候，需要添加To-tag，call_number为sipp自动生成的，在连续呼叫的时候会加1。从上一个消息引入相关字段的时候，如果上一个消息没有这个字段，则在本消息中也不会有。
<pause milliseconds="5000"/>
<send>
<![CDATA[
SIP/2.0 200 OK
[last_Via:]
Allow: INVITE,CANCEL,ACK,BYE
[last_From:]
[last_To:];tag=[call_number]
[last_Call-ID:]
[last_CSeq:]
[last_Record-Route:]
Contact: <sip:[local_ip]:[local_port]>
P-Asserted-Identity: "[service]" <sip:[service]@[local_ip]>
Content-Type: application/sdp
Content-Length:[len]
v=0
o=[service] 00 INIP4 [local_ip]
s=SIP Call
t=0 0
c=IN IP4 [local_ip]
m=audio 10000 RTP/AVP 0
a=rtpmap:0 PCMU/8000
]]>
</send>
注：100，180，200的上一个消息都是INVITE消息，所以此时To字段中还是要加入To-tag，并且在一个dialog中call_number是相同的，所以能与180的To-tag保持一致。
<recv request="ACK">
</recv>
<recv request="BYE">
</recv>
<send>
<![CDATA[
SIP/2.0 200 OK
[last_Via:]
[last_From:]
[last_To:]
[last_Call-ID:]
[last_CSeq:]
Contact: <sip:[local_ip]:[local_port];transport=[transport]>
Content-Length: 0
]]>
</send>
注：cantact字段一定不能从上一个消息中引入。
<!-- Keep the call open for a while in case the 200 is lost to be -->
<!-- able to retransmit it if we receive the BYE again. -->
<pause milliseconds="3000"/>
<!-- Definition of the response time repartition table (unit is ms) -->
<ResponseTimeRepartition value="10, 20, 30, 40, 50, 100, 150, 200"/>
<!-- Definition of the call length repartition table (unit is ms) -->
<CallLengthRepartition value="10, 50, 100, 500, 1000, 5000, 10000"/>
</scenario>