Basic Test with SIPp

Introduction¶

When are you writing a "Basic" test with SIPp?

• When you only want to execute a SIPp scenario, and do not need any information from Asterisk itself to determine the pass/fail status of the test.
• When you have large numbers of related SIPp scenarios that do not need information from Asterisk.

Lets assume we would like to test a nominal SIP REGISTER request. A very simple SIPp scenario can be used for this purpose. Note that this only tests that Asterisk can receive a REGISTER request and reply back with a "200 OK" response, not whether or not Asterisk has created a SIP peer internally or performed any decisions based on the receiving of the REGISTER request.

SIPp Scenario¶

<?xml version="1.0" encoding="ISO-8859-1" ?>
<scenario name="UAC Register">

 <send retrans="500">
 <![CDATA[

 REGISTER sip:v4-in@[remote_ip]:[remote_port] SIP/2.0
 Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
 From: v4-in <sip:v4-in@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
 To: <sip:v4-in@[remote_ip]:[remote_port]>
 Call-ID: [call_id]
 CSeq: 1 REGISTER
 Contact: sip:v4-in@[local_ip]:[local_port]
 Max-Forwards: 70
 Subject: REGISTER Test
 Expires: 3600
 Content-Length: 0

 ]]>
 </send>

 <recv response="200" rtd="true" />
</scenario>

Asterisk Configuration¶

Since the SIPp scenario is attempting a REGISTER request for v4-in, we must have a corresponding sip.conf configuration file defining the peer.

[general]
bindaddr=[::]:5060

[v4-in]
type=friend
host=dynamic

Asterisk Test Suite run-test¶

The Asterisk Test Suite provides a class, SIPpTest, that inherits from TestCase and will automatically run a set of SIPp scenarios. The class looks for the scenarios in the 'sipp' folder and will execute the scenarios in parallel on a single instance of Asterisk. The results of the test are directly related to the success/failure of the SIPp scenario - if all scenarios pass, the test passes; if any scenario fails, the test fails. Creating a run-test script that executes a SIPp scenario is thus exceedingly simple.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

#!/usr/bin/env python

import sys
import os

sys.path.append("lib/python")

from twisted.internet import reactor
from asterisk.sipp import SIPpTest

WORKING_DIR = "channels/SIP/sip_register"
TEST_DIR = os.path.dirname(os.path.realpath(__file__))

SIPP_SCENARIOS = [
 {
 'scenario' : 'registerv4.xml'
 },
]


def main():
 test = SIPpTest(WORKING_DIR, TEST_DIR, SIPP_SCENARIOS)
 reactor.run()
 if not test.passed:
 return 1

 return 0


if __name__ == "__main__":
 sys.exit(main())