kamailio/kamailio-tests

Test Units For Kamailio SIP Server

Kamailio - The Open Source SIP Server

Project Website:

• https://www.kamailio.org

20 Years Of Kamailio Development: Sep 3, 2001 - Sep 3, 2021

Overview

Kamailio is an open source implementation of a SIP Signaling Server. SIP is an open standard protocol specified by the IETF. The core specification document is RFC3261.

The Kamailio SIP server is designed for scalability, targeting large deployments (e.g. for IP telephony operators or carriers, which have a large subscriber base or route a big volume of calls), but can be also used in enterprises or for personal needs to provide VoIP, Instant Messaging and Presence. Kamailio is well known for its flexibility, robustness, strong security and the extensive number of features - for more information, please see:

• https://www.kamailio.org/w/features/

Kamailio development was started back in 2001 by Fraunhofer Fokus, a research institute in Berlin, Germany. At that time the project name was SIP Express Router (aka SER). In 2005, a fork named OpenSER was created, which was renamed to Kamailio in July 2008 due to trademark issues. Starting in the autumn of 2008, Kamailio and SER initiated the process to merge the two projects. After the merge was complete, Kamailio became the main name of the project, being better protected in terms of trademarks.

Fraunhofer Fokus is no longer actively involved in the evolution of the project. Kamailio is now developed and managed by its world wide community. Fokus still uses Kamailio in its research projects (such as OpenIMSCore) and it is hosting events related to the project, such as developer meetings or the Kamailio World Conference.

For more information about Kamailio, see the website of the project, where you can find pointers to documentation, the project wiki and much more.

Contributions

Github pull requests are the recommended way to contribute to Kamailio source code or documentation:

• https://github.com/kamailio/kamailio/pulls

To keep a coherent and consistent history of the development, the commit messages format and content must follow the rules detailed at:

• https://www.kamailio.org/wikidocs/devel/github-contributions

Contributions must conform with licensing rules of the Kamailio project.

License

Main License: GPLv2.

Each source code file refers to the license and copyright details in the top of the file. Most of the code is licensed under GPLv2, some parts of the code are licensed under BSD.

License Of New Code Contributions

New contributions to the core and several main modules (auth, corex, sl, tls, tm) have to be done under the BSD license. New contributions under the GPL must grant the GPL-OpenSSL linking exception. Contributions to existing components released under BSD must be done under BSD as well.

Documentation

The main index for documentation is available at:

• https://www.kamailio.org/w/documentation/

The online documentation for modules in the latest stable branch:

• https://kamailio.org/docs/modules/stable/

The wiki collects a consistent number of tutorials, the indexes for variables, functions and parameters:

• https://www.kamailio.org/wikidocs/

Please read the README file in the source code, one per module.

Installation

Step by step tutorials to install Kamailio from source code are available at:

• https://www.kamailio.org/wikidocs/#installation

Please read the INSTALL file from the source code for more information.

Repositories for Linux packages:

• deb: https://www.kamailio.org/wikidocs/packages/debs
• rpm: https://www.kamailio.org/wikidocs/packages/rpms

Issues And Bug Reports

To report a bug or make a request for new features, use the Issues Page in the Kamailio Github project:

• https://github.com/kamailio/kamailio/issues

Open Support And Community Discussions

Mailing Lists

Mailing list for discussions regarding stable versions of Kamailio:

• sr-users (at) lists.kamailio.org - sr-users web page

Mailing list for discussions regarding the development of Kamailio and the state of master (devel) branch:

• sr-dev (at) lists.kamailio.org - sr-dev web page

Mailing list for discussions with commercial purpose:

• business (at) lists.kamailio.org - business web page

For more information about the mailing lists, please see:

• https://www.kamailio.org/w/mailing-lists/

Matrix Channel

An open Matrix discussion channel is managed by the community:

• server: https://riot.kamailio.dev/
• Room: https://riot.kamailio.dev/#/room/#kamailio:matrix.kamailio.dev

Useful Resources

News:

• https://www.kamailio.org/w/category/news/
• Twitter @kamailio

Thank you for flying Kamailio!

kamailio-tests's Issues

Unit tests are failing on CentOS 7

I built docker container based on Centos7 and noticed that few tests failed.

* test unit tasync0001: async routing - cfg variables tests
- test unit tasync0001: ok
* test unit tauthx0001: user authentication - basic tests
- test unit tauthx0001: ok
* test unit tauthx0002: xkeys authentication - using kemi lua script
- test unit tauthx0002: failed
* test unit tavpop0001: avpops - avp_subst() and avp_subst_pv() tests
- test unit tavpop0001: failed
* test unit tcfgxx0001: default config file - basic load tests
- test unit tcfgxx0001: ok
* test unit tcfgxx0002: default config file - basic sip signaling tests
- test unit tcfgxx0002: ok
* test unit tcfgxx0003: faulty config - ifdef check Tests
- test unit tcfgxx0003: ok
* test unit tgroup0001: group module - group membership tests
- test unit tgroup0001: ok
* test unit tlcust0001: log_custom - basic tests
- test unit tlcust0001: failed
* test unit tmodxx0001: load all modules - detect undefined symbols
- test unit tmodxx0001: ok
* test unit tmtree0001: mtree - basic tests
- test unit tmtree0001: ok
* test unit tpvxxx0001: pv - $xavi() tests
- test unit tpvxxx0001: failed
* test unit tregxx0001: registrar - check xavp_rcd values
- test unit tregxx0001: failed
* test unit tregxx0002: registrar - check xavp_rcd values
- test unit tregxx0002: ok
* test unit tsiput0001: siputils - basic tests
- test unit tsiput0001: ok
* test unit tsjlua0001: sipjson - tests with Lua scripts
- test unit tsjlua0001: failed
* test unit tsjson0001: sipjson - basic tests
- test unit tsjson0001: ok
* test unit ttlsxx0001: tls configiguration - basic test
- test unit ttlsxx0001: ok
* test unit tuacxx0001: uac module - uac_req_send() tests
- test unit tuacxx0001: ok
* test unit tulocx0001: user location - basic tests
- test unit tulocx0001: failed

Reasons are different, e.g.:
tauthx:

warning: to send a message mode (-M) is required. activating
./tauthx0002.sh: line 10:   546 Segmentation fault      (core dumped) sipsak -H 127.0.0.1 -c sip:[email protected] -s sip:[email protected] -B "hello there"

tulocx:

--- start sipsak -vvv -U -I -H 127.0.0.1 -s sip:[email protected]
warning: Do NOT use the usrloc invite mode without registering sipsak before.
         See man page for details.

Dockerfile.Centos7 fails with missing dependencies

My first time attempting build of kamailio-test, so possible PEBKAC issues, but there were several missing dependencies when I attempted to create a docker build from the kamailio-tests/docker/Dockerfile.centos7 file. Corrective action was to add the following yum packages to 'step 3'

• python3-devel
• ruby-devel
• mosquitto-devel
• libmnl-devel

Attaching the modified Dockerfile which completed the build (apparently) successfully.

Dockerfile.centos7.txt