Mudanças entre as edições de "PJI011104 - Projeto Integrador IV - 2022-1"

De MediaWiki do Campus São José
Ir para navegação Ir para pesquisar
Linha 24: Linha 24:
 
{{collapse top|Passo 0: Requisitos para instalação do Asterisk}}
 
{{collapse top|Passo 0: Requisitos para instalação do Asterisk}}
 
# Virtualbox ou VMware Workstation (ou outro programa de virtualização)
 
# Virtualbox ou VMware Workstation (ou outro programa de virtualização)
−
# Sistema operacional Linux (testado com Ubuntu Mate 16.04 LTS, este roteiro pode não funcionar para outras distribuições e versões).
+
# 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 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).
 
## Programa para discagem Zoiper 5 (testado com Zoiper5_5.5.8_x86_64).
 
## Aplicativo de áudio em português (disponibilizado para download).
 
## 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 (<code>sudo apt update && sudo apt install build-essential module-assistant dkms && sudo m-a prepare</code> 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 <code>/media/seu_usuario/VBox_GAs_versao$ sudo ./VBoxLinuxAdditions.run</code>).
 +
{{collapse bottom}}
 +
 +
{{collapse top|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):
 +
 +
<code>
 +
$ sudo su
 +
</code>
 +
 +
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 <code>$</code> 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 <code>#</code>.
 +
 +
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:
 +
 +
<code>
 +
<nowiki>#</nowiki> apt update && apt upgrade
 +
</code>
 +
 +
4) Instalando as bibliotecas requeridas pelo Asterisk:
 +
 +
<code>
 +
<nowiki>#</nowiki> apt install make wget libssl-dev ncurses-dev libnewt-dev libxml2-dev linux-headers-generic g++ libsqlite3-dev uuid-dev libjansson-dev
 +
</code>
 +
 +
5) Instalando o gerenciador de banco de dados MySQL:
 +
 +
<code>
 +
<nowiki>#</nowiki> apt install mysql-server libmysqld-dev
 +
</code>
 
{{collapse bottom}}
 
{{collapse bottom}}
  
Linha 40: Linha 78:
  
 
{{collapse top|Comandos rasterisk}}
 
{{collapse top|Comandos rasterisk}}
−
Recarrega configurações SIP
+
Recarrega configurações SIP:
 +
 
 +
<code>
 
CLI> sip reload
 
CLI> sip reload
−
Também é possível executar via:
+
</code>
 +
 
 +
Também é possível executar via:  
 +
 
 +
<code>
 
$ asterisk -r -x "sip reload"
 
$ asterisk -r -x "sip reload"
 +
</code>
  
−
Recarrega todas as configurações
+
Recarrega todas as configurações:
 +
 
 +
<code>
 
CLI> reload
 
CLI> reload
 +
</code>
  
−
Mostra status dos terminais cadastrados
+
Mostra status dos terminais cadastrados:
 +
 
 +
<code>
 
CLI> sip show peers
 
CLI> sip show peers
 +
</code>
 +
 
{{collapse bottom}}
 
{{collapse bottom}}
  
 
{{collapse top|Resolução de problemas}}
 
{{collapse top|Resolução de problemas}}
−
Liberação de portas do firewall para funcionamento do Asterisk
+
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
+
<code>
 +
<nowiki>#</nowiki> iptables -A INPUT -p udp -m udp --dport 10000:20000 -j ACCEPT
 +
 
 +
<nowiki>#</nowiki> iptables -A INPUT -p udp -m udp --dport 5060 -j ACCEPT
 +
</code>
 
{{collapse bottom}}
 
{{collapse bottom}}

Edição das 12h30min de 21 de junho de 2022

Dados importantes

Professor

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

Roteiro de instalação do Asterisk

Passo 0: Requisitos para instalação do Asterisk
  1. Virtualbox ou VMware Workstation (ou outro programa de virtualização)
  2. 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).
    1. Programa PBX Asterisk (testado com asterisk-13.38.3, esse roteiro pode não funcionar para outras versões).
    2. Programa para discagem Zoiper 5 (testado com Zoiper5_5.5.8_x86_64).
    3. 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).
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

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

Recarrega configurações SIP:

CLI> sip reload

Também é possível executar via:

$ asterisk -r -x "sip reload"

Recarrega todas as configurações:

CLI> reload

Mostra status dos terminais cadastrados:

CLI> sip show peers

Resolução de problemas

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

Disponível em “https://wiki.sj.ifsc.edu.br/index.php?title=PJI011104_-_Projeto_Integrador_IV_-_2022-1&oldid=183638”