Sniffer installation

Jump to navigation Jump to search

VoIP monitor sniffer can be installed in two ways - either as static binary which will run on any Linux distribution with kernels >= 2.6.18 or compiled from sources.

Latest Static binary

Static binary for 32bit,64bit or Arm arch can be downloaded from pages.

Step by step for 64bit linux procedure

wget --content-disposition --no-check-certificate
tar xzf voipmonitor-*-static.tar.gz
cd voipmonitor-*-static

Step by step for 32bit linux procedure

wget --content-disposition --no-check-certificate
tar xzf voipmonitor-*-static.tar.gz
cd voipmonitor-*-static

Step by step for ArmV6(RPI) linux

wget --content-disposition --no-check-certificate
tar xzf voipmonitor-*-static.tar.gz
cd voipmonitor-*-static

Older static versions and versions with SS7(wireshark) module

If you need for any reason to install older version of a sniffer or version including wireshark's SS7 module follow:

Install sniffer version of your choice

Find voipmonitor*.tar.gz file of your choice at following site and use the link for wget command in step by step above

Example of wget command for version 20.4.4 with ss7(wireshark) module

wget -O voipmonitor-wireshark-amd64-20.4.4-static.tar.gz --content-disposition --no-check-certificate

Newest static versions from develop branch

Upgrade of a sniffer service step by step 64bit

Note: The link and version will be shared by the support team - changes the wget command and cp command which is version specific:

mkdir /tmp/new
cd /tmp/new/
wget -O ./sniffer.tar.gz
tar -xzf ./sniffer.tar.gz
cp /usr/local/sbin/voipmonitor /usr/local/sbin/voipmonitor.backup
service voipmonitor stop
cp voipmonitor-amd64-23.1-static/usr/local/sbin/voipmonitor /usr/local/sbin/voipmonitor
service voipmonitor start

Configuration of a sniffer

Now edit configuration file /etc/voipmonitor.conf and run voipmonitor

/etc/init.d/voipmonitor start

Systemd script for bringing up voipmonitor service at a boot time

If your system uses systemd for services management create a systemd startup script

Compile shared binary

Please see README.* inside the sources (we recommend to use the static version)

git clone -b master

Or develop branch

git clone -b develop

Sniffer uninstallation

cleaning script for SysV based systems

Here is simple cleaning script.



echo "Stopping $SENSOR"

echo "Uninstalling /$SHAREDIR"
rm -rf /$SHAREDIR

echo "Uninstalling $SENSOR binary from /$BINDIR/$SENSOR"

echo "Moving /$CFGDIR/$SENSOR.conf to /$CFGDIR/$SENSOR.conf-backup."
mv /$CFGDIR/$SENSOR.conf /$CFGDIR/$SENSOR.conf-backup

echo "Deleting $SPOOLDIR"
rm -rf $SPOOLDIR

update-rc.d $SENSOR remove &>/dev/null
chkconfig $SENSOR off &>/dev/null
chkconfig --del $SENSOR &>/dev/null

echo "Deleting starting script /$INITDIR/$SENSOR"

echo "The database is not deleted. Do it manually.";

cleaning commands for systemd based systems

For systemd based OSes use following commands (when chkconfig missing and paths in /etc/voipmonitor.conf kept default)

systemctl disable voipmonitor
rm /usr/local/sbin/voipmonitor
rm /etc/init.d/voipmonitor
rm /etc/voipmonitor.conf
rm -rf /var/spool/voipmonitor

remove also CDRs?

Consider to drop database, where are CDRs kept in case db used locally and you need to remove it, if db not used there anymore you can also uninstall db(mysql/mariadb) using system commands and remove its datadir /var/lib/mysql

mysqladmin drop database voipmonitor
mysql -e 'drop database voipmonitor'
#systemctl disable mariadb
#rm -rf /varlib/mysql

FreeBSD 11