En Elastix se recomienda realizar el encendido y apagado del sistema Asterisk de la siguiente forma: Para parar todos los servicios

asociados con Asterisk: # amportal stop Para iniciar todos los servicios asociados con Asterisk: # amportal start Para reiniciar los servicios asociados con Asterisk: # amportal restart Tambin ser puede reiniciar el servicio Asterisk (ubicado en /etc/rc.d/init.d/asterisk) pero no es recomendable en Elastix.

Directorios Importantes en Asterisk Directorio /etc/asterisk/ /usr/lib/asterisk/modules/ /usr/sbin/ /var/log/asterisk/ /var/lib/asterisk/agi-bin/ /var/lib/asterisk/mohmp3 /var/lib/asterisk/sounds Descripcin Aqu residen los archivos de configuracin de asterisk Este directorio contiene los mdulos de Asterisk Aqu reside el binario de Asterisk Contiene los logs de Asterisk Directorio donde residen los scripts AGI Carpeta que contiene archivos para msica en espera Sonidos que Asterisk utiliza como prompts de voz Directorio donde Asterisk guarda archivos que genera producto de su funcionamiento como voicemails y grabaciones de llamadas Archivos con informacin de PIDs Aqu residen los archivos de log de /var/log/asterisk/full o el log de texto de CDRs

/var/spool/asterisk/ /var/run/

/var/log/asterisk/

Los modulos de Asterisk ubicados en /usr/lib/asterisk/modules/ termina con la extensin .so y se pueden controlar con el archivo de configuracin modules.conf colocando las palabras load y noload para determinar que modulos cargar y no cargar.

DAHDI

Es el Antiguo Zaptel

Archivos de Configuracin de Asterisk Archivo Descripcin Aqu reside el plan de marcado. En Elastix este archivo incluye otros ms para organizar el plan de marcado de mejor manera. Estos archivos adicionales empiezan con la cadena extensions_ Aqu se definen los endpoints SIP Aqu se definen los endpoints IAX Archivo de configuracin de los canales tipo ZAP. Aqu se puede troncalizar dichos canales y configurar algunos parmetros

extensions.conf sip.conf iax.conf

zapata.conf

El archivo extensions.conf incluye dos archivos importantes extensions_additional.conf y extensions_custom.conf . El primero incluye las configuracin hechas a travs de Freepbx, y el segundo las configuracin hechas a mano. Las lneas del plan de marcado siguen bsicamente este formato. exten => nombre_extension, prioridad, aplicacin en el nombre de extensin existe una extensin especial llamada s, que significa Start es decir inicio, significa cuando el usuario aun no ha presionado el nmero de extensin. La prioridad es el nmero de orden en que asterisk ejecuta la instruccin, existen dos prioridades especiales s y n, n significa el nmero anterior ms uno. Variables Las Aplicaciones utilizan variales de la forma ${nombre} , estas variables puedes ser de tres tipos. Globales: Definidas en la seccin [globals] del archivo extensions.conf De Canal: Definidas por el comando set

Predefinidad : Asterisk se encarga de administrar algunos nombres de variables por su cuenta. Estos nombres se encuentran predefinidos y se llenan con cierta informacin dependiendo del comportamiento de la llamada o de otros factores. Algunas variables predefinidas son: ${CALLERID} ${CALLERIDNAME} ${CALLERIDNUM} ${CHANNEL} ${CONTEXT} ${EPOCH} ${EXTEN} ${SIPUSERAGENT} ${UNIQUEID}

Aplicaciones Answer Sintaxis: Answer([delay]) Contesta un canal si este est timbrando. Puede recibir opcionalmente el parmetro delay que le indica si debe esperar un nmero determinado de milisegundos antes de contestar. Background Sintaxis: Background(filename1[&filename2...][|opciones[|langoverride ][|context]]) Reproduce un listado de archivos de audio en el fondo, es decir que devuelve el control a Asterisk, quien puede continuar ejecutando el plan de marcado mientras el audio contina siendo reproducido. Cuando termina de reproducir el ltimo archivo termina su ejecucin por lo que si se quiere seguir esperando por una extensin se debe usar otra aplicacin en conjunto llamada WaitExten. Esta aplicacin es tpicamente usada para reproducir el mensaje de bienvenida de un IVR.

La aplicacin Background puede recibir algunas opciones: Opcin s n Descripcin Saltarse la reproduccin del audio si el canal no se encuentra contestado No contestar el canal antes de reproducir los archivos Dejar de reproducir el audio si un dgito marcado coincide con una extensin existente en el contexto destino

