Escolar Documentos
Profissional Documentos
Cultura Documentos
Asterisk VIRTUAL
Asterisk VIRTUAL
- 17/12/2009 -
Pgina 1 de 67
Aprendendo Asterisk Manual Para Iniciantes ndice: Instalando VMWare Workstation 6.............................................................................................3 Manual de instalao:..........................................................................................................4 Criando uma Mquina Virtual.....................................................................................................9 Manual de Instalao...........................................................................................................9 Instalao Debian5....................................................................................................................15 Manual de Instalao.........................................................................................................15 Particionando Discos.........................................................................................................18 Criando diretrio Raiz.......................................................................................................22 Criando Demais Parties.................................................................................................27 Configurando Usurios e Senhas.......................................................................................33 Configurando o gerenciador de pacotes............................................................................35 Configuraes aps instalao do Debian.........................................................................41 Preparando o Debian5 para instalao.......................................................................................42 Manual Utilizao Synaptic..............................................................................................43 Instalao do Asterisk 1.4.22.....................................................................................................46 Instalao do JDK6....................................................................................................................50 Instalao do Maven 2...............................................................................................................51 Instalao Asterisk-Java............................................................................................................52 Aplicaes de Exemplo.............................................................................................................54 Ligaes entre ramal..........................................................................................................55 Primeiro Passo...................................................................................................................56 Segundo Passo...................................................................................................................60 Criando Usurio X-Lite.....................................................................................................60 Criando Usurio Zoiper.....................................................................................................63 Testando Aplicao...........................................................................................................64
- 17/12/2009 -
Pgina 2 de 67
- 17/12/2009 -
Pgina 3 de 67
Manual de instalao:
Clique Next.
- 17/12/2009 -
Pgina 4 de 67
- 17/12/2009 -
Pgina 5 de 67
Instalao em andamento...
- 17/12/2009 -
Pgina 6 de 67
- 17/12/2009 -
Pgina 7 de 67
Assim que voc iniciar o programa receber uma dica, se desejar desabilitar as dicas desmarque a caixa Show tips at startup.
- 17/12/2009 -
Pgina 8 de 67
Manual de Instalao
Clique na primeira opo New Virtual Machine para criar sua VM (virtual machine).
- 17/12/2009 -
Pgina 9 de 67
O VMware possui um wizard para facilitar a criao da VM, igual a imagem acima. Clique em avanar para continuar a instalao.
- 17/12/2009 -
Pgina 10 de 67
Neste passo vamos escolher o sistema operacional a ser utilizado, como utilizaremos o Debian5 e no h nenhuma opo para o mesmo, vamos escolher other.
D um nome para sua mquina virtual e aponte um local para armazenar seu disco virtual e todas as configuraes da sua mquina virtual.
- 17/12/2009 -
Pgina 11 de 67
Escolha o tamanho de seu HD, no exemplo acima eu escolhi 40GB, claro que o tamanho pode ser menor ou maior, depende de seu objetivo, para este exemplo 40GB um bom tamanho. Marque o Box Split disk into 2GB files, com essa opo marcada seu disco virtual vai crescendo de 2 em 2 GB gradualmente.
- 17/12/2009 -
Pgina 12 de 67
Pronto, nossa VM est criada. As configuraes de nossa mquina virtual so: 256 MB de memria / 40GB de HD / Ethernet NAT. Agora vamos escolher o CD de instalao (um ISO do Debian5), clique em CD-ROM.
Aps clicar em CD-ROM" na tela anterior, vamos configurar nosso cd de instalao (ISO) do Debian5. Para isso escolha o local do seu ISO.
- 17/12/2009 -
Pgina 13 de 67
Agora nossa VM est pronta. Criamos HD Atribumos Memria Selecionamos o nosso ISO para instalao do Debian5
Obs: Note que eu aumentei a memria da minha VM, voc pode aumentar a memria da sua VM quando quiser desde que sua VM esteja parada. Vamos iniciar a instalao do Debian5 no nosso prximo passo.
- 17/12/2009 -
Pgina 14 de 67
Instalao Debian5
Neste passo vamos instalar o sistema operacional que ir rodar o Asterisk, se voc j possui os conhecimentos necessrios para a instalao, v direto ao prximo passo, caso contrrio recomendo a leitura do manual de instalao. *se preferir seguir a documentao online utilize o link: http://www.debian.org/releases/stable/installmanual
Manual de Instalao
Aps configurar nossa VM, basta clicar em Play para rodar a mquina virtual, se voc configurou tudo corretamente e seu ISO estiver funcionando, aparecer a tela inicial para instalar o Sistema Operacional, selecione a opo Graphical Install e pressione enter.
- 17/12/2009 -
Pgina 15 de 67
- 17/12/2009 -
Pgina 16 de 67
Se sua mquina (fsica) possuir conexo com uma rede, informe aqui o domnio.
Esse um dos passos mais importantes da instalao, escolha a primeira opo. (img)
- 17/12/2009 -
Pgina 17 de 67
Particionando Discos
O particionamento de disco no Linux muito importante e merece uma explicao a parte. Aps escolher o mtodo de particionamento Assistido Usar disco inteiro necessrio configurar nosso esquema de particionamento. A imagem abaixo exibe as opes padres que o software de instalao nos oferece.
Sobre as opes padres: 1. Todos os arquivos em uma nica partio (para iniciantes) Esse esquema para iniciantes porque ir criar apenas um sistema de arquivos, as configuraes do /home, /usr, /tmp, se encontraro em um nico lugar, isso bom porque simplifica o aprendizado do Linux, mas ruim porque as coisas no ficam separadas e isso causa uma baguna muito grande, existem muitas vantagens e desvantagens dessa opo que no irei discutir aqui. 2. Partio /home separada Cria apenas o /home separado, o /home um sistema de arquivos prprio para controle de usurio. 3. Parties home, /usr, /var e /tmp separadas Utilize o esquema Parties Separadas. A seguir uma explicao mais elaborada sobre as parties.
- 17/12/2009 -
Pgina 18 de 67
Aprendendo Asterisk Manual Para Iniciantes Sistema de arquivos Linux: O sistema de arquivos (File System, em ingls) uma estrutura composta de Arquivos e Diretrios. O sistema de arquivo, pelo menos teoricamente, infinito. O limite imposto somente pelo tamanho do disco rgido. O Linux utiliza um sistema hierrquico onde cada tipo de dados tem seu lugarzinho especfico para ser guardado. Essa hierarquia conhecida como estrutura de rvore invertida , e o topo chamado de diretrio raiz, que representado por /. Quem cai de pra-quedas no mundo do Linux fica em choque se perguntando se existe alguma coisa parecida com o Windows. No Windows, os arquivos do sistema ficam no diretrio Windows e os programas em Arquivos de Programas. O Linux lida com isso ao contrrio, no diretrio raiz s existe as pastas do sistema e os seus arquivos pessoais so guardados dentro do diretrio home, que criada para cada usurio. Dentro do Linux as parties, pendrives, cdrom no aparecem como: C: , D: , E: Tudo faz parte do diretrio raiz, ou seja, para o sistema todo mundo diretrio independente do dispositivo. Uma descrio bsica dos diretrios: Vamos conhec-los de acordo com a FHS (Filesystem Hierarchy Standard): Todos os diretrios abaixo ento dentro do diretrio raiz, ou seja, /. /bin : Arquivos e programas do sistema que so usados com freqncia pelos usurios. /boot : Arquivos necessrios para a inicializao do sistema. /cdrom : Ponto de montagem da unidade de CD-ROM. /dev : Arquivos usados para acessar dispositivos do computador. /etc : Arquivos de configurao do computador. /floppy : Ponto de montagem de unidade de disquetes /home : Diretrio que contm os arquivos de cada usurio. /lib : Bibliotecas do sistema. /lost+found : Local de arquivos e/ou diretrios recuperados pelo sistema. /mnt : Ponto de montagem temporrio. /proc : Sistema de arquivos do Kernel. /root : Diretrio do usurio root, o administrador do sistema. /opt : Local para aplicativos opcionais serem instalados. /media : Ponto de montagem de mdia removvel, cmeras digitais, pendrives /sbin : Diretrio de programas usados pelo superusurio (root) para administrao e controle do funcionamento do sistema. /tmp : Arquivos temporrios criados por programas. /usr : Diretrio dos aplicativos. A maioria estar instalada neste diretrio. Curiosidade: usr no quer dizer User e sim Unix System Resources. /var : Diretrio contm arquivos que so gravados com freqncia pelos aplicativos do sistema, como: e-mails, cache, spool de impressora. Fonte: http://www.artemagnetica.com.br/sistema-de-arquivos-linux.html *Para aprofundar no assunto recomendo o link: http://www.ibm.com/developerworks/br/library/l-linux-filesystem/index.html
Autor: Bruno F. Antognolli - 17/12/2009 Pgina 19 de 67
Aps escolher o esquema de particionamento separado, o Linux cria automaticamente as configuraes acima. Neste momento podemos finalizar o particionamento do Linux com as configuraes criadas automaticamente, ou desfazer as mudanas nas parties e editar da maneira mais conveniente. Para continuar com nosso exemplo vamos desfazer as mudanas nas parties e criar todas manualmente.
- 17/12/2009 -
Pgina 20 de 67
Escolha a partio (uma a uma) e aperte enter, ser exibida uma tela com as configuraes da partio selecionada, clique em remover partio.
- 17/12/2009 -
Pgina 21 de 67
Aps remover todas as parties, seu HD ficar semelhante imagem acima. Neste momento vamos criar a partio /, que o diretrio raiz do Linux. O diretrio raiz, representado pela /, especfico de cada mquina. Pode ficar tanto em um disco fsico quanto na memria da mquina ou em uma unidade de rede. o diretrio principal, que contm todos os arquivos e diretrios do sistema.
- 17/12/2009 -
Pgina 22 de 67
- 17/12/2009 -
Pgina 23 de 67
- 17/12/2009 -
Pgina 24 de 67
O tipo de partio para o diretrio raiz PRIMRIA e no lgica. Exceto o diretrio raiz do Linux (/) todas as outras parties devero ser parties lgicas.
Aps escolher o tamanho da partio, escolha o ponto de montagem que nada mais do que a partio a ser criada (/) e clique em Finalizar a configurao da partio .
- 17/12/2009 -
Pgina 25 de 67
Aps os passos acima seu diretrio raiz est criado, e possui 501,7MB.
- 17/12/2009 -
Pgina 26 de 67
Aps selecionar o Espao Livre para criar outra partio, comearemos a criar as parties Lgicas. A partir de agora, todas as parties sero Lgicas.
- 17/12/2009 -
Pgina 27 de 67
Escolhendo a localizao fim o Linux no deixar criar mais parties, portanto escolha Incio para sua nova partio, pois ser necessrio criar vrias parties.
Aps escolher uma partio Lgica/Incio, voc dever escolher o ponto de montagem (o diretrio a ser criado) neste caso estamos criando o diretrio /usr e clicar em finalizar.
- 17/12/2009 -
Pgina 28 de 67
Aps configurar e finalizar a partio, nosso HD estar com as configuraes acima. Repita esse mesmo procedimento para criar os demais diretrios. Voc deve criar as seguintes parties: Partio /usr /var /opt /tmp /home swap Tamanho 18Gb 2GB 2GB 403Mb 17.3GB 2.7GB
- 17/12/2009 -
Pgina 29 de 67
Aprendendo Asterisk Manual Para Iniciantes Ateno para a partio SWAP Quando estiver montando a partio SWAP, necessrio voc pressionar o enter no ponto de montagem e escolha o tipo de partio swap.
- 17/12/2009 -
Pgina 30 de 67
Aps escolher o ponto de Montagem Swap voc dever finalizar a configurao da partio normalmente. Aps criar todas as parties do nosso HD, ele ficar com as seguintes configuraes.
- 17/12/2009 -
Pgina 31 de 67
Pronto, ns j configuramos nosso HD e todas suas parties, agora vamos continuar com a instalao.
- 17/12/2009 -
Pgina 32 de 67
necessrio configurar duas senhas, uma para o usurio root e outra para o usurio que ser criado a seguir. Na imagem acima, configuramos uma senha para o root, na imagem abaixo configuramos uma senha para o usurio que ser criado.
- 17/12/2009 -
Pgina 33 de 67
Criando usurio: Na imagem acima, criamos o usurio para uma conta, na imagem abaixo criamos um usurio para acessar e interagir com o sistema.
- 17/12/2009 -
Pgina 34 de 67
- 17/12/2009 -
Pgina 35 de 67
Como existem vrios pases que fornecem espelho de repositrio para o Debian, vamos selecionar o Brasil.
Se o computador que voc est rodando sua VM possuir acesso a internet no preencha nenhuma informao sobre o Proxy e clique em continuar.
- 17/12/2009 -
Pgina 36 de 67
Notem que neste momento h grande quantidade de trfego na sua rede, pois sua VM est procurando pacotes de atualizao no FTP do Debian Brasil.
- 17/12/2009 -
Pgina 37 de 67
Neste momento voc decide de deseja participar do popularity-contest. Essa resposta pessoal, alguns participam, outros no.
- 17/12/2009 -
Pgina 38 de 67
Escolha as colees de software listadas na imagem acima, pois isso facilitar seu trabalho.
Bom, essa parte demorada e vai depender muito da sua conexo com a internet.
- 17/12/2009 -
Pgina 39 de 67
Eis que instalamos o Debian e estamos fazendo login com o usurio root.
- 17/12/2009 -
Pgina 40 de 67
Caso a instalao no inicie automaticamente no modo grfico, basta seguir os procedimentos abaixo.
asterisk:/root# apt-get update asterisk:/root# apt-get install x-window-system xserver-xorg gnome-core gdm
Aps os comandos acima quando iniciarmos o Debian ele estar com a seguinte aparncia.
- 17/12/2009 -
Pgina 41 de 67
- 17/12/2009 -
Pgina 42 de 67
Escolha o pacote desejado e clique sobre ele, logo aps selecione Marcar para instalao voc pode selecionar quantos pacotes precisar e depois instalar todos juntos.
Autor: Bruno F. Antognolli - 17/12/2009 Pgina 43 de 67
Alguns pacotes possuem dependncias o Synaptic gerencia isso automaticamente, mas ele avisar que voc precisar baixar outros pacotes dependentes.
Aps selecionar os pacotes necessrios clique em aplicar, na barra superior, abrir uma tela semelhante a acima, basta clicar novamente em aplicar para que os pacotes sejam baixados e instalados.
- 17/12/2009 -
Pgina 44 de 67
Aps clicar em aplicar ser exibido o status do download de pacotes, aps isso o Linux se encarregar de instalar automaticamente os pacotes selecionados. Pronto! Seu Debian est preparado para as prximas instalaes
- 17/12/2009 -
Pgina 45 de 67
Compilando o libpri:
asterisk:/usr/src/libpri# cd /usr/src/libpri asterisk:/usr/src/libpri# make asterisk:/usr/src/libpri# make install
Compilando o zaptel:
asterisk:/usr/src/zaptel# cd /usr/src/zaptel asterisk:/usr/src/zaptel# ./configure asterisk:/usr/src/zaptel# make menuselect asterisk:/usr/src/zaptel# make asterisk:/usr/src/zaptel# make install
Obs: Ao digitar make menuselect, uma tela vai se abrir, basta apertar a tecla x para que ele saia desta tela gravando as informaes. Obs2: Pode ser que ao tentar compilar o zaptel (make) ele d um erro, como na imagem abaixo:
Esse erro causado por causa da verso do Kernel, pois essa verso no foi encontrada.
- 17/12/2009 -
Pgina 46 de 67
Aprendendo Asterisk Manual Para Iniciantes Para corrigir o erro do Zaptel simples, basta acessar o Synaptic e baixar o pacote linuxheadres-2.6.26.2.686, como ilustra a imagem a seguir
Compilando o asterisk:
asterisk:/usr/src/asterisk# cd /usr/src/asterisk asterisk:/usr/src/asterisk# ./configure asterisk:/usr/src/asterisk# make menuselect asterisk:/usr/src/asterisk# make asterisk:/usr/src/asterisk# make install asterisk:/usr/src/asterisk# make samples
Obs: Ao digitar make menuselect, uma tela vai se abrir, basta apertar a tecla x para que ele saia desta tela gravando as informaes.
- 17/12/2009 -
Pgina 47 de 67
Obs: Ao digitar make menuselect, uma tela vai se abrir, basta apertar a tecla x para que ele saia desta tela gravando as informaes. Caso voc possua os arquivos de som do Asterisk Descompacte-os na pasta /var/lib/asterisk.
asterisk:/var/lib/asterisk# tar xzvf sounds-pt_BR.tar.gz
Parar o Asterisk
*CLI> stop now
- 17/12/2009 -
Pgina 48 de 67
Se tudo ocorreu bem voc ver uma imagem semelhante a essa aps instalar o asterisk.
Se tudo ocorreu bem, ao tentar verificar a verso instalada do asterisk com o comando core show version, voc visualizar uma imagem semelhante a essa.
- 17/12/2009 -
Pgina 49 de 67
Aprendendo Asterisk Manual Para Iniciantes Voc deve reiniciar seu sistema agora.
Instalao do JDK6
O que JDK? Java Development Kit (JDK) significa Kit de Desenvolvimento Java, e um conjunto de utilitrios que permitem criar sistemas de software para a plataforma Java. composto por compilador e bibliotecas.
*Mais informaes em: http://www.cin.ufpe.br/~phmb/ip/MaterialDeEnsino/IntroducaoAoJDK/IntroducaoAoJDK.htm
A instalao do JDK6 est separada por passos, para facilitar a compreenso. 1. Para a instalao do JDK 6 podemos utilizar o prprio apt-get do Debian.
asterisk:/urs/src# apt-get update asterisk:/urs/src# apt-get install sun-java6-jdk
2. Agora devemos certificar que o JDK instalado est realmente setado para o nosso Debian.
asterisk:/urs/src# update-alternatives --config java
Voc deve escolher a opo com o java-6-sun, para isso digite o nmero correspondente, no nosso exemplo seria a opo 3. 3. Aps a instalao acrescente edite o arquivo ~/.profile com o comando: /usr/src# mcedit ~/.profile E Adicione as seguintes linhas de cdigo:
JAVA_HOME=/usr/lib/jvm/java-6-sun export JAVA_HOME PATH=$PATH:$JAVA_HOME/bin export PATH
- 17/12/2009 -
Pgina 50 de 67
Aprendendo Asterisk Manual Para Iniciantes 6. O resultado deve ser algo assim:
java version "1.6.0_12" Java(TM) SE Runtime Environment (build 1.6.0_12-b04) Java HotSpot(TM) Client VM (build 11.2-b01, mixed mode, sharing)
Instalao do Maven 2
O que Maven? At first glance Maven can appear to be many things, but in a nutshell Maven is an attempt to apply patterns to a project's build infrastructure in order to promote comprehension and productivity by providing a clear path in the use of best practices.
Fonte: http://maven.apache.org/guides/getting-started/index.html
Continuando, agora vamos instalar o Maven 2, para facilitar a compreenso dividiremos a instalao em passos: 1. Fazer o download do pacote Maven 2 e em seguida descompact-lo na pasta /usr/local .
Link Download: http://www.apache.org/dist/maven/binaries/apache-maven-2.1.0-bin.tar.gz asterisk:/urs/src# tar xvfz apache-maven-2. 1.0-bin.tar.gz
2. Aps a instalao acrescente edite o arquivo ~/.profile com o comando: /usr/src# mcedit ~/.profile E Adicione as seguintes linhas de cdigo:
M2_HOME=/usr/src/apache-maven-2.1.0 export M2_HOME PATH=$PATH:M2_HOME/bin export PATH
- 17/12/2009 -
Pgina 51 de 67
Aprendendo Asterisk Manual Para Iniciantes Obs:Ao instalar o maven no asterisk-java reportei o seguinte erro: (...) [INFO] Compilation failure error: error reading /root/.m2/repository/javax/mail/mail/1.4/mail-1.4.jar; error in opening zip file (...) Faa o download do mail-1.4.jar no link abaixo http://mirrors.ibiblio.org/pub/mirrors/maven2/javax/mail/mail/1.4/mail-1.4.jar Copiei o arquivo baixado p/ o diretrio /root/.m2/repository/javax/mail/mail/1.4 Faa o processo novamente.
Instalao Asterisk-Java
O que Asterisk-Java? Asterisk-Java 0.3.1 uma biblioteca gratuita de Java para a integrao do Asterisk PBX. O pacote Asterisk-Java consiste de um grupo de classes Java que permite voc facilmente construir aplicaes Java que interagem com o servidor Asterisk. Asterisk-Java suporta tanto o protocolo FastAGI e o Manager API.
*Mais informaes: http://asterisk-java.org/
Para finalizar vamos instalar o pacote Asterisk-java, que nos permite a criao de FastAGI utilizando a linguagem Java.
asterisk:/urs/local# svn co http://svn.reucon.net/repos/asterisk-java/trunk asterisk-java asterisk:/urs/local/asterisk-java# mvn install Ocorreo erros por causa de algumas dependncias como: jms, jmxri e jmxtools. Cpie os arquivos .jar dos referidos pacotes dentro da pasta asterisk-java e digite os seguintes comandos: asterisk:/urs/local/asterisk-java# mvn install:install-file -DgroupId=javax.jms -DartifactId=jms -Dversion=1.1 -Dpackaging=jar -Dfile=jms-1.1.jar asterisk:/urs/local/asterisk-java# mvn install:install-file -DgroupId=com.sun.jmx -DartifactId=jmxri Dversion=1.2.1 -Dpackaging=jar -Dfile=jmxri-1.2.1.jar asterisk:/urs/local/asterisk-java# mvn install:install-file -DgroupId=com.sun.jdmk -DartifactId=jmxtools -Dversion=1.2.1 -Dpackaging=jar -Dfile=jmxtools-1.2.1.jar
Dentro da pasta /usr/local/asterisk-java/target ser criado um arquivo com o nome asterisk-java.jar , este arquivo deve ser copiado para dentro da pasta onde seus FastAGI sero compilados.
- 17/12/2009 -
Pgina 52 de 67
Aprendendo Asterisk Manual Para Iniciantes Lembrando que para se compilar um FastAGI, utilizamos o comando javac. Pronto! Agora s implementar as configuraes de seu Asterisk, criar seus FastAGI e colocar em produo. (Se tudo ocorreu bem, veja a imagem a seguir, pois se instalao foi bem sucedida seu sistema ter os mesmo arquivos.)
Essa imagem ilustra o Asterisk-Java construdo com sucesso, e o arquivo asterisk-java.jar dentro da pasta target.
- 17/12/2009 -
Pgina 53 de 67
Aplicaes de Exemplo
Antes de iniciar nossas aplicaes de exemplo gostaria de explicar rapidamente sobre alguns arquivos do Asterisk.
Extensions.conf Esse arquivo o lugar que fica armazenada todo seu plano de discagem, toda a regra de seu Asterisk fica aqui. Iax.conf Arquivo de configurao Iax. Sip.conf Arquivo de configurao SIP. Voicemail.conf Arquivo para configurar correio de voz. *No entrei em detalhe sobre cada um, pois esse assunto pode ser mais bem explicado quando pesquisado na internet, livros, etc, o objetivo dos exemplos muito mais prtico do que terico.
- 17/12/2009 -
Pgina 54 de 67
- 17/12/2009 -
Pgina 55 de 67
Primeiro Passo
Copie os fontes dos arquivos abaixo e cole no arquivo do Asterisk. Se desejar fazer backup nos arquivos originais do asterisk, fique a vontade. Fontes do arquivo extensions.conf:
[General] AUTOFALLTHROUGH = NO ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; CONTEXTO GLOBAL, AS CONFIGURACOES AQUI SERAO REFLETIDAS PARA TODOS OS ARQUIVOS [Globals] ;; CONFIGURACOES PARA TRANSFERENCIA, ATENDIMENTO, ETC CONTIDAS NO ARQUIVO FEATURES.CONF ;; SERA APLICADA PARA QUALQUER CONTEXTO include => features.conf ;; GRAVACOES exten => 000,1,Answer exten => 000,n,Wait(1) exten => 000,n,Record(TesteGravacao.gsm) exten => 000,n,Playback(TesteGravacao) exten => 000,n,HangUp [recebeLigacao] exten => 001,1,Answer exten => 001,n,Wait(2) exten => 001,n,NoOp(***${CALLERID(num)}***) exten => 001,n,Dial(SIP/1000,Tt) exten => 001,n,Hangup ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
- 17/12/2009 -
Pgina 56 de 67
- 17/12/2009 -
Pgina 57 de 67
Aprendendo Asterisk Manual Para Iniciantes Com os cdigos acima j temos as seguintes configuraes para o asterisk: Dois ramais configurados, ramal 1000 e 1001 Contexto para transferir ligaes entre o ramal 1000 e 1001 e vice versa. Agora vou explicar um pouco sobre os cdigos acima: Explicao do arquivo sip.conf: Para se criar um ramal necessrio que voc informe o nmero do ramal a ser criado, e configure um usurio e senha para o mesmo, abaixo vou explicar como fazer isso. Baseado nos fontes do arquivo sip.conf (pg 59) vamos entender as linhas destacadas. 1. Configurando ramal: As linhas em azul so as linhas chave na configurao de um ramal sip. Primeiro necessrio criar um contexto com o nmero do ramal isso serve para de fato criar o ramal veja exemplo abaixo:
[1001](template) ;Bruno OBS: No cdigo acima, configuramos o nmero do ramal [1001] e tambm atribumos as configuraes do template a esse ramal, o template que uma configurao padro para este ramal permite que o ramal receba e realize ligaes.
Aps criar o contexto com o nmero do ramal, necessrio criar um usurio e senha, na linha abaixo criado o usurio:
username=1001
De posse do usurio s resta criar a senha, que definida com o cdigo abaixo:
secret=1001
2. Permisso de IPs: Para que se consiga acessar o servidor, necessrio definir quais IPs possam acess-lo, podemos definir o acesso com o cdigo abaixo:
localnet=192.168.0.0/255.255.255.0
3. Contexto inicial Aps configurarmos o ramal, usurio, senha e a permisso de uma faixa de IP, necessrio configurar um contexto para direcionar o fluxo. A linha abaixo define qual o nome do contexto que o arquivo SIP buscar no arquivo EXTENSIONS, uma ponte entre as configuraes dos ramais sip e o plano de discagem contido no arquivo extensions.
context=recebeLigacao
muito importante que o nome do contexto seja igual no arquivo sip.conf e extensions.conf, se for diferente vai dar problema.
- 17/12/2009 -
Pgina 58 de 67
Aprendendo Asterisk Manual Para Iniciantes Explicao do arquivo extensions.conf: Aps os ramais estarem criados, necessrio fazer o plano de discagem para que um consiga ramal consiga discar para o outro, esse o papel que o extensions.conf far. O cdigo abaixo o nome do contexto. O contexto do arquivo extensions possui o mesmo nome que o contexto do arquivo sip, isso quer dizer que sempre que o asterisk terminar a execuo do arquivo sip.conf ele ir para o contexto recebeLigacao
[recebeLigacao]
O cdigo abaixo o cdigo que faz ligao de um ramal para o outro. Explicando rapidamente:
exten => 001,1,Answer (Atende a chamada) exten => 001,n,Wait(2) (Aguarda 2 segundos) exten => 001,n,NoOp(***${CALLERID(num)}***) (Imprime no console o nmero que originou a chamada) exten => 001,n,Dial(SIP/1000,Tt) (Transfere a chamada) exten => 001,n,Hangup (Finaliza a ligao)
Reload nos arquivos editados Aps editar o arquivo sip.conf e extensions.conf necessrio que esses arquivos sejam recarregados para que as modificaes tenham efeito.
Acesse o console rasterisk com o comando rasterisk (sem aspas) Digite sip reload, pressione enter. Digite dialplan reload, pressione enter.
- 17/12/2009 -
Pgina 59 de 67
Segundo Passo
Temos que criar as mesmas contas configuradas no arquivo sip.conf nos nossos softphones (ramais 1001 e 1000) Para facilitar o aprendizado, na nossa mquina fsica (Windows) vamos instalar o softphone X-Lite, e na mquina virtual (Debian5) vamos instalar o Zoiper. Link para Download X-Lite: http://superdownloads.uol.com.br/download/177/x-lite/ Zoiper: http://www.zoiper.com/download_list.php?os=All Sobre a instalao dos Softphones: Para instalar o X-Lite no WindowsXP simples, next, next e finish. Para rodar o Zoiper no Linux tambm simples basta descompactar o arquivo na pasta deseja e clicar sobre o arquivo descompactado.
Clique com o boto direito sobe o X-Lite e escolha Sip Account Settings...
- 17/12/2009 -
Pgina 60 de 67
Configure sua conta/ramal. Display Name o nome que voc se apresentar na rede, quando efetuar uma ligao ir aparecer o que voc colocar no campo Display name, no meu caso Bruno F. Antognolli User Name o nmero do seu ramal, o mesmo nmero criado no arquivo sip.conf, essa conta ser o ramal 1001. Password a senha criada no arquivo sip.conf, que 1001. Autorization User Name, podemos colocar o mesmo nmero do ramal, no caso 1001. Domain a rede que voc pretende acessar no caso a rede criada para nossa mquina virtual, onde est hospedado o asterisk. Dica: Para ver o IP da rede do seu Debian, abra o console e digite: ifconfig
*Se voc j possuir uma conta criada clique em properties caso contrrio clique em add.
- 17/12/2009 -
Pgina 61 de 67
Aps configurar sua conta no X-lite, ele ir procurar pela rede quando achar a rede e ele conseguir se conectar normalmente, ir aparecer uma mensagem de sucesso. Pronto, agora nossa conta X-Lite est criada e conectada ao servidor Asterisk.
- 17/12/2009 -
Pgina 62 de 67
D um nome para a conta que ser criada (eu dei o nome de Teste)
Configure a Rede (assim como fez com o X-Lite), username, password e caller Id Name.
- 17/12/2009 -
Pgina 63 de 67
Aps configurar a rede, usurio e senha, clique em register para registrar seu usurio. Pronto seu usurio teste est criado e associado ao servidor Asterisk.
Testando Aplicao
Recapitulando: Neste momento j criados/configuramos os arquivos Sip.conf e Extensions.conf. Tambm j criamos nossas contas no X-Lite e Zoiper e associamos as mesmas ao servido Asterisk. Agora vamos testar nossa aplicao. Zoiper para X-lite (simulando a ligao entre dois ramais distintos)
Notem que ao ligar do Zoiper para o X-Lite, apareceu uma janelinha do X-Lite informando: Incoming call from: Isso o aviso do XLite que existe algum ligando. E se existe algum ligando porque funcionou!
- 17/12/2009 -
Pgina 64 de 67
Notem que a ligao foi atendida e j houve 19 segundos de conversa. Ao lado os dois softphones. X-Lite para Zoiper (Agora vamos fazer o teste inverso, ligar do X-Lite para Zoiper)
O Zoiper exibe um alerta informando que algum est ligando (neste caso o X-Lite, que est configurado com a conta Bruno F. Antognolli)
- 17/12/2009 -
Pgina 65 de 67
Log Asterisk
O Asterisk nos permite atravs do console acompanhar tudo que acontece, na imagem abaixo est registrado atravs do console o que aconteceu internamente quando ligamos de um ramal para outro. Os retngulos vermelhos so os comandos que eu digitei, e a linhas roxas o log do console.
Perceba que na primeira linha roxa a chamada enviada para o Asterisk, na segunda transferida, na quarta o ramal est chamando, na quinta, o outro ramal atendeu.
Autor: Bruno F. Antognolli - 17/12/2009 Pgina 66 de 67
- 17/12/2009 -
Pgina 67 de 67