OpenSIPS Control Panel

This tool, also known as opensips-cp, is the new graphical user interface for the SIP proxy. It was designed to be the primary tool to provision parameters for the OpenSIPS modules in the database.

The screenshot shows the tools available for OpenSIPS Control Panel. This tool is focused on the provisioning of system parameters. As it is usual for the VoIP providers to develop their own interface with the end users, the tools to manage end users are not available. Developed using PHP, opensips-cp currently features the following modules:

• CDRviewer
• dialplan
• domains
• dispatcher
• drouting
• load balancer
• Mi
• Monit
• nathelper
• pdt
• Permissions
• siptrace
• smonitor

Installation of opensips-cp

The step-by-step instructions to install opensips-cp in a server with Debian 5.0 are as follows:

Installation instructions change very often. For updates, check the opensips-cp project’s website at http://opensipscp.sourceforge.net/.

Step 1: Install Apache and PHP as follows:

apt-get install apache2 php5

Step 2: Install php5-mysql and php5-xmlrpc packages, and set the right parameters in the php.ini file. (It has been done for you to save time.)

apt-get install php5-mysql php5-xmlrpc php-pear
vi /etc/php5/apache2/php.ini

Please verify that you have set the short_open_tag = On ; option in your php.ini file.

Step 3: Download opensips-cp and untar the file.

Download opensips-cp from http://opensips-cp.sourceforge.net/index.php?req=download (or copy from DVD) and copy the opensip-cp_3.0.tgz file to /var/www as follows:

cd /var/www
wget http://sourceforge.net/projects/opensips-cp/files/opensipscp/
3.0/opensips-cp_3.0.tgz/download
tar -xzvf opensips-cp_3.0.tgz
chown www-data:www-data opensips-cp -R

Step 4: Install MDB2.

pear install MDB2
pear install MDB2#mysql
pear install log

Step 5: Configure Apache for OpenSIPS Control Panel. Edit the apache2.conf file.

vi /etc/apache2/apache2.conf

After doing so, include the following line below the last line:

Alias /cp "/var/www/opensips-cp/web"

Also, change the owner of the log file:

chown www-data:www-data /var/www/opensips-cp/config/access.log

Step 6: Install the cdr table schema:

cd /var/www/opensips-cp/web/tools/cdrviewer
mysql -D opensips -p < cdrs.sql
mysql -u root -p
mysql> use opensips
mysql -D opensips -p < opensips_cdrs_1_6.mysql

Step 7: Edit the cron_job/generate-cdrs.sh file and change the MySQL connection data (hostname, username, password, and database) as follows:

cd /var/www/opensips-cp/cron-job
vi generate_cdrs.sh

Step 8: Edit the /etc/crontab file and add the following line for a three-minute interval:

vi /etc/crontab
*/3 * * * * root /var/www/opensips-cp/cron_job/generate-cdrs.sh

Step 9: For the smonitor module, you must add two tables to the OpenSIPS database:

cd /var/www/opensips-cp/web/tools/smonitor
mysql -p opensips <tables.sql

Step 10: Add a cron job that collects data from the OpenSIPS machine(s). Here is a cron job that collects data at a one-minute interval. (This interval is not arbitrary. It must be set to one minute by design.)

vi /etc/crontab
* * * * * root php /var/www/opensips-cp/cron_job/get_opensips_stats.php >
/dev/null

The cron jobs do not need to run as root. You might want to change the user.

Step 11: Restart OpenSIPS and Apache.