1

Introduction to SIPp

Speaker: Yan-Hsiang Wang

Date: 2006.12.25

2

Outline

Introduction Basic scenarios Custom XML Advance scenarios Reference

3

Introduction

SIP performance tester a free open source test tool a traffic generator

It includes a few basic user agent scenarios UAC UAS

It can read custom XML scenario files

4

Introduction (cont.)

It features the dynamic display of statistics about running tests call rate round trip delay message statistics

It can also send media (RTP) traffic

5

UAS vs UAC

UAS: sipp -sn uas UAC: sipp -sn uac 127.0.0.1 -mp 6100

6

UAS vs UAC (cont.)

UAS: sipp -sf uas.xml sipp -sd uas > uas.xml http://ms11.voip.edu.tw/~sepp/sipp/uas.xml

UAC: sipp 127.0.0.1 -sf uac.xml -mp 6100 sipp -sd uac > uac.xml http://ms11.voip.edu.tw/~sepp/sipp/uac.xml

-sn name : use a default scenario-mp media_port : set the local RTP port (defaulf=6000)-sf filename : load a custom scenario-sd name : dump a default scenario

7

Options

Usage sipp remote_host[:remote_port] [options]

Regular options -sn name : use a default scenario -mp media_port : set the local RTP port (defaulf

=6000) -sf filename : load a custom scenario -sd name : dump a default scenario -inf filename : inject values from an external CSV

file

8

Options (cont.)

Particular options -d duration: control call length when “pause” occ

ur (default=0ms) -r rate: set the call rate a.k.a. CPS (default=10) -rp period: specify the rate period (default=1s) -m calls: set the total number of calls -nr: disable retransmission in UDP mode -l calls_limit: set the maximum number of calls -rsa host:port: set the relay address -i local_ip: set local ip

9

REGISTER

sipp -sf register.xml sip_proxy \-inf user_list.csv -i user_ip http://ms11.voip.edu.tw/~sepp/sipp/register.xml http://ms11.voip.edu.tw/~sepp/sipp/user_list.csv.txt

-inf filename : inject values from an external CSV file

10

Defacto scenario

UAS: sipp -sn uas -rsa relay_host:5060 -i uas_ip UAC: sipp -sn uac -rsa relay_host:5060 \

uas_ip -i uac_ip -l 1 -nr -r 1

11

Send RTP

UAS: sipp -sn uas -rsa relay_host:5060 -i uas_ip UAC: sipp -sn uac -rsa relay_host:5060 uas_ip \

-i uac_ip -l 3 http://ms11.voip.edu.tw/~sepp/sipp/uac_pcap.xml

12

Reference

Welcome to SIPp http://sipp.sourceforge.net/

Using SIPp to run performance tests http://sipx-wiki.calivia.com/index.php/Using_SIPp_to_run_performance_tests

iptel.org: SER and OpenSER t_relay tests http://www.iptel.org/~vku/performance/tm.serXopenser.more/

voip-info.org: Sipp http://www.voip-info.org/wiki/view/Sipp

13

Merry X’mas!!