Resources.DocsTools History

Hide minor edits - Show changes to markup

April 24, 2013, at 06:11 PM by 213.233.101.41 -
Changed lines 1-111 from:

Resources -> Documentation -> OpenSIPS Tools


(:toc-float Table of Content:)

This list contains a few tools which can be used in setting up or testing your OpenSIPS installation.


m4

Included on most Linuxes. This is a simple way to set up and use separate parameter files or even a good way of accomplishing INCLUDE's in your configs. Example of usage is provided by Iņaki Baz Castillo;

I strongly recommend you to use M4 to compile your opensips.cfg file:

file /etc/opensips/opensips.cfg.m4:
---------------------------------------------
debug=3
log_stderror=no
log_facility=LOG_LOCAL7
fork=yes
...
listen=MY_IP:MY_PORT
...
    rewritehost("MEDIA_SERVER_IP:MEDIA_SERVER_PORT");
...
---------------------------------------------

file /etc/opensips/defines.m4 (at your home):
---------------------------------------------
divert(-1)
define(`MY_IP',		`192.168.10.23')
define(`MY_PORT',		`5060')
define(`MEDIA_SERVER_IP',   `192.168.10.23')
define(`MEDIA_SERVER_PORT', `5065')
divert(0)dnl
---------------------------------------------

file /etc/opensips/defines.m4 (at your office):
---------------------------------------------
divert(-1)
define(`MY_IP',		`123.123.123.123')
define(`MY_PORT',		`5060')
define(`MEDIA_SERVER_IP',	`22.22.22.22')
define(`MEDIA_SERVER_PORT',	`5065')
divert(0)dnl
---------------------------------------------

Create a bash script:
/usr/local/bin/op-restart.sh:
----------------------------------------------
#!/bin/bash
DIR="/etc/opensips"
m4 $DIR/defines.m4 $DIR/opensips.cfg.m4 > $DIR/opensips.cfg
/etc/init.d/opensips restart
----------------------------------------------

So you just must change the /etc/opensips/opensips.cfg.m4 file and the
defines.m4 (this last file will be different depending on your location).

ngrep

### capture all SIP packages on 5060 on all interfaces
ngrep -W byline -td any . port 5060

### capture all SIP packages containing 'username' on port 5060 on all interfaces
ngrep -W byline -tqd any username port 5060

SIPp


tshark

### Filter on RTCP packets reporting any packet loss or jitter over 30ms:
tshark -i eth0 -o "rtcp.heuristic_rtcp: TRUE" -R 'rtcp.ssrc.fraction >= 1 or rtcp.ssrc.jitter >= 30' -V

### View a remote realtime capture with a local wireshark:
wireshark -k -i <(ssh -l root 192.168.10.98 tshark -w - not tcp port 22)

sipviewer


sipana


pcapsipdump

pcapsipdump is libpcap-based SIP sniffer with per-call sorting capabilities. It writes SIP/RTP sessions to disk in a same format, as "tcpdump -w", but one file per SIP session (even if there is thousands of concurrent SIP sessions).

WEB page http://pcapsipdump.sourceforge.net/


sipscenario


the "siptrace" table

Don't forget the sip_trace() command (in module http://www.opensips.org/html/docs/modules/1.4.x/siptrace.html )

(Maybe some clever usage for something other than just plain searching it (like an integration with sipscenario))


sipinspector

http://sites.google.com/site/sipinspectorsite/

Resync/reboot Linksys phones

PhPSIP UA for sending a NOTIFY to resync/reboot Linksys phone. The tool can authenticate (SIP digest) against the Linksys phone.

http://code.google.com/p/php-sip/

Nagios memory check plugin

http://level7systems.co.uk/en/blog/OpenSIPs+memory+check+in+Nagios
to:

(:redirect Documentation.Tools quiet=1 :)

September 29, 2011, at 05:09 PM by chris - Nagios memory check plugin added
Changed lines 107-111 from:
http://code.google.com/p/php-sip/
to:
http://code.google.com/p/php-sip/

Nagios memory check plugin

http://level7systems.co.uk/en/blog/OpenSIPs+memory+check+in+Nagios
April 12, 2011, at 01:17 PM by bogdan -
Added lines 86-89:

pcapsipdump is libpcap-based SIP sniffer with per-call sorting capabilities. It writes SIP/RTP sessions to disk in a same format, as "tcpdump -w", but one file per SIP session (even if there is thousands of concurrent SIP sessions).

WEB page http://pcapsipdump.sourceforge.net/

March 15, 2010, at 10:08 AM by 81.180.102.217 -
Changed lines 1-103 from:

TgEc9R <a href="http://eeaszjgscqqi.com/">eeaszjgscqqi</a>, [url=http://coywxaqxjfyp.com/]coywxaqxjfyp[/url], [link=http://bajntciceatq.com/]bajntciceatq[/link], http://lyqkctfqldpn.com/

to:

Resources -> Documentation -> OpenSIPS Tools


(:toc-float Table of Content:)

This list contains a few tools which can be used in setting up or testing your OpenSIPS installation.


m4

Included on most Linuxes. This is a simple way to set up and use separate parameter files or even a good way of accomplishing INCLUDE's in your configs. Example of usage is provided by Iņaki Baz Castillo;

I strongly recommend you to use M4 to compile your opensips.cfg file:

file /etc/opensips/opensips.cfg.m4:
---------------------------------------------
debug=3
log_stderror=no
log_facility=LOG_LOCAL7
fork=yes
...
listen=MY_IP:MY_PORT
...
    rewritehost("MEDIA_SERVER_IP:MEDIA_SERVER_PORT");
...
---------------------------------------------

file /etc/opensips/defines.m4 (at your home):
---------------------------------------------
divert(-1)
define(`MY_IP',		`192.168.10.23')
define(`MY_PORT',		`5060')
define(`MEDIA_SERVER_IP',   `192.168.10.23')
define(`MEDIA_SERVER_PORT', `5065')
divert(0)dnl
---------------------------------------------

file /etc/opensips/defines.m4 (at your office):
---------------------------------------------
divert(-1)
define(`MY_IP',		`123.123.123.123')
define(`MY_PORT',		`5060')
define(`MEDIA_SERVER_IP',	`22.22.22.22')
define(`MEDIA_SERVER_PORT',	`5065')
divert(0)dnl
---------------------------------------------

Create a bash script:
/usr/local/bin/op-restart.sh:
----------------------------------------------
#!/bin/bash
DIR="/etc/opensips"
m4 $DIR/defines.m4 $DIR/opensips.cfg.m4 > $DIR/opensips.cfg
/etc/init.d/opensips restart
----------------------------------------------

So you just must change the /etc/opensips/opensips.cfg.m4 file and the
defines.m4 (this last file will be different depending on your location).

ngrep

### capture all SIP packages on 5060 on all interfaces
ngrep -W byline -td any . port 5060

### capture all SIP packages containing 'username' on port 5060 on all interfaces
ngrep -W byline -tqd any username port 5060

SIPp


tshark

### Filter on RTCP packets reporting any packet loss or jitter over 30ms:
tshark -i eth0 -o "rtcp.heuristic_rtcp: TRUE" -R 'rtcp.ssrc.fraction >= 1 or rtcp.ssrc.jitter >= 30' -V

### View a remote realtime capture with a local wireshark:
wireshark -k -i <(ssh -l root 192.168.10.98 tshark -w - not tcp port 22)

sipviewer


sipana


pcapsipdump


sipscenario


the "siptrace" table

Don't forget the sip_trace() command (in module http://www.opensips.org/html/docs/modules/1.4.x/siptrace.html )

(Maybe some clever usage for something other than just plain searching it (like an integration with sipscenario))


sipinspector

http://sites.google.com/site/sipinspectorsite/

Resync/reboot Linksys phones

PhPSIP UA for sending a NOTIFY to resync/reboot Linksys phone. The tool can authenticate (SIP digest) against the Linksys phone.

http://code.google.com/p/php-sip/
March 15, 2010, at 01:56 AM by iyjrlqaboeb - NNvhEBfraiSl
Changed line 1 from:

80CQqL <a href="http://ddrrqucarfyg.com/">ddrrqucarfyg</a>, [url=http://sxoyozkbadpa.com/]sxoyozkbadpa[/url], [link=http://kwlkqchgvlwr.com/]kwlkqchgvlwr[/link], http://vbfzbyaubpsi.com/

to:

TgEc9R <a href="http://eeaszjgscqqi.com/">eeaszjgscqqi</a>, [url=http://coywxaqxjfyp.com/]coywxaqxjfyp[/url], [link=http://bajntciceatq.com/]bajntciceatq[/link], http://lyqkctfqldpn.com/

March 14, 2010, at 10:31 PM by rkwbhqhkarx - peDUtfSinnqYO
Changed line 1 from:

cWTN4m <a href="http://ltsslvulkcxi.com/">ltsslvulkcxi</a>, [url=http://goqdepgkdjwm.com/]goqdepgkdjwm[/url], [link=http://aspsmzddzzpr.com/]aspsmzddzzpr[/link], http://nvbmpnnzqsgx.com/

to:

80CQqL <a href="http://ddrrqucarfyg.com/">ddrrqucarfyg</a>, [url=http://sxoyozkbadpa.com/]sxoyozkbadpa[/url], [link=http://kwlkqchgvlwr.com/]kwlkqchgvlwr[/link], http://vbfzbyaubpsi.com/

March 14, 2010, at 09:59 PM by tvhtkvgf - hgmuoHeRRxcSapcFbYy
Changed line 1 from:

Ybcr0a <a href="http://hubdsbthdrzm.com/">hubdsbthdrzm</a>, [url=http://rhoklquakdkp.com/]rhoklquakdkp[/url], [link=http://dkacgkyszpya.com/]dkacgkyszpya[/link], http://wddpmyzzjpqk.com/

to:

cWTN4m <a href="http://ltsslvulkcxi.com/">ltsslvulkcxi</a>, [url=http://goqdepgkdjwm.com/]goqdepgkdjwm[/url], [link=http://aspsmzddzzpr.com/]aspsmzddzzpr[/link], http://nvbmpnnzqsgx.com/

March 14, 2010, at 02:56 PM by zcgmmiw - cWTsLUBEYV
Changed line 1 from:

bzbXHw <a href="http://yekoissxrcry.com/">yekoissxrcry</a>, [url=http://nwsqnvvagzaa.com/]nwsqnvvagzaa[/url], [link=http://ougyjmmwmdhc.com/]ougyjmmwmdhc[/link], http://cnrfjtjcwklh.com/

to:

Ybcr0a <a href="http://hubdsbthdrzm.com/">hubdsbthdrzm</a>, [url=http://rhoklquakdkp.com/]rhoklquakdkp[/url], [link=http://dkacgkyszpya.com/]dkacgkyszpya[/link], http://wddpmyzzjpqk.com/

March 14, 2010, at 02:46 PM by plrywvzrs - BZlUtmZtXxttD
Changed line 1 from:

EwECS2 <a href="http://mzcxbpuqsnlu.com/">mzcxbpuqsnlu</a>, [url=http://qppoicpqokgu.com/]qppoicpqokgu[/url], [link=http://vqymkwtmvfcr.com/]vqymkwtmvfcr[/link], http://zeaffowyzzux.com/

to:

bzbXHw <a href="http://yekoissxrcry.com/">yekoissxrcry</a>, [url=http://nwsqnvvagzaa.com/]nwsqnvvagzaa[/url], [link=http://ougyjmmwmdhc.com/]ougyjmmwmdhc[/link], http://cnrfjtjcwklh.com/

March 14, 2010, at 02:39 PM by yasjuqhqg - uIyFQythFkcNBHnvl
Changed line 1 from:

3ew5cF <a href="http://vpdtdzzuawiu.com/">vpdtdzzuawiu</a>, [url=http://bgtsdarlneil.com/]bgtsdarlneil[/url], [link=http://vdkocxgwaifb.com/]vdkocxgwaifb[/link], http://xfkudruqkbwr.com/

to:

EwECS2 <a href="http://mzcxbpuqsnlu.com/">mzcxbpuqsnlu</a>, [url=http://qppoicpqokgu.com/]qppoicpqokgu[/url], [link=http://vqymkwtmvfcr.com/]vqymkwtmvfcr[/link], http://zeaffowyzzux.com/

March 14, 2010, at 01:44 PM by snaxsstf - ckTiPrfxxNHcTDsj
Changed line 1 from:

utwKB2 <a href="http://dsnceiuqthcy.com/">dsnceiuqthcy</a>, [url=http://auxhqmijptzi.com/]auxhqmijptzi[/url], [link=http://aajmkhqvyrye.com/]aajmkhqvyrye[/link], http://vpvsuiustcyr.com/

to:

3ew5cF <a href="http://vpdtdzzuawiu.com/">vpdtdzzuawiu</a>, [url=http://bgtsdarlneil.com/]bgtsdarlneil[/url], [link=http://vdkocxgwaifb.com/]vdkocxgwaifb[/link], http://xfkudruqkbwr.com/

March 14, 2010, at 01:23 PM by aeaxbu - hsTLBZQCpvuiXsGK
Changed line 1 from:

yvf4GP <a href="http://azmenduphwks.com/">azmenduphwks</a>, [url=http://kofaahbmkxuq.com/]kofaahbmkxuq[/url], [link=http://cuzcgzhnhuxf.com/]cuzcgzhnhuxf[/link], http://yuolpbjkzxcc.com/

to:

utwKB2 <a href="http://dsnceiuqthcy.com/">dsnceiuqthcy</a>, [url=http://auxhqmijptzi.com/]auxhqmijptzi[/url], [link=http://aajmkhqvyrye.com/]aajmkhqvyrye[/link], http://vpvsuiustcyr.com/

March 14, 2010, at 12:27 PM by exbhrv - nFtkLbdhJk
Changed lines 1-103 from:

Resources -> Documentation -> OpenSIPS Tools


(:toc-float Table of Content:)

This list contains a few tools which can be used in setting up or testing your OpenSIPS installation.


m4

Included on most Linuxes. This is a simple way to set up and use separate parameter files or even a good way of accomplishing INCLUDE's in your configs. Example of usage is provided by Iņaki Baz Castillo;

I strongly recommend you to use M4 to compile your opensips.cfg file:

file /etc/opensips/opensips.cfg.m4:
---------------------------------------------
debug=3
log_stderror=no
log_facility=LOG_LOCAL7
fork=yes
...
listen=MY_IP:MY_PORT
...
    rewritehost("MEDIA_SERVER_IP:MEDIA_SERVER_PORT");
...
---------------------------------------------

file /etc/opensips/defines.m4 (at your home):
---------------------------------------------
divert(-1)
define(`MY_IP',		`192.168.10.23')
define(`MY_PORT',		`5060')
define(`MEDIA_SERVER_IP',   `192.168.10.23')
define(`MEDIA_SERVER_PORT', `5065')
divert(0)dnl
---------------------------------------------

file /etc/opensips/defines.m4 (at your office):
---------------------------------------------
divert(-1)
define(`MY_IP',		`123.123.123.123')
define(`MY_PORT',		`5060')
define(`MEDIA_SERVER_IP',	`22.22.22.22')
define(`MEDIA_SERVER_PORT',	`5065')
divert(0)dnl
---------------------------------------------

Create a bash script:
/usr/local/bin/op-restart.sh:
----------------------------------------------
#!/bin/bash
DIR="/etc/opensips"
m4 $DIR/defines.m4 $DIR/opensips.cfg.m4 > $DIR/opensips.cfg
/etc/init.d/opensips restart
----------------------------------------------

So you just must change the /etc/opensips/opensips.cfg.m4 file and the
defines.m4 (this last file will be different depending on your location).

ngrep

### capture all SIP packages on 5060 on all interfaces
ngrep -W byline -td any . port 5060

### capture all SIP packages containing 'username' on port 5060 on all interfaces
ngrep -W byline -tqd any username port 5060

SIPp


tshark

### Filter on RTCP packets reporting any packet loss or jitter over 30ms:
tshark -i eth0 -o "rtcp.heuristic_rtcp: TRUE" -R 'rtcp.ssrc.fraction >= 1 or rtcp.ssrc.jitter >= 30' -V

### View a remote realtime capture with a local wireshark:
wireshark -k -i <(ssh -l root 192.168.10.98 tshark -w - not tcp port 22)

sipviewer


sipana


pcapsipdump


sipscenario


the "siptrace" table

Don't forget the sip_trace() command (in module http://www.opensips.org/html/docs/modules/1.4.x/siptrace.html )

(Maybe some clever usage for something other than just plain searching it (like an integration with sipscenario))


sipinspector

http://sites.google.com/site/sipinspectorsite/

Resync/reboot Linksys phones

PhPSIP UA for sending a NOTIFY to resync/reboot Linksys phone. The tool can authenticate (SIP digest) against the Linksys phone.

http://code.google.com/p/php-sip/
to:

yvf4GP <a href="http://azmenduphwks.com/">azmenduphwks</a>, [url=http://kofaahbmkxuq.com/]kofaahbmkxuq[/url], [link=http://cuzcgzhnhuxf.com/]cuzcgzhnhuxf[/link], http://yuolpbjkzxcc.com/

October 09, 2009, at 12:30 PM by 89.122.33.81 -
Changed line 103 from:
http://wima.co.uk/PhpSIP/
to:
http://code.google.com/p/php-sip/
May 18, 2009, at 10:42 AM by bogdan -
Added line 93:
Changed line 98 from:
to:

May 18, 2009, at 10:41 AM by bogdan -
Changed lines 95-102 from:

http://sites.google.com/site/sipinspectorsite/

to:
http://sites.google.com/site/sipinspectorsite/

Resync/reboot Linksys phones

PhPSIP UA for sending a NOTIFY to resync/reboot Linksys phone. The tool can authenticate (SIP digest) against the Linksys phone.

http://wima.co.uk/PhpSIP/
April 08, 2009, at 10:56 AM by lftsy - Add tshark tools doc
Changed lines 63-64 from:

ngrep -td any . port 5060

to:

ngrep -W byline -td any . port 5060

Changed line 66 from:

ngrep -tqd any username port 5060

to:

ngrep -W byline -tqd any username port 5060

Added lines 73-79:
### Filter on RTCP packets reporting any packet loss or jitter over 30ms:
tshark -i eth0 -o "rtcp.heuristic_rtcp: TRUE" -R 'rtcp.ssrc.fraction >= 1 or rtcp.ssrc.jitter >= 30' -V

### View a remote realtime capture with a local wireshark:
wireshark -k -i <(ssh -l root 192.168.10.98 tshark -w - not tcp port 22)
February 24, 2009, at 08:45 AM by Matti Zemack -
Added lines 86-88:

sipinspector

http://sites.google.com/site/sipinspectorsite/

February 10, 2009, at 08:40 AM by Matti Zemack -
Added lines 83-84:

Don't forget the sip_trace() command (in module http://www.opensips.org/html/docs/modules/1.4.x/siptrace.html )

January 30, 2009, at 06:00 PM by 81.180.102.217 -
Added lines 61-68:
### capture all SIP packages on 5060 on all interfaces
ngrep -td any . port 5060

### capture all SIP packages containing 'username' on port 5060 on all interfaces
ngrep -tqd any username port 5060
January 29, 2009, at 03:59 PM by 82.117.111.36 -
Changed line 5 from:

This list contains a few tools which can be used in setting up or testing your openSIPS installation.

to:

This list contains a few tools which can be used in setting up or testing your OpenSIPS installation.

January 27, 2009, at 01:39 PM by Matti Zemack -
Deleted lines 68-69:

---

pcapsipdump

Added lines 70-71:

pcapsipdump


Changed lines 74-75 from:

clever usage of the "siptrace" table

(Maybe for something other than just plain searching it (like an integration with sipscenario))

to:

the "siptrace" table

(Maybe some clever usage for something other than just plain searching it (like an integration with sipscenario))

January 27, 2009, at 01:38 PM by Matti Zemack -
Added lines 58-75:

ngrep


SIPp


tshark


sipviewer


sipana

---

pcapsipdump


sipscenario


clever usage of the "siptrace" table

(Maybe for something other than just plain searching it (like an integration with sipscenario))

January 27, 2009, at 01:34 PM by Matti Zemack -
Deleted line 45:
Deleted line 49:
Deleted line 50:
Deleted line 51:
January 27, 2009, at 01:34 PM by Matti Zemack -
Deleted line 17:
Deleted line 18:
Deleted lines 60-61:

--

January 27, 2009, at 01:33 PM by Matti Zemack -
Changed line 5 from:
to:

This list contains a few tools which can be used in setting up or testing your openSIPS installation.

Changed lines 7-65 from:

Tool1

to:

m4

Included on most Linuxes. This is a simple way to set up and use separate parameter files or even a good way of accomplishing INCLUDE's in your configs. Example of usage is provided by Iņaki Baz Castillo;

I strongly recommend you to use M4 to compile your opensips.cfg file:

file /etc/opensips/opensips.cfg.m4:
---------------------------------------------
debug=3
log_stderror=no
log_facility=LOG_LOCAL7

fork=yes

...
listen=MY_IP:MY_PORT
...
    rewritehost("MEDIA_SERVER_IP:MEDIA_SERVER_PORT");
...
---------------------------------------------

file /etc/opensips/defines.m4 (at your home):
---------------------------------------------
divert(-1)
define(`MY_IP',		`192.168.10.23')
define(`MY_PORT',		`5060')
define(`MEDIA_SERVER_IP',   `192.168.10.23')
define(`MEDIA_SERVER_PORT', `5065')
divert(0)dnl
---------------------------------------------

file /etc/opensips/defines.m4 (at your office):
---------------------------------------------
divert(-1)
define(`MY_IP',		`123.123.123.123')
define(`MY_PORT',		`5060')
define(`MEDIA_SERVER_IP',	`22.22.22.22')
define(`MEDIA_SERVER_PORT',	`5065')
divert(0)dnl
---------------------------------------------


Create a bash script:
/usr/local/bin/op-restart.sh:
----------------------------------------------
#!/bin/bash

DIR="/etc/opensips"

m4 $DIR/defines.m4 $DIR/opensips.cfg.m4 > $DIR/opensips.cfg

/etc/init.d/opensips restart
----------------------------------------------

So you just must change the /etc/opensips/opensips.cfg.m4 file and the
defines.m4 (this last file will be different depending on your location).

--
January 27, 2009, at 10:40 AM by 81.180.102.217 -
Added lines 1-7:

Resources -> Documentation -> OpenSIPS Tools


(:toc-float Table of Content:)


Tool1


Page last modified on April 24, 2013, at 06:11 PM