Tutorial de Instalação Instalação do Sneplivre 1.3.8 (fonte) em Asterisk 1.4.44 Distribuição Ubuntu Server 12.04 LTS (64 bits) Elaborado por: Urik B. da Silva E-mail: urikbs@gmail.com Atualizado em: 30/10/2012 Tutorial Sneplivre 1/16
Atribuição Uso não-comercial Compartilhamento pela mesma licença 2.5 Brasil Você pode: Copiar, distribuir, exibir e executar a obra. Sob as seguintes condições: Atribuição: Você deve dar crédito ao autor original, da forma especificada pelo autor ou licenciante. Uso não-comercial: Você não pode utilizar esta obra com finalidades comerciais Compartilhamento pela mesma licença: Se você alterar, transformar ou criar outra obra com base nesta, você somente poderá distribuir a obra resultante sob uma licença idêntica a esta. A reprodução do material contido neste tutorial é permitido desde que se incluam os créditos ao autor e a frase: Reproduzido de Instalação do Sneplivre 1.3.8 (fonte) em Asterisk 1.4.44 Distribuição Ubuntu Server 12.04 LTS (64 bits) Urik B. Da Silva em local visível. Tutorial Sneplivre 2/16
Índice de ilustrações Ilustração 1: Definindo senha de root do banco de dados MySQL...7 Ilustração 2: ERRO Forbidden...11 Ilustração 3: Tela de Boas vindas...11 Ilustração 4: Tela de Diagnótico sem erros...12 Ilustração 5: Tela de Diagnótico com erros...13 Ilustração 6: Definindo acessos e senhas...14 Ilustração 7: Definindo acessos e senhas, tela preenchida...14 Ilustração 8: O SNEP foi instalado com sucesso...15 Ilustração 9: Tela de login...15 Tutorial Sneplivre 3/16
Sumário Versão...4 1. Objetivo...5 2. Verificando os respositórios...6 3. Instalando o Apache2...6 4. Instalando o MySQL...6 5. Instalação do PHP5...7 6. Instalando as dependências para compilar o Asterisk...7 6.1 Instalando o headers...8 6.2 Obtendo e Instalando o Asterisk...8 7. Obtendo e instalando o SNEP Livre...9 3. Considerações Finais...16 Versão Criado/Alterado Data Versão Urik B. Da Silva 23/05/2013 V1.1 Tutorial Sneplivre 4/16
1. Objetivo O objetivo desse pequeno tutorial (Howto) é guiar usuários iniciantes ou avançados para proceder uma instalação do SNEP Livre usando os pacotes fontes, compilando o Asterisk e resolvendo dependências na mão a partir do sistema operacional Ubuntu, sem utilizar a ISO que está disponível já pronta no site do SNEP Livre. Nesse tutorial não serão abordados aspectos de instalação e particionamento do Sistema Operacional. Como referência, pode ser consultado o site oficial do Ubuntu: http://www.ubuntu.com/community As versões utilizadas nesse tutorial são: Ubuntu Server 12.04.2 LTS amd64 (64 bits) Disponível em: http://www.ubuntu.com/download/server Asterisk 1.4.44 Disponível em: http://downloads.asterisk.org/pub/telephony/asterisk/releases/asterisk-1.4.44.tar.gz SNEP Livre 1.3.9.2 Disponível em: http://sourceforge.net/projects/snep/files/snep/stable/ O procedimento completo de todas as etapas deve durar entre 30 e 50 minutos, dependendo do seu nível de familiaridade com o SNEP, Asterisk e Linux. Notas: Você deverá efetuar todos os passos abaixo utilizando o usuário root (#); Anote as senhas que você usar, elas serão importantes nos passos; Tutorial Sneplivre 5/16
2. Verificando os respositórios Antes de proceder com a instalação dos pacotes, atualize os repositórios oficiais que já vem configurados no sistema operacional. Não será necessário alterar nenhum repositório existente. apt-get update É importante que o seu sistema esteja atualizado com as últimas versões estáveis de todos os pacotes pré-instalados: apt-get upgrade 3. Instalando o Apache2 apt-get install apache2 Do you want to continue [Y/n]? Y Antes de proceder edite o arquivo /etc/apache2/apache2.conf e na linha 51 acrescente a linha: vim /etc/apache2/apache2.conf ServerName sneplivre Por convenção, estamos adotando o hostname da máquina de sneplivre. No caso de você ter usado outro nome, acrescente o nome que você usou para o seu servidor. Reinicie o Apache: service apache2 restart Tutorial Sneplivre 6/16
4. Instalando o MySQL apt-get install mysql-server-5.5 Do you want to continue [Y/n]? Y Na tela que aparecerá, entre com a senha de root que desejar. Anote, e não perca essa senha. Ilustração 1: Definindo senha de root do banco de dados MySQL 5. Instalação do PHP5 apt-get install php5 php5-cgi php5-gd php5-mysql libapache2-mod-php5 Do you want to continue [Y/n]? Y Após finalizar a instalação, crie o arquivo info.php com o conteúdo: vim /var/www/info.php <?php phpinfo()?> Reinicie o Apache e teste o funcionamento no browser acessando o IP do servidor. service apache2 restart http://ipdoservidor/info.php Tutorial Sneplivre 7/16
Se você ver uma página com várias informações do sistema e módulo PHP instalados, prossiga com a instalação. Senão, reveja algum passo acima. 6. Instalando as dependências para compilar o Asterisk apt-get install unixodbc unixodbc-dev odbcinst1debian2 libcurl3 libncurses5-dev build-essential libmyodbc libodbcinstq4-1 libxml2-dev Do you want to continue [Y/n]? Y Criando link: ln -s /usr/lib/x86_64-linux-gnu/odbc/libmyodbc.so /usr/lib/odbc/libmyodbc.so 6.1 Obtendo e Instalando o Asterisk cd /usr/src wget -c http://downloads.asterisk.org/pub/telephony/asterisk/releases/asterisk-1.4.44.tar.gz tar -zxvf asterisk-1.4.44.tar.gz cd asterisk-1.4.44/./configure make menuselect Confirme se os driver ODBC estão instalados: ---> Call Detail Recording [*] cdr_csv [*] cdr_custom [*] cdr_manager [*] cdr_odbc ---> Channel Drivers [*] chan_features Se sim, sai do menu (ESC) e siga os passos abaixo. Se não, reveja algum passo acima. make make install Finalizando a instalação, adicionando o inicializável do Asterisk no init.d cp /usr/src/asterisk-1.4.44/contrib/init.d/rc.debian.asterisk /etc/init.d/asterisk Tutorial Sneplivre 8/16
cd /etc/init.d update-rc.d asterisk defaults 7. Obtendo e instalando o SNEP Livre cd /usr/src wget http://downloads.sourceforge.net/project/snep/snep/stable/sneplivre_1.3.9.2.tar.gz?r=http%3a %2F%2Fsourceforge.net%2Fprojects%2Fsnep%2Ffiles%2Fsnep%2Fstable %2F&ts=1369317337&use_mirror=ufpr mv sneplivre_1.3.9.2.tar.gz\?r\=http\:%2f%2fsourceforge.net%2fprojects%2fsnep%2ffiles %2Fsnep%2Fstable%2F sneplivre_1.3.9.2.tar.gz tar -zxvf sneplivre_1.3.9.2.tar.gz cd snep-1.3.9/ cp -R /usr/src/snep-1.3.9/var/www/sneplivre/ /var/www/ cp -R /usr/src/snep-1.3.9/var/log/snep/ /var/log/ chown -R www-data.www-data /var/www/sneplivre Criando links e diretorios padrao: ln -s /var/www/sneplivre /var/www/snep cp /var/www/snep/install/snep.apache2 /etc/apache2/sites-enabled/001-snep cp -avr /var/www/snep/install/etc/asterisk/ /etc/ cp /var/www/snep/install/etc/*.ini /etc Criando a database e tabelas necessárias para o funcionamento do SNEP: mysql -u root -p < /var/www/snep/install/database.sql mysql -u snep -psneppass snep25 < /var/www/snep/default/installer/schema.sql mysql -u snep -psneppass snep25 < /var/www/snep/default/installer/system_data.sql mysql -u snep -psneppass snep25 < /var/www/snep/default/installer/cnl_data.sql Criando links do AGI do SNEP para o AGI do Asterisk: ln -s /var/www/snep/agi/ /var/lib/asterisk/agi-bin/snep Criando diretorios do Asterisk que são utilizados pelo SNEP: mkdir /var/lib/asterisk/sounds/backup mkdir /var/lib/asterisk/sounds/tmp chown -R www-data.www-data /var/lib/asterisk/sounds/ Criando diretorios de som do Asterisk que são utilizados pelo SNEP: mkdir /var/lib/asterisk/moh/snep_1 Tutorial Sneplivre 9/16
mkdir /var/lib/asterisk/moh/snep_2 mkdir /var/lib/asterisk/moh/snep_3 chown -R www-data.www-data /var/lib/asterisk/moh/ Obtendo e carregandos os sons em Português (BR) no Asterisk: cd /usr/src/snep-1.3.9/ tar -zxvf asterisk-sounds.tgz cp -avr /usr/src/snep-1.3.9/sounds/digits/pt_br /var/lib/asterisk/sounds/digits cp -avr /usr/src/snep-1.3.9/sounds/letters/pt_br /var/lib/asterisk/sounds/letters cp -avr /usr/src/snep-1.3.9/sounds/phonetic/pt_br /var/lib/asterisk/sounds/phonetic cp -avr /usr/src/snep-1.3.9/sounds/pt_br/ /var/lib/asterisk/sounds chown -R www-data.www-data /var/lib/asterisk/sounds/pt_br Criando links simbólicos para comunicação entre SNEP e Asterisk: ln -s /var/lib/asterisk/moh/ /var/www/snep/sounds/moh ln -s /var/lib/asterisk/sounds/pt_br /var/www/snep/sounds/pt_br Criando diretórios e arquivos de log: touch /var/log/snep/ui.log chown www-data.www-data /var/log/snep/ui.log Reinicie o Apache e inicialize o Asterisk: /etc/init.d/apache2 restart /etc/init.d/asterisk start Tutorial Sneplivre 10/16
Finalizando a instalação através do Wizard: 1. Através do browser, acesse o endereço http://ipdoservidor/snep login: admin senha: admin123 Ilustração 2: ERRO Forbidden Se você receber o erro acima, proceda como abaixo: Edite o arquivo /etc/apache2/sites-enabled/001-snep Altere as linhas 7 e 23, de 192.168.0.0 para a classe de rede que o seu servidor se encontra: Allow from 127.0.0.0/255.0.0.0 192.168.0.0/255.255.0.0 201.47.74.147/255.255.255.255 Após alterar, salve o arquivo e reinicie o Apache novamente. 2. Tela de Boas Vindas Ilustração 3: Tela de Boas vindas Tutorial Sneplivre 11/16
Essa é a tela de boas vindas inicial do wizard que irá verificar se todas as dependências para o correto funcionamento foram satisfeitas. Clique no botão Iniciar a Instalação 3. Tela de Diagnóstico Essa é a tela que irá mostrar se existe alguma dependência não resolvida. Se ela aparecer toda verde, conforme imagem abaixo, clique no botão Próximo Ilustração 4: Tela de Diagnótico sem erros Se a tela aparecer com alguma mensagem de erro, volte em algum passo anterior que não foi feito corretamente. Tutorial Sneplivre 12/16
Ilustração 5: Tela de Diagnótico com erros Tutorial Sneplivre 13/16
4. Definindo acessos e senhas Nessa tela deverá ser confirmado, ou alteradas as informações que estão setadas como padrão. Também é onde deverá ser definido a senha de acesso do usuário admin. Ilustração 6: Definindo acessos e senhas Preencha as opções: Host: localhost Senha: admin123 Confirmação de Senha: admin123 Ilustração 7: Definindo acessos e senhas, tela preenchida Tutorial Sneplivre 14/16
5. Instalação realizada com sucesso Ilustração 8: O SNEP foi instalado com sucesso 6. Acessando a interface Se tudo ocorreu como esperado, você acessará a interface abaixo. Login: admin senha: admin123 Ilustração 9: Tela de login Tutorial Sneplivre 15/16
3. Considerações Finais O Tutorial teve como objetivo apresentar uma configuração completa de um ambiente operacional de telefonia IP. Caso encontre algum erro, ou encontre outra solução, ou queira colaborar com mais material de colaboração com o projeto do Sneplivre, utilize o fórum do site http://www.sneplivre.com.br e colabore para o crescimento dessa ferramenta genuinamente brasileira. Tutorial Sneplivre 16/16