Playback Sintaxis: Playback(filename1[&filename2...][,options]) Reproduce uno o ms archivos de audio. La diferencia con la aplicacin Background es que Playback reproduce todo el archivo de audio hasta el final y no retorna el control hasta que termina la reproduccin. Nota: No es necesario especificar la extensin del archivo de audio en esta funcin. Los archivos de audio son buscados en el directorio /var/lib/asterisk/sounds

Hangup Sintaxis: Hangup() Cuelga el canal y retorna -1

Goto Sintaxis: Goto([[context|]extension|]priority) Salta la ejecucin del plan de marcado a un contexto, extensin y prioridades dados. Si solo se pasa un parmetro se sobreentiende que se trata de una prioridad dentro del mismo contexto. Dial Sintaxis: Dial(type/identifier, timeout, options, URL) Este comando es el que hace la magia. Marca un canal especificado y lo vincula con el canal corriente.

ASTERISK CLI Des de la lnea de Comando se debe ejecutar # asterisk r El CLI muestra informacin en tiempo real del funcionamiento de Asterisk Nota: Debido al gran volumen de informacin que se puede generar con estos comandos es importante reestablecer los valores de las variables debug y verbose a los mnimos al finalizar nuestras tareas de diagnstico. Caso contrario Asterisk continuar generando esta informacin detallada cuando realmente no la necesitamos, lo cual es un trabajo extra que consume recursos. En sistemas con mucha actividad este gasto extra puede ser significativo y afectar el desempeo de las llamadas. Comandos CLI Comando agi debug Descripcin Permite habilitar el debug de scripts AGI. Se apaga con agi debug off Habilita el debug en un canal determinado core set debug Permite cambiar el nivel de debugging. Se apaga con core set debug off El mayor valor es 9 Incrementa la intensidad del logging. Muy til en diagnstico. El mayor valor es 9 Muestra informacin de los canales activos en el instante de ejecutar el comando Recarga todo el plan de marcado Muestra el plan de marcado Muestra un listado con todos los comandos de CLI disponibles Habilita el debug a nivel de IAX2. Se deshabilita con el comando iax2 set debug off Muestra los peers definidos y alguna informacin adicional como el IP desde donde se conectan, el estatus, entre otros datos

core set debug channel core set verbose core show channels dialplan reload dialplan show help

iax2 set debug

iax2 show peers

iax2 show registry pri debug span restart gracefully restart now

Muestra informacin de registro IAX2 e informacin como el estatus y el IP a la que se trata de conectar module reload Recarga todos los mdulos de Asterisk. til para aplicar los cambios hechos en los archivos de configuracin Habilita debug de un span determinado de una interfase PRI Reinicia Asterisk de manera ordenada Reinicia Asterisk de manera brusca Reinicia Asterisk cuando no haya actividad en la central. Adecuado en ambientes de produccin donde no tenemos otra opcin que reiniciar la central pero no queremos tampoco que se corten llamadas Habilita debug de SIP a nivel de una direccin IP especfica Habilita debug de SIP a nivel de un peer especfico Muestra un listado con todos los peers SIP configurados e informacin de cada uno de ellos como el estatus Muestra un listado con los registros SIP e informacin relevante de cada uno de ellos Detiene Asterisk de manera ordenada Detiene Asterisk de manera brusca Detiene Asterisk cuando no haya actividad en la central. Adecuado en ambientes de produccin donde no tenemos otra opcin que reiniciar la central pero no queremos tampoco que se corten llamadas. Muestra un listado de los canales ZAP y algunos parmetros de funcionamiento. Muestra un listado de los dispositivos ZAP y un reporte de alarmas y errores

restart when convenient sip set debug ip sip set debug peer

sip show peers

sip show registry stop gracefully stop now

stop when convenient zap show channels zap show status

AGI (Asterisk Gateway Interface) es la manera de interacin la central asterisk con otras aplicaciones por medio de Scripts, con ello podemos entre otras cosas hacer interactuar nuestra central Asterisk con una base de datos. Elastix tiene algunos scripts AGI preinstalados en la carpeta /var/lib/asterisk/agi-bin/ Para que nuestro script funcione de la forma adecuada hay que asegurarse que cuenta con los permisos necesarios. # chown asterisk.asterisk script_prueba.agi # chmod 755 script_prueba.agi Se pueden ejecutar en el dialplan gracias a la funcion AGI. exten => 6789,1,Answer exten => 6789,2,AGI(script_prueba.agi) Como vemos en el ejemplo anterior le hemos dicho a Asterisk que ejecute el script llamado script_prueba.agi. Este script se ejecutar cuando el usuario digite la extensin 6789. Por omisin Asterisk asume que el script se encuentra en la ruta /var/lib/asterisk/agi-bin/ as que si lo ubicamos en un lugar diferente habr que especificar la ruta completa.