01 - GSA-M3 - 001 - Conhecendo o Asterisk

Conhecendo o Asterisk:MODULO 3 - 001Janeiro 2013 Rio de Janeiro, BrasilProfessor: Esp. Angelo de Barros Delphini

Estrutura de pastas

O Asterisk trabalha com as pastas que sero informadas neste momento, quando feita a instalao padro a partir dos cdigos-fonte.

importante conhec-los para saber onde procurar os mdulos ou ficheiros utilizados e gerados pelo sistema, assim como para melhor dimensionar o particionamento do seu sistema operativo.

Caso for alterada essa estrutura de pastas deve-se alterar no ficheiro asterisk.conf quais as pastas sero utilizadas e que correspondem as originais.

Estrutura de pastas

/etc/asterisk/: a pasta onde so encontrados todos os ficheiros de configurao do Asterisk.

/usr/lib/asterisk/modules/: nesta pasta esto todos os mdulos que englobam as APIs. Se no houver configuraes no ficheiro modules.conf negando o carregamento de algum mdulo, todos os mdulos que estiverem na pasta /usr/lib/asterisk/modules/ sero carregados, por isso preciso ter o cuidado de no manter backups de mdulos para teste de outros. Caso o Asterisk sinta qualquer dificuldade ao carregar os mdulos desta pasta o servio no ira iniciar. Caso o mdulo j esteja em execuo, este no ir parar. Mas ao ser reiniciado no funcionar.

Estrutura de pastas

/var/lib/asterisk/: armazena o arquivo de base de dados do Asterisk, AstDB, e uma srie de sub pastas com ficheiros que podem ser usados para apoiar alguns aplicativos do IP PBX.

/var/lib/asterisk/sounds/: pasta padro para armazenar os ficheiros de udio utilizados pelos aplicativos do Asterisk. Por padro, na compilao podem ser instalados ficheiros de udio em ingls, espanhol e francs. Tambm possvel colocar os udios em portugus desde que se mantenham os mesmos nomes dos ficheiros do projeto Asterisk. Os ficheiros desta pasta geralmente se encontram em formato gsm por terem a mesma qualidade de chamadas telefnicas convencionais e serem ficheiros menores que outros formatos.

Estrutura de pastas

/var/lib/asterisk/moh/: pasta onde ficam os udios de msica em espera. Para cada classe configurada no ficheiro musiconhold.conf podem ser criados novas pastas dentro desta.

/var/lib/asterisk/agi-bin/: armazena os scripts AGI. So utilizados para estender os recursos do Asterisk e facilitar a integrao com outros aplicativos.

/var/lib/asterisk/keys/: para garantir maior segurana possvel utilizar chaves criptografadas para autenticar extenses ou outros sistemas que utilizam DUNDi por exemplo. Nesta pasta so armazenadas essas chaves quando houver esse tipo de requisito em seu IP PBX.

Estrutura de pastas

/var/lib/asterisk/imagens/: uma pasta pouco utilizada atualmente, pois serve apenas para armazenar imagens. No entanto, poucos dispositivos suportam a visualizao de imagens. Porem se necessrio no futuro esse uso se ampliar, a pasta para esse tipo de recurso j est previsto.

/var/lib/asterisk/firmware/: armazena os rmwares de dispositivos compatveis com o Asterisk. Por padro o rmware do IAX se encontra nele. Tambm raramente utilizado; sua finalidade exata no est bem descrita.

/var/spool/asterisk/: nesta pasta so encontrados sub-pastas que armazenam ficheiros consumidos e gerados dinamicamente pelo sistema durante sua execuo (voicemail e gravaes por exemplo).

Estrutura de pastas

/var/spool/asterisk/monitor/: onde so armazenadas por padro as gravaes geradas pelos aplicativos Monitor() e MixMonitor() quando o caminho completo no passado como parmetro.

/var/spool/asterisk/voicemail/: para cada caixa postal gerado uma nova sub-pasta que ir conter as pastas e mensagens gravadas.

/var/spool/asterisk/outgoing/: essa pasta constantemente monitorada pelo Asterisk para que, assim que for colocado nela um ficheiro com um padro predefinido chamado de calle contendo informaes de marcao, essa chamada seja imediatamente executada.

Estrutura de pastas

/var/spool/asterisk/meetme/: quando feita a configurao para gravar uma conferncia, nessa pasta que os ficheiros gerados sero armazenados.

/var/spool/asterisk/dictate/: raramente utilizada, onde o aplicativo dictate ir procurar pelos ficheiros correspondentes quando necessrio.

