GUI Installation

GUI installation

Installing GUI for the first time

The GUI requires some additional packages to be installed/configured - the steps of installing GUI varies by OS/distribution used. Please follow the GUI installation Content of our doc in Install section for your linux distro

Re-installing the GUI

After php upgrade

If you upgraded the OS or php and the GUI pages failed to load/display - It is sufficent to re-install the ioncube for php and GUI package of voipmonitor.

Check your current ioncube configuration

grep 'ioncube' /etc -Inri

and remove the old configuration file usually 00ioncube from the location

Check your php version

php --version

Install new ioncube

Example is for php 8.1 in kubu 22.04

wget http://voipmonitor.org/ioncube/x86_64/ioncube_loader_lin_8.1.so -O /usr/lib/php/8.1/ioncube_loader_lin_8.1.so
echo 'zend_extension = /usr/lib/php/8.1/ioncube_loader_lin_8.1.so' > /etc/php/8.1/cli/conf.d/01-ioncube.ini
echo 'zend_extension = /usr/lib/php/8.1/ioncube_loader_lin_8.1.so' > /etc/php/8.1/apache2/conf.d/01-ioncube.ini
service apache2 restart

Notes: Please, take care on version of ioncube you will download(its php version dependant), also take care on the destination folder you are storing the module to and the confline you will add to .ini files.

Install the GUI

First backup current/previous - expected is default GUI location in /var/www/html

cp -a /var/www/html /var/www/html-backup
mkdir /tmp/new
cd /tmp/new
#download the GUI package for your php from our site. https://www.voipmonitor.org/download
wget "http://www.voipmonitor.org/download-gui?version=latest&major=5&phpver=81&festry" -O w.tar.gz
tar -xzf w.tar.gz
cd voipmonitor*/scripts
bash install-gui ../../w.tar.gz
#follow on line instructions - you should know where the voip traffic comming - which interface, and how much space you can allocate for packets records - for spoolir

From develop link

In case you reported some flaw in a GUI, you can be asked by our support members to apply the develop release of the GUI to fix the problem you are facing. In this case you will be asked for telling the version of your php and you will get the link of the package for your php version. Steps to install GUI from link sent by our team.

Backup current version

cp -a /var/www/html /var/www/html-backup

Download the package file (example is for 81version),unpack and start install script

#needs to be empty
mkdir /tmp/guidevel
cd /tmp/guidevel
wget https://download.voipmonitor.org/sniffer-develop/voipmonitor-gui-25.5-SVN.81.tar.gz -O w.tar.gz
tar -xzf w.tar.gz
cd voipmonitor*/script
bash install-gui ../../w.tar.gz
#after you choose the correct dest folder to install GUI to, logout from the GUI by the browser, hit CTRL+SHIFT+C in chrome to reload the page's content including CACHE and login tp new GUI version.

Examples of paths for modules stored for various versions of php in deb10

/etc/php/7.4/apache2/conf.d/01-ioncube.ini:1:zend_extension = /usr/lib/php/20190902/ioncube_loader_lin_7.4.so
/etc/php/7.4/cli/conf.d/01-ioncube.ini:1:zend_extension = /usr/lib/php/20190902/ioncube_loader_lin_7.4.so
/etc/php/7.3/apache2/conf.d/01-ioncube.ini:1:zend_extension = /usr/lib/php/20180731/ioncube_loader_lin_7.3.so
/etc/php/7.3/cli/conf.d/01-ioncube.ini:1:zend_extension = /usr/lib/php/20180731/ioncube_loader_lin_7.3.so
/etc/php/7.2/apache2/conf.d/01-ioncube.ini:1:zend_extension = /usr/lib/php/20170718/ioncube_loader_lin_7.2.so
/etc/php/7.2/cli/conf.d/01-ioncube.ini:1:zend_extension = /usr/lib/php/20170718/ioncube_loader_lin_7.2.so

Note: old GUI installation