kamailio-config-tests

Go to file

Victor Seva 300bb0f286 bin/check.sh: do not force skip test on skip parse		13 years ago
bin	bin/check.sh: do not force skip test on skip parse	13 years ago
debian	Run wrap-and-sort over all debian/ files	13 years ago
scenarios	Add test for subscriber with aliases and extension_in_npn	13 years ago
.gitignore	ignore generated files	13 years ago
README	Update documentation. Now 3.0 has the reset_msgid patch.	13 years ago
bench.sh	Show exit status on output	13 years ago
get_results.sh	bin/check.sh: fix skip creation option	13 years ago
run_tests.sh	bin/check.sh: do not force skip test on skip parse	13 years ago

README

Kamailio configuration tests
----------------------------

Requeriments:
-------------
 - A working NGCP
 - sip-tester. sipp with ssl enabled ( needed for auth ).
   We provide a version backported to wheezy
 - python-yaml
 - libgraphviz-perl
 - libtemplate-perl
 - libtext-csv-perl
 - ngcp-ossbss-clients-perl
 - parallel
 - tcpdump

Manual Installation:
-------------
  You can install the scripts in other place but you have
  to modify BASE_DIR environment variable.

  #cd /usr/share/kamailio-config-tests
  #git clone git@git.mgm.sipwise.com:kamailio-config-tests
  #apt-get install python-yaml sip-tester \
                   libgraphviz-perl libtemplate-perl libtext-csv-perl \
                   ngcp-ossbss-clients-perl parallel tcpdump

Debian Deb Installation:
------------------------

# aptitude install kamailio-config-tests

Usage:
------
  # cd /usr/share/kamailio-config-tests

  If you are using the git version and not in /usr/share/kamailio-config-tests
  you need to set BASE_DIR environment variable accordingly:
  # export BASE_DIR=`pwd`
  This is not needed if you are using the Debian packaged version.

  PROFILE: "CE" the default
           "PRO"
  #bash ./run_tests.sh [-p PROFILE ]

  This will create:
    - $BASE_DIR/log
      with a directory per test with:
      - kamailio.log
      - parsed messages
      - sipp error logs

  #bash ./get_result.sh [-p PROFILE ] [-g]

  This will create:
    - $BASE_DIR/result
      with a directory per test with:
      - a tap file ( test results )
      - a png file ( routes flow ) If you use -g option

 If you want to run test manually just exec this onces:
  #./bin/config_debug.pl on
  #ngcpcfg apply
 and run the check that you want:
  #./bin/check.sh <checkname>
 this will run the test and the result taps
 or run all the tests as many times you want with:
  #./bin/bench.sh $NUM

Development:
------------

Every test has to be located at the scenarios directory. It must include:

 - scenario.yml
 - XXXX_test.yml.tt2
   XXXX indicates the number of kamailio parsed msg XXXX.yml to test
 - sipp_scenarioXX.xml

And can optionally include:
 - sipp_scenario_responderXX.xml
 - prefs.yml
 - callforward.yml
 - speeddial.yml
 - peer.yml
--
Victor Seva <vseva@sipwise.com>