Conhecendo o Asterisk:

MODULO 3 - 001
Janeiro 2013 Rio de Janeiro, Brasil
Professor: 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.

Page 2

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.

Page 3

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.

Page 4

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.

Page 5

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).

Page 6

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.

Page 7

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.

Page 8

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/.

Page 9

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.

Page 10

Iniciando o Asterisk
-d: ativa o modo debug;
-g: gera coredumps em caso de segmentation fault;
-G<grupo>: grupo que iniciar o Asterisk;
-r: conecta ao Asterisk que estiver sendo executado no servidor e no inicia
uma nova instncia.
-U<utilizador>: utilizador que iniciar o Asterisk;
-x<comando>: 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

Page 11

Iniciando o Asterisk
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.

Page 12

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 <application>: Mostra a descrio e a
sintaxe da aplicao especificada.
*CLI>core show channel <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.

Page 13

Comandos da consola do 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.

Page 14

Comandos da consola do Asterisk

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.

Page 15

Comandos da consola do Asterisk

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.

Page 16

Prtica 001:

Proceder com as Prticas;

02 - GSA-M3 - 001 - pratica_001;

Page 17