/var/spool/asterisk/system/: quando utilizado o aplicativo system() para executar algum comando de dentro do plano de marcao direto do sistema operativo, nessa pasta que so armazenadas as informaes temporrias caso seja necessrio.

Estrutura de pastas

/var/spool/asterisk/tmp/: guarda dados temporrios gerados pelo Asterisk principalmente para fazer controle de concorrncia entre aplicativos de leitura e escrita em dados que esto sendo usados.

/var/run/: contm o ficheiro com o PID (Process ID nmero que identifica o processo quando em execuo) que gerado quando o Asterisk inicializado.

/var/log/asterisk/: armazena os logs gerados pelo Asterisk. As informaes que sero escritas nos logs so configuradas no ficheiro logger.conf. Existe uma sub pasta chamada /var/log/asterisk/cdr-csv/ onde fica armazenado o ficheiro Master.csv que contm os registros dos bilhetes gerados no Asterisk. Esses bilhetes tambm podem ser personalizados e gerados em outra sub pasta, a /var/log/asterisk/cdr-custom/.

Iniciando o Asterisk

Para a inicializao do Asterisk, basta executar:

# rasterisk vvvvgci, na linha de comando do GNU/Linux. O prompt dever mudar para *CLI>. As opes mais usadas com o

comando # asterisk no Linux so os seguintes: (para mais informaes digite # man asterisk no prompt do Linux):

-v: indica o nvel de verbose que o Asterisk ir exibir aps iniciado, mltiplos v indicaro maior verbose;

-c: Inicia o Asterisk na consola. Executa o processo como utilizador e no como um daemon do sistema.

-i: Pede pelos cdigos criptogrficos de inicializao.


-d: ativa o modo debug; -g: gera coredumps em caso de segmentation fault; -G: grupo que iniciar o Asterisk; -r: conecta ao Asterisk que estiver sendo executado no servidor e no inicia

uma nova instncia. -U: utilizador que iniciar o Asterisk; -x: conecta ao Asterisk que estiver sendo executado, executa o

comando passado como parmetro, imprime o resultado na consola do Linux e fecha a conexo.

Exemplo: # rasterisk -x core show channels


Com base nas informaes anteriores o modo recomendado para trabalhar com o Asterisk j em produo :

# rasterisk -vvvvgci

No centOS possvel usar o comando service para o Asterisk.

# service asterisk start

# service asterisk restart

# service asterisk stop

# service asterisk status

Estes so satisfatrios para usar em testes, mas eles interrompem o servio, ento no so apropriados para um sistema em produo.

Comandos da consola do Asterisk

*CLI>core show version: Mostra a verso do Asterisk.*CLI>core show applications: Mostra a lista de aplicaes disponveis para serem usadas no plano de marcao do Asterisk.

*CLI>core show application : Mostra a descrio e a sintaxe da aplicao especificada.

*CLI>core show channel : Mostra informaes sobre o canal de comunicao especifico.

*CLI>core show translation: Mostra informaes sobre o tempo de transcodificao entre os codecs habilitados no Asterisk.


Procedimentos para parar e reinicializar o Asterisk em produo:

*CLI>core restart gracefully: Para de aceitar novas chamadas e reinicia quando todas as chamadas tiverem terminado.

*CLI>core restart now: Reinicia o Asterisk imediatamente, encerando todas as chamadas em curso.

*CLI>core restart when convenient: Reinicia o Asterisk quando no houver nenhuma atividade.


Para interromper a execuo do Asterisk possvel escolher entre os seguintes comandos na linha de comando:

*CLI>core stop gracefully: no permite que sejam geradas novas chamadas e espera as que esto em andamento acabarem para parar o servio;

*CLI>core stop now: derruba o Asterisk imediatamente;

*CLI>core stop when convenient: espera o momento em que no houverem mais chamadas para interromper o servio;

*CLI>core abort halt: opo para cancelar qualquer um dos comandos acima.


O ponto de exclamao usado para executar comandos GNU/Linux externos a consola do Asterisk. Voc pode tambm abrir um envelope do GNU/Linux dentro da consola do Asterisk.

*CLI> !

[root@pbxip~]#

Digite exit para retornar ao Asterisk.

Prtica 001:

Proceder com as Prticas; 02 - GSA-M3 - 001 - pratica_001;

Slide 1Slide 2Slide 3Slide 4Slide 5Slide 6Slide 7Slide 8Slide 9Slide 10Slide 11Slide 12Slide 13Slide 14Slide 15Slide 16Slide 17

Documents

01 - GSA-M3 - 001 - Conhecendo o Asterisk