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>