OpenSIPs CP no Debian com OpenSIPs 1.9

Prefacio

O OpenSIPs CP é um painel de controle para as funções básicas do OpenSIPS sua instalação não é complexa, porém baseado na forma modular do OpenSIPs é necessário entender bem oque você precisa executar/instalar para o correto funcionamento.

Dependencias

Antes de mais nada é preciso ter o OpenSIPs instalado e funcionando, este tutorial é montado sobre a instalação da versão Opensips 1.9 que temos neste wiki, apenas as funcionalidades desta instalação serão cobertas por este tutorial, então siga todas as instruções que descrevemos no tutorial para ter um perfeito funcionamento, logo você entenderá melhor cada função e poderá fazer uma instalação tanto do OpenSIPS quanto do OpenSIPS CP mais customizada para suas necessidades.

Apache e PHP

Para rodar esta aplicação precisamos instalar o apache e os módulos de php necessários, se você tiver familiaridade com outro servidor web como lighttpd ou outro fique avontade em testar a instalação, basicamente precisamos do suporte ao php ativado , vamos seguir utilizando o apache pois é o web server que costumo utilizar.

apt-get install apache2-mpm-prefork libapache2-mod-php5 php5-mysql php5-curl php5-xmlrpc

PEAR

pear install MDB2
pear install MDB2#mysql
pear install log

OpenSIP CP

cd /usr/src/
wget -c http://downloads.sourceforge.net/project/opensips-cp/opensips-cp/5.0/opensips-cp_5.0.tgz?r=http%3A%2F%2Fsourceforge.net%2Fprojects%2Fopensips-cp%2Ffiles%2F&ts=1403145228&use_mirror=ufpr

Renomeie o arquivo do download para opensips-cp-5.0.tgz e depois descompacte
tar -xzvf opensips-cp-5.0.tgz

Instalando

Dentro do diretorio 5.0 temos os seguintes diretórios

config - arquivos de configuração para o banco e outras funcionalidades
cron_job - arquivos de cron, em especial o arquivo que junta as informações de dialogos para gerar o cdr
doc - documentacao
web - Arquivos web
INSTALL - as mesmas instruções que temos aqui :)
README - explicação sobre oque é o que dentro da estrutura

Nós iremos seguir baseado no conteúdo do README

Copiando os arquivos para o diretorio web

cd /usr/src
mv 5.0 /var/www/opensips-cp

Criando alias no apache

Abra o arquivo /etc/apache2/sites-enable/000-default , acrescente ao fim do arquivo (antes da tag </VirtualHost>)

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

Reiniciando o apache

/etc/init.d/apache2 restart
chown www-data.www-data /var/www/opensips-cp/config/access.log

Instalando as tabelas

cd /var/www/opensips-cp/config/tools/admin/add_admin
mysql -uopensips -popensipsrw opensips < ocp_admin_privileges.mysql

cd /var/www/opensips-cp/config/tools/system/cdrviewer
mysql -uopensips -popensipsrw opensips < cdrs.mysql
mysql -uopensips -popensipsrw opensips < cdrs.mysql

Feito isso entre no mysql e adicione o usuário de administração

INSERT INTO ocp_admin_privileges (username,password,ha1,available_tools,permissions) values ('admin','admin',md5('admin:admin'),'all','all');

Adicionando ao cron

cd /var/www/opensips-cp/cron_job

Edite o arquivo generate-cdrs_mysql.sh e altere os parametros de conexão, também altere

call opensips_cdrs_1_6();

para

call opensips_cdrs();

Acrescente em seu arquivo /etc/crontab a seguinte entrada

        */3 * * * * root /var/www/opensips-cp/cron_job/generate-cdrs_mysql.sh

Configuração Geral

Agora que fizemos as configurações básicas, precisamos gerar as configurações nos módulos que utilizaremos.

Abra o arquivo /var/www/opensips-cp/config/db.inc.php e altere os parametros de banco de dados Abra o arquivo /var/www/opensips-cp/config/boxes.global.inc.php , e descomente a linha

$boxes[$box_id]['mi']['conn']="/tmp/opensips_fifo";

Acessando a interface

Agora coloque em seu browser http://__SEU__IP__/cp , entre com usuario e senha admin e pronto, você está na tela do opensipscp, através desta você poderá criar usuários e realizar outras operações.

Ajustando os módulos

Não sei bem se por erro ou outra razão porém muitos módulos necessitam de alguns ajustes especiais, vamos tratar os mesmos aqui.

dialog

Arquivo: /var/www/opensips-cp/config/tools/system/dialog/local.inc.php

Altere o parametro:

 $box[1]['mi']['conn']="/tmp/opensips_proxy_fifo";;

para

 $box[1]['mi']['conn']="/tmp/opensips_fifo";;

Existem outros módulos ainda que você pode precisar criar algumas tabelas adicionais, porém vamos deixar isso para um outro tutorial, o objetivo deste é apenas por a ferramenta pra funcionar com funcionalidades básicas.

siptrace

O siptrace é necessário ativar pois ele não é coberto em nossa instalação, de forma básica, você deve chamar o módulo em seu opensips.cfg (após a configuração do dialog

### SIP TRACE

loadmodule "siptrace.so"
modparam("siptrace", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")
modparam("siptrace", "trace_flag", "TRACE_FLAG")
modparam("siptrace", "trace_on", 0)
modparam("siptrace", "enable_ack_trace", 1)
modparam("siptrace", "traced_user_avp", "$avp(traced_user)")

finalmente localize a seguinte entrada

if (is_method("INVITE")) {

                # create dialog with timeout
                if ( !create_dialog("B") ) {
                        send_reply("500","Internal Server Error");
                        exit;
                }

                setflag(ACC_DO); # do accounting

        }

E logo após o setflag, acrescente

                trace_dialog();

Altere o arquivo /var/www/opensips-cp/config/tools/system/siptrace/local.inc.php e altere o conteúdo de proxy_list para os ips que você está usando em seu opensips

$proxy_list=array("udp:192.168.0.6:5060","tcp:192.168.0.6:5060");

Desta forma o siptrace esta desativado, para ativar durante a execução do seu opensips, basta enviar o comando

opensipsctl fifo sip_trace on

Ou então pela propria interface voce pode ativar e desativar o recurso.

Abaixo você pode ver o resultado desta utilização