PJI011104 - Projeto Integrador IV - 2022-1

Dados importantes

Professor

• Professor da Disciplina: Adilson Jair Cardoso e Cleber Jorge Amaral
  
• Email: adilson.jair@ifsc.edu.br e cleber.amaral@ifsc.edu.br

Turma virtual

• Acesse o sigaa bucando a disciplina PJI011104 - PROJETO INTEGRADOR IV (2021.2 - T01)

Aulas síncronas não presenciais

• Horários
  • segundas e terças-feiras das 19:00 às 22:00
  • sábados letivos serão com atividades assíncronas.
  • Mais informações ver SIGAA

Aulas presenciais

• Horários
• Em condições de aulas presenciais: Sala 05, Laboratório Interativo e Meios de transmissão

Organização curricular

• Matriz curricular do curso técnico integrado de telecomunicações

Roteiro de instalação do Asterisk

Passo 0: Requisitos para instalação do Asterisk

Virtualbox ou VMware Workstation (ou outro programa de virtualização) Sistema operacional Linux (testado com Ubuntu Mate 16.04 LTS e 22.04 LTS, este roteiro pode não funcionar para outras distribuições e versões). Programa PBX Asterisk (testado com asterisk-13.38.3, esse roteiro pode não funcionar para outras versões). Programa para discagem Zoiper 5 (testado com Zoiper5_5.5.8_x86_64). Aplicativo de áudio em português (disponibilizado para download). Para evitar confusão, a máquina física que está hospedando a máquina virtual será chamada de hospedeira e a máquina virtual será chamada de máquina virtual. A máquina hospedeira pode ter qualquer sistema operacional. Para facilitar a interação entra a hospedeira e virtual, é importante que a máquina hospedeira tenha os pacotes de integração. No caso da hospedeira ser Debian/Ubuntu certifique-se de ter os pacotes build-essential, module-assistant e dkms (sudo apt update && sudo apt install build-essential module-assistant dkms && sudo m-a prepare e da máquina virtual utilize a opção de instalação dos pacotes extras no menu Devices > Insert Guest Additions CD Image... e depois /media/seu_usuario/VBox_GAs_versao$ sudo ./VBoxLinuxAdditions.run). Link para baixar softwares e demais arquivos necessários: pasta com arquivos

Passo 1: Preparando a máquina virtual que será o servidor Asterisk

Considerando a instalação do Asterisk em uma máquina virtual Ubuntu, as informações a seguir se referem ao que deve ser feito dentro da máquina virtual. 1) Certifique-se de ter uma máquina virtual linux para instalar o Asterisk (recomendável que tenha ao menos 20GB de espaço em disco - você pode criar uma máquina virtual vazia, baixar uma das versões testadas do linux no formato ISO e utilizar esse arquivo como um CDROM para fazer a instalação) 2) Como serão feitos vários comandos que requerem privilégio de administrador, realize o seguinte comando para chavear o terminal para o modo de administração (root): $ sudo su Obs.1: Digite a senha de seu usuário (que necessariamente precisa ser um usuário que tenha privilégio de se tornar super usuário - pertencente ao grupo sudoers). Obs.2: No comando acima foi utilizando o símbolo $ que representava que o terminal estava no modo de usuário comum, após o chaveamento para o modo de administração será utilizado o símbolo #. Obs.3: Como regra de ouro, procure sempre estar atento as mensagens impressas no terminal. Diversos problemas podem ocorrer e muitas vezes estes são fáceis de resolver apenas seguindo as orientações impressas em casos de falhas. Caso não consiga resolver o problemas pelas próprias informações dadas, copie o erro dado e cole no google para verificar se outros usuários já experimentaram este problema e se há orientações de como resolvê-lo. 3) Certifique-se de que o sistema operacional da máquina virtual esteja atualizado: # apt update && apt upgrade 4) Instalando as bibliotecas requeridas pelo Asterisk: # apt install make wget libssl-dev ncurses-dev libnewt-dev libxml2-dev linux-headers-generic g++ libsqlite3-dev uuid-dev libjansson-dev 5) Instalando o gerenciador de banco de dados MySQL: # apt install mysql-server libmysqld-dev Obs.: Será utilizada a senha 1234 no mysql.

Passo 2: Intalando o Asterisk e realizando a configuração inicial do Asterisk

1) Baixe o arquivo tar.gz do Asterisk disponibilizado (versão 13.38.3) e mova para a pasta /usr/src. 2) Descompacte o arquivo tar.gz com o comando: # tar -zxvf asterisk-13.38.3.tar.gz 3) Entre na pasta descompactada digitando: # cd asterisk-13.38.3 4) Realize a compilação do Asterisk # ./configure --libdir=/usr/lib64 5) Realize a configuração da instalação # make menuselect Na tela de configuração marque a opção cdr_mysql do menu Add-ons (See README-addons.txt) e depois pessione Save & Exit 6) Realize a instalação # make # make install # make samples # make config 7) Teste se o asterisk está funcionando # service asterisk start # rasterisk Se o serviço subiu e o rasterisk rodou bem, deu tudo certo, você pode sair da interface cliente. CLI> quit

Entendendo os parâmetros de configuração do Asterisk

Tipos SIP: peer: Entidade SIP a qual o Asterisk envia chamadas (exemplo: um telefone ou central que que só recebe chamadas). user: Entidade SIP a qual executa chamadas através do Asterisk (exemplo: um telefone que só faz chamadas). friend: Entidade SIP que pode fazer e receber chamadas. Qualify: yes: O Asterisk testa de tempos em tempos se o dispositivo (terminal) está acessível (por padrão a cada 2 segundos)

Comandos rasterisk
Mostra lista de comandos: CLI> help , ou executando: $ asterisk -r -x "help" Sair da interface cliente: CLI> quit Recarrega configurações SIP: CLI> sip reload Recarrega todas as configurações: CLI> reload Mostra status dos terminais cadastrados: CLI> sip show peers

Resolução de problemas

PROBLEMA: Não está sendo possível acessar o servidor Asterisk de uma outra máquina. Solução: Liberação de portas do firewall para funcionamento do Asterisk: # iptables -A INPUT -p udp -m udp --dport 10000:20000 -j ACCEPT # iptables -A INPUT -p udp -m udp --dport 5060 -j ACCEPT PROBLEMA: Asterisk não está mais subindo depois que a máquina foi reiniciada. Solução: reinstalar o Asterisk (sem modificar os arquivos de configuração que já tenham sido editados) Tente subir o serviço manualmente $ sudo su # service asterisk start # service asterisk status Se pelo comando status o serviço não subiu, tente reinstalar o Asterisk: $ sudo su # cd /usr/src/asterisk-13.38.3/ # make install # service asterisk start