Elastix slide book-ect

Capítulo 1

Elastix Certified Technician PaloSanto Solutions 2012 – © Todos los derechos reservados

INSTALACIÓN DE ELASTIX

Instalando desde CD Es recomendable instalar la última versión estable de Elastix disponible en la página del

proyecto.

Para realizar la instalación desde CD, debemos descargar el archivo de imagen (con

extensión iso), y grabarlo en un disco en blanco.

Es importante grabar el iso usando software especializado para este propósito.

muchas veces caemos en el error de descomprimir la imagen y copiar la estructura de

directorios resultantes en un disco, con lo cual NO obtendremos un CD de arranque.

Una vez que tenemos un CD de instalación creado, lo insertamos en la unidad y

procedemos a encender el equipo.

Es importante verificar que el computador esté configurado para arrancar desde CD.

Esto puede ser configurado en el BIOS.

El instalador de Elastix aparecerá en nuestra pantalla.

Una vez que tenemos un CD de instalación creado, lo insertamos en la unidad y

procedemos a encender el equipo.

Es importante verificar que el computador esté configurado para arrancar desde CD.

Esto puede ser configurado en el BIOS.

El instalador de Elastix aparecerá en nuestra pantalla.

Para realizar una instalación estándar basta con presionar ENTER

Advertencia: La instalación estándar borrará completamente el disco duro.

1

Capítulo 1


Seleccionamos el idioma para la instalación.

El instalador nos pide seleccionar el esquema del teclado

Seleccionamos el tipo de particionamiento (primera opción).

2

Capítulo 1


Confirmamos que se remuevan todas las particiones (Sí).

Revisar/modificar la capa de partiticiones (No).

Configurar interfaces de red (Sí).

3

Capítulo 1


Seleccionar que se active al inicio y soporte para IPv4.

Seleccionar ya sea DHCP o configuración manual.

Si se utiliza configuración manual, ingresar la dirección y la máscara.

4

Capítulo 1


Ingresar la dirección IP de la puerta de enlace y del servidor DNS.

Ingresar el nombre del host.

Seleccionamos el huso horario adecuado.

5

Capítulo 1


Ingresar la contraseña del usuario root

Esperar hasta que finalice la instalación automática de paquetes.

Ingresamos la contraseña para el usuario root de MySQL (no confundir con usuario

root de linux).

6

Capítulo 1


Ingresar nuevamente la contraseña de root de MySQL.

Ingresar la contraseña para el usuario ‘admin’ del web GUI de Elastix.

Nota: Esta será además la contraseña para los siguientes servicios: FreePBX, Vtiger, A2Billing y FOP.

Aunque no se menciona esta contraseña es además la contraseña del AMI admin.

Ingresar nuevamente la contraseña ‘admin’ de Elastix.

7

Capítulo 1


La instalación ha sido completada, podremos ingresar a nuestro sistema con usuario

root y su contraseña ingresada durante la instalación.

Instalación con soft RAID RAID hace referencia a utilizar varios discos duros en arreglo, principalmente para

ofrecer redundancia de información.

Dependiendo el número de discos que se disponga y la forma en la que se configure el

arreglo, se pueden obtener diferentes niveles de RAID.

El que se verá a continuación es de nivel 1, en el que intervienen dos discos duros y

uno es espejo del otro.

RAID hace referencia a utilizar varios discos duros en arreglo, principalmente para






RAID hace referencia a utilizar varios discos duros en arreglo, principalmente para






8

Capítulo 1


Observaremos ambos discos, debemos crear tres (3) particiones en cada uno.

Seleccione la opción "Nuevo”

Tamaños de disco:

1era partición = 100MB para el boot,

2da partición = el doble del tamaño del RAM del sistema para swap (en este ejemplo el

RAM es 512 MB),

3ra partición = debe ser completada con el espacio disponible.

9

Capítulo 1


En cada partición debemos seleccionar "software RAID" como el "Tipo de sistema de

archivos".

Recuerde seleccionar la correspondiente "Unidad admisible", en la imagen del ejemplo

es "hda".

Imagen del proceso para la segunda partición (swap)

Imagen del proceso para la tercera partición (seleccionamos ocupar todo el espacio disponible)

Al final tendremos 3 particiones en cada disco.

No se preocupe por el orden de cada partición se re-ordenarán cuando configuremos

el RAID.

10

Capítulo 1


Para iniciar la partición en espejos debemos seleccionar la opción "RAID".

Aquí seleccionaremos las particiones que serán miembros del RAID, el "Tipo de

sistema de archivos" y el "Punto de montaje".

Punto de Montaje: partición boot = /boot, swap = no coloque nada, partición "root"

= use /

Tipo de sistema de archivos: partición boot = seleccione ext3, partición swap =

seleccione swap, y seleccione ext3 para la partición "root".

Niveles de RAID: Seleccione RAID1 para todas las particiones.

Miembros del RAID: Escoja el par de particiones que han sido creadas en cada uno

de los discos respectivamente.

Ejemplo del espejo en la partición boot.

Nota: Es importante seleccionar los particiones correspondientes en la sección “Miembros del RAID”. En este

ejemplo hda2 y sda2 son las particiones con 100MB para boot.

Las configuraciones de RAID aparecerán sobre las particiones previamente creadas.

Cuando finalice seleccione "Aceptar" para continuar con la instalación normalmente.

11

Capítulo 2


VIRTUALIZACIÓN

Virtualización

Una máquina virtual simula un sistema físico con características de hardware

específicas.

En un solo servidor se pueden implementar varias máquinas virtuales para cumplir

varios servicios.

Esto nos permite la reutilización de hardware existente, lo cual implica ahorro de

recursos.

Nos permite además reducción de costos y una administración global centralizada y

simple.

En un solo espacio podemos tener varios servidores virtuales sin incrementar el

consumo de energía.

Eso ha hecho muy populares los servicios de Hosted PBX, debido a la posibilidad de

virtualizar Elastix en lugar de disponer de un servidor por cliente.

Permite crear un ambiente de pruebas sin afectar la operación real, lo cual es útil

previo a una actualización y nos será útil en este curso para probar el potencial de

Elastix.

12

Capítulo 2


Entre las alternativas que revisaremos están:

VMware

VirtualBox

XEN

VMware Una máquina virtual simula un sistema físico con características de hardware

específicas.

En un solo servidor se pueden implementar varias máquinas virtuales para cumplir

varios servicios.

Esto nos permite la reutilización de hardware existente, lo cual implica ahorro de

recursos.

Nos permite además reducción de costos y una administración global centralizada y

simple.

VMware Player está creada para usuarios sin licencia para usar Workstation.

Inicialmente no permitía crear máquinas virtuales, pero esta limitación fue removida en

la versión 3.0.1. Está disponible para Windows y Linux.

VMware Server es distribuida gratuitamente para uso no comercial y es la alternativa

para servidores. Se recomienda para pruebas y no para servidores en producción

Página web: http://www.vmware.com/

VirtualBox Es un software de virtualización para arquitecturas x86/amd64 desarrollado

actualmente por Oracle Corporation.

Funciona bajo el concepto de sistemas tipo Guest instalados en un sistema operativo

host, cada uno con su propio ambiente virtual

Sistemas operativos soportados en modo anfitrión: GNU/Linux, Mac OS X, OS/2,

Microsoft Windows y Solaris/OpenSolaris.

Sistemas operativos Guest: FreeBSD, GNU/Linux, OpenBSD, OS/2 Warp, Windows,

Solaris, MS-DOS, entre otros.

13

Capítulo 2


Es un software de virtualización para arquitecturas x86/amd64 desarrollado








Es un software de virtualización para arquitecturas x86/amd64 desarrollado








Redes en VirtualBox Es necesario configurar el tipo de red que utilizará Elastix. Existen 6 tipos de redes

No conectado: simula una computadora sin cable de red

NAT: Funciona sólo para acceder a redes externas pero no se puede acceder a la

máquina remotamente

Adaptador puente: Simula redes. Cuando está habilitado, VirtualBox conecta uno de

los dispositivos de red e intercambia paquetes directamente.

Red interna: Sirve para simular redes con otras máquinas virtuales

Adaptador solo-anfitrión: La máquina virtual es vista como otra máquina en la red.

Controlador genérico: usado para compartir una interfaz de red genérica. Un

ejemplo es la interconexión entre dos máquinas virtuales ubicados en diferentes hosts.

Con Elastix podemos usar: Adaptador puente y Adaptador solo anfitrión. Para este

curso utilizaremos Adaptador puente.

14

Capítulo 2


XEN Es la alternativa más eficiente de virtualización

Solución recomendada para servidores por su eficiencia

Es lo que utilizan la mayoría de proveedores de hosting de VPS con Elastix

Existe 2 tipos de virtualización: completa y para-virtual

Permite hacer migraciones de máquinas virtuales en caliente

Es software libre: http://www.xen.org/

Arquitectura en XEN XEN se comunica directamente con el hardware a través de un componente llamado

Hipervisor.

Cuando XEN arranca levanta automáticamente un dominio conocido como dom0

Dom0 es un dominio privilegiado donde se administran otros dominios.

Los demás dominios son conocidos como domU

Instalar Elastix en XEN Existen varias formas en las que se puede instalar Elastix con XEN

Se necesita un servidor XEN sobre el cual se instalará Elastix. CentOS es muy buena

opción para este servidor

Se puede instalar con virtualización completa o paravirtual

Se puede instalar sobre una máquina virtual de CentOS 5.x. Esto es muy útil si

tenemos un servidor VPS remoto con CentOS cargado

15

Capítulo 3


LINUX PARA ADMINISTRADORES DE ELASTIX

Introducción GNU/Linux es un sistema operativo de software libre

Asterisk y Elastix funcionan sobre Linux

Para administrar una central Elastix no es necesario ser experto en Linux pero es muy

útil conocer del tema.

Es la interfaz de texto entre el usuario y el sistema operativo

Se puede acceder localmente

Se puede acceder remotamente a través del protocolo SSH (Secure Shell)

El SSH es un protocolo encriptado.

Línea de Comandos en Linux Ejemplo terminal Linux de Elastix:.

16

Capítulo 3


Comandos Básicos

Sistema de Archivos Estructura de árbol de directorios

Todos empiezan en la raíz → /

Directorios importantes en Elastix:

o /etc/asterisk: guarda la configuración de Asterisk

o /var/www/html: se encuentra Elastix

o /var/lib/mysql: las bases de datos de mysql

o /var/log: los archivos de log.

Comando Descripción

ls Lista los archivos en el directorio actual.

ls -la Lista los archivos y sus atributos

cd Cambia de directorio

cd .. Cambia el directorio padre

cat Muestra el contenido de un archivo en la pantalla

pwd Muestra la ruta actual

cp Copia un archivo o grupo de ellos.

mv Mueve un archivo. También se lo usa para renombrar archivos.

rm Elimina un archivo

tail -f filename Muestra las últimas líneas de un archivo

mkdir Crea un directorio

tar zxvf filename.tar.gz Descomprime un archivo .tar.gz

top Muestra un reporte en tiempo real de los procesos que se ejecutan en el sistema. Puede ser ordenado por consumo de memoria o CPU. Muy útil para diagnóstico.

find Permite buscar archivos

vim Programa para ver y editar archivos de texto plano.

ifconfig Muestra información de las interfaces de red y permite modificarlas temporalmente.

ps -aux Muestra un reporte de los procesos que se están ejecutando en el servidor.

reboot Reinicia el equipo

shutdown -h now Apaga el equipo

17

Capítulo 3


Permisos Todo archivo pertenece a un usuario y a un grupo

Los permisos son 3 niveles: usuario, grupo, otros

Los permisos pueden ser de lectura (r), escritura(w) y ejecución(x)

Ejemplo: rwxrw-rw- ; juan - elastix - archivo

o En este caso el archivo pertenece a juan y al grupo elastix. Los permisos para juan

son de rwx, grupo elastix rw y otros rw

Permisos: Notación Octogonal Los permisos se pueden representar con números

r=4, w=2 y x=1

Ejemplos:

o 766=rwxrw-rw-

o 600= rw-------

o 644=rw-r--r--

RPM Forma tradicional de instalar paquetes

Se usa para instalar y desinstalar paquetes

o Instalar: rpm -ivh paquete.rpm

o Desinstalar: rpm -e paquete

Consultas sobre paquetes instalados

Todos paquetes instalados: rpm -qa

Todos los paquetes que contengan asterisk:

o rpm -qa | grep asterisk

Rpm tiene problemas de dependencias

18

Capítulo 3


YUM Maneja la instalación de paquetes desde repositorios

Los repositorios pueden estar en Internet o en la lan

No existe problemas de dependencias

Ejemplos de uso:

o Instala paquete: yum install paquete

o Borra paquete: yum remove paquete

o Actualiza paquete: yum update paquete

o Actualiza todo el sistema operativo: yum update

19

Capítulo 4


ELASTIX: GENERALIDADES

¿Qué es Elastix? Una solución de servidor de comunicaciones unificadas: telefonía, fax, IM, email,

colaboración.

Es Software Libre.

Se distribuye como una imagen ISO para quemar en CD.

Incluye instalador.

Basada en Linux (CentOS), Asterisk, FreePBX, Hylafax, Postfix y Openfire.

Además de otros paquetes de código abierto.

Rápido crecimiento, 1’000.000 descargas hasta Noviembre de 2010.

Reconocimiento con el premio INTERNET TELEPHONY product of the year Award

años 2011 y 2012

¿Servidor de Comunicaciones Unificadas? Integración de diferentes sistemas de comunicaciones.

Por ejemplo, el teléfono es contestado por Asterisk (telefonía) y en caso de resultar un

documento de fax le pasa el control a Hylafax (FAX) quien recibe el documento y lo

envía por email a través de Postfix a su destinatario.

Mejora la productividad: ahorro de tiempo, papel, mejor acceso a la información

compartida.

Esquema General

20

Capítulo 4


Breve historia del Proyecto Lanzado en Marzo de 2006 por la compañía PaloSanto Solutions de Ecuador.

Inicialmente no era una distro sino una interfaz de reportación para llamadas de

Asterisk

En Diciembre de 2006 se lanza la primera versión en formato distro. Ganó popularidad

por su usabilidad.

En 2007 y 2008 el proyecto estuvo nominado a los premios CCA de SourceForge.

Actualmente es una de las distros basadas en Asterisk líder del mercado.

Características de Elastix Algunas de las características y funcionalidades de Elastix son:

Voicemail

Fax-a-email

Soporte para soft phones

Consola de operador

IVR (recepcionista digital)

Interfaz de configuración Web

Sala de conferencias

Music-on-hold con soporte mp3s

Campañas de tele-mercadeo

Grabación de llamadas

Parqueo de llamadas

Call-pickup

Colas de atención

Limitación de tiempo de llamada

Least Cost Routing

Roaming de extensiones

Interconexión entre PBXs

Identificación del llamante

CRM incluido Reportación avanzada

Personalización y desarrollo

Para un mayor detalle de todas las funcionalidades consulte Elastix.org

Licenciamiento de Elastix Elastix es software libre licenciado bajo GPL versión 2:

http://elx.ec/gpl2

Esto quiere decir que se puede copiar, distribuir y modificar el software libremente.

No existen versiones cerradas ni doble licenciamiento (como es el caso de Asterisk o

MySQL).

Por si todavía existe la duda: Elastix puede ser descargado sin costo alguno.

21

Capítulo 4


Interfaz Web de administración

Menú System

Menú PBX

Menú Email

Menú Fax

22

Capítulo 4


Menú Reports

Menú extendido

Interfaz Web de administración Módulo de Add-ons: Funcionalidad adicional disponible en un sólo clic

www.elastix.org

Sitio Web oficial del proyecto.

Mantenido por PaloSanto Solutions y la comunidad Elastix.

Aquí podemos encontrar:

Foros

Wiki (Documentación)

Chat en vivo IRC

Suscripción a listas de correo

Links de descargas

Información Comercial y Proyectos

Eventos

23

Capítulo 5


FUNCIONAMIENTO INTERNO DE FREEPBX

Fundamentos de FreePBX Software de configuración de Asterisk

Integrado en la distribución Elastix

Genera los archivos de configuración de Asterisk

o Incluye el plan de marcado

o Basados en la configuración ingresada por el usuario

Dos pasos para la configuración:

o Guarda la información en una base de datos de configuración.

o En el caso de Elastix el motor de base de datos usado es MySQL.

o Convierte la información de la base de datos en archivos de configuración a

través de parsing.

24

Capítulo 5


Organización de archivos

Configuración de FreePBX amportal.conf: Archivo de texto plano, leído por FreePBX.

Información general de configuración.

Editable en caso de requerirse.

Información de acceso a la base de datos.

Tipo de autenticación para usuarios Web.

Documentación para manejo de opciones y directivas de configuración.

retrieve.conf: Escrito en PHP

Genera el plan de marcado a partir de la información almacenada en la base de datos.

Directorio Descripción

/var/www/html/admin/ Directorio principal del GUI de FreePBX.

/var/www/html/panel/ Directorio del Flash Operator Panel.

/etc/asterisk/ Directorio de archivos de configuración de Asterisk.

/var/lib/asterisk/agi-bin/ Directorio de scripts AGI de Asterisk

/var/lib/asterisk/bin/ Directorio de binarios, links simbólicos a carpetas de módulos.

/usr/local/sbin/ Directorio con script amportal, manipulado solo por root.

/var/lib/asterisk/sounds/ Directorio con sonidos del plan de marcado.

/var/lib/asterisk/sounds/custom/ Directorio con sonidos creados por el usuario.

/var/spool/asterisk/voicemail/ Directorio de almacenamiento de voicemails.

/var/spool/asterisk/monitor/ Directorio de almacenamiento de grabaciones de voz.

25

Capítulo 5


Programa ejecutable desde la línea de comandos.

Se ejecuta a través de un script PHP, cada vez que se da clic en la barra roja de FreePBX (”Apply Configuration Changes Here”).

Esta operación será muy frecuente en la mayoría de las configuraciones que realicemos

en el menú de PBX.

dialparties.agi: Script AGI escrito en PHP

Se ejecuta desde el plan de marcado cuando se realiza una llamada.

Revisa el estado de la extensión y otras configuraciones de la misma (call forward, call

waiting, do not disturb).

Toma acciones a partir del estado y la configuración de la extensión.

dialparties.agi consulta la base de datos de Asterisk ubicada en /var/lib/asterisk/astdb/

Se puede ejecutar desde el CLI (Command Line Interpreter) de asterisk

dialparties.agi está ubicado en /var/lib/asterisk/agi-bin/dialparties.agi

Módulo de FreePBX: Estructura

Nombre del Archivo Descripción

module.xml Información del módulo en formato XML.

page.nombredelmodulo.php Archivo principal del módulo escrito en PHP.

functions.inc.php Librería especial con funciones PHP.

install.sql Contiene sentencias SQL que se ejecutan sobre la base de datos al instalar el módulo.

uninstall.sql Contiene sentencias SQL para desinstalar el módulo.

install.php Script PHP que se ejecuta al momento de instalar el módulo.

uninstall.php Script PHP que se ejecuta al momento de desinstalar el módulo

26

Capítulo 5


¿Cómo se embebe en Elastix? Para poder embeber freePBX en Elastix se desarrolló un código WRAPPER

Este código se acopla los módulos de freePBX como un módulo Elastix.

Este desarrollo consiste en:

o Módulo pbxadmin de Elastix

o Archivo /var/www/html/config.php

Módulo pbxadmin de Elastix

Encargado de obtener el contenido de módulos de freePBX por medio de inclusión de

archivos de PHP.

El index.php de éste módulo (Elastix) es muy parecido al index de freePBX (llamado

config.php), pero quitando todos los estilos propios de freePBX.

Contiene un archivo javascript (libfreepbx.javascripts.js) que es una copia mínima del que

esta ubicado dentro del código de freePBX para mantener las acciones que se dan en la

GUI

Archivo /var/www/html/config.php

Este archivo recibe las peticiones hechas desde módulos de freePBX.

Lo que hace es redireccionar las peticiones al módulo pbxadmin de Elastix e incluir el

index.php del framework Elastix.

Gráfico ilustrativo de FreePBX embebido

config.phpIndex.php

Framework Elastix


Redirecciona las peticiones a

Redirecciona a

Obtiene el contenido de módulos de FreePBX pero sin estilos

Módulos de FreePBXHacen las peticiones alconfig.php ubicado enla raíz

WRAPPER

1

23

4

27

Capítulo 5


FUNCIONAMIENTO INTERNO DE FREEPBX

Fundamentos de FreePBX Software de configuración de Asterisk

Integrado en la distribución Elastix

Genera los archivos de configuración de Asterisk

o Incluye el plan de marcado

o Basados en la configuración ingresada por el usuario

Dos pasos para la configuración:

o Guarda la información en una base de datos de configuración.

o En el caso de Elastix el motor de base de datos usado es MySQL.

o Convierte la información de la base de datos en archivos de configuración a

través de parsing.

28

Capítulo 5


Organización de archivos

Configuración de FreePBX amportal.conf: Archivo de texto plano, leído por FreePBX.

Información general de configuración.

Editable en caso de requerirse.

Información de acceso a la base de datos.

Tipo de autenticación para usuarios Web.

Documentación para manejo de opciones y directivas de configuración.

retrieve.conf: Escrito en PHP

Genera el plan de marcado a partir de la información almacenada en la base de datos.

Directorio Descripción

/var/www/html/admin/ Directorio principal del GUI de FreePBX.

/var/www/html/panel/ Directorio del Flash Operator Panel.

/etc/asterisk/ Directorio de archivos de configuración de Asterisk.

/var/lib/asterisk/agi-bin/ Directorio de scripts AGI de Asterisk

/var/lib/asterisk/bin/ Directorio de binarios, links simbólicos a carpetas de módulos.

/usr/local/sbin/ Directorio con script amportal, manipulado solo por root.

/var/lib/asterisk/sounds/ Directorio con sonidos del plan de marcado.

/var/lib/asterisk/sounds/custom/ Directorio con sonidos creados por el usuario.

/var/spool/asterisk/voicemail/ Directorio de almacenamiento de voicemails.

/var/spool/asterisk/monitor/ Directorio de almacenamiento de grabaciones de voz.

29

Capítulo 5


Programa ejecutable desde la línea de comandos.

Se ejecuta a través de un script PHP, cada vez que se da clic en la barra roja de FreePBX (”Apply Configuration Changes Here”).

Esta operación será muy frecuente en la mayoría de las configuraciones que realicemos

en el menú de PBX.

dialparties.agi: Script AGI escrito en PHP

Se ejecuta desde el plan de marcado cuando se realiza una llamada.

Revisa el estado de la extensión y otras configuraciones de la misma (call forward, call

waiting, do not disturb).

Toma acciones a partir del estado y la configuración de la extensión.

dialparties.agi consulta la base de datos de Asterisk ubicada en /var/lib/asterisk/astdb/

Se puede ejecutar desde el CLI (Command Line Interpreter) de asterisk

dialparties.agi está ubicado en /var/lib/asterisk/agi-bin/dialparties.agi

Módulo de FreePBX: Estructura

Nombre del Archivo Descripción

module.xml Información del módulo en formato XML.

page.nombredelmodulo.php Archivo principal del módulo escrito en PHP.

functions.inc.php Librería especial con funciones PHP.

install.sql Contiene sentencias SQL que se ejecutan sobre la base de datos al instalar el módulo.

uninstall.sql Contiene sentencias SQL para desinstalar el módulo.

install.php Script PHP que se ejecuta al momento de instalar el módulo.

uninstall.php Script PHP que se ejecuta al momento de desinstalar el módulo

30

Capítulo 5


¿Cómo se embebe en Elastix? Para poder embeber freePBX en Elastix se desarrolló un código WRAPPER

Este código se acopla los módulos de freePBX como un módulo Elastix.

Este desarrollo consiste en:

o Módulo pbxadmin de Elastix

o Archivo /var/www/html/config.php


Encargado de obtener el contenido de módulos de freePBX por medio de inclusión de

archivos de PHP.

El index.php de éste módulo (Elastix) es muy parecido al index de freePBX (llamado

config.php), pero quitando todos los estilos propios de freePBX.

Contiene un archivo javascript (libfreepbx.javascripts.js) que es una copia mínima del que

esta ubicado dentro del código de freePBX para mantener las acciones que se dan en la

GUI

Archivo /var/www/html/config.php

Este archivo recibe las peticiones hechas desde módulos de freePBX.

Lo que hace es redireccionar las peticiones al módulo pbxadmin de Elastix e incluir el

index.php del framework Elastix.

Gráfico ilustrativo de FreePBX embebido

config.phpIndex.php

Framework Elastix


Redirecciona las peticiones a

Redirecciona a

Obtiene el contenido de módulos de FreePBX pero sin estilos

Módulos de FreePBXHacen las peticiones alconfig.php ubicado enla raíz

WRAPPER

1

23

4

31

Capítulo 6


CONFIGURACIÓN BÁSICA DE ELASTIX

Ingreso a Elastix vía Web Abrir en un navegador web: https://ip-servidor (Dirección IP de Elastix)

La primera vez se debe aceptar el certificado digital. De ser necesario establezca un

excepción en su navegador web

Ingresar con los siguientes datos

Usuario: admin

Password: La clave de admin registrada durante la instalación

Configuración de Red Elastix utiliza DHCP por defecto

En la mayoría de casos se debe configurar:

IP estático

Puerta de Enlace

DNS

Para configurar se debe acceder al menú Sistema → Red

Los dispositivos de red se reconocen como ethernet1, ethernet2, etc...

32

Capítulo 6


Creando una extensión Se pueden crear extensiones: sip, iax, zap, dahdi y custom

SIP: protocolo estándar para terminales de voz/ip. Soportado por la mayoría de

teléfonos de ip

IAX: Protocolo propio de Asterisk y no muy difundido. Se comporta mejor que

sip en ambientes nat

Zap: Usada para extensiones análogas o tradicionales

dahdi: Usada para extensiones análogas o tradicionales

Custom: Se puede utilizar para opciones avanzadas. Por ejemplo mapear una

línea externa a una extensión

Ejemplo para crear extensión SIP Para crear una extensión ingrese a:

PBX → PBX Configuration → extensiones

Seleccione: Generic SIP Device

Como mínimo debe ingresar: número de extensión, display name y el secret

El mode DTMF (dtmfmode) de la extensión y teléfono debe ser el mismo.

El dtmfmode predeterminado es: rfc2833

Otras opciones para el modo rfc son:

info

inband

auto

33

Capítulo 6


Ejemplo: Configuración de Softphone La configuración de un teléfono IP de software debe incluir por lo menos: el usuario

(normalmente la extensión), el password (secret) y la dirección IP del servidor Elastix.

En la gráfica: configuración de cuenta en el softphone Zoiper

Configuraciones generales Configuraciones importantes

Opciones de marcado: Se definen opciones como transferencia de llamada y

grabación de llamadas

Company Directory: Para acceder al directorio telefónico desde un ivr con *411 o

#

Security Settings: No permite llamadas sip anónimas

Actualizaciones: Bloqueada por defecto

Colas Agrupan a varias extensiones conocidas como agentes

Agentes estáticos o dinámicos

Existen varias Estrategias de marcado:

Sonar todos: Timbra a todos los miembros de la cola

Agente con última llamada más antigua: Timbra al agente que fue llamado menos

recientemente

Agente con menos llamadas: Timbra al agente que menos llamadas a contestado

Estrategias de marcado:

Aleatorio: Timbra aleatoriamente

Con memoria: Timbra a cada agente de manera secuencial

Linear: Timbra a los agentes en el orden especificado

34

Capítulo 6


Wrandom: Timbra las extensiones de los agentes e manera aleatoria pero

utilizando una penalidad como medida de probabilidad.

Colas: configuración básica Queue number: El número por el que se podrá llamar a la extensión

Queue name: El nombre de la cola que usaremos para identificar en la interfaz

administrativa

Queue password: Clave que deberá ingresar un agente dinámico

CID name prefix: Como un agente puede hacer login en varias colas al mismo tiempo,

es útil colocarle un prefijo al Caller ID para que cuando el agente vea la llamada

entrante en el teléfono sepa a que cola pertenece la llamada.

Static Agents: Se lista las extensiones a agentes y su prioridad en la cola.

Max callers: El número máximo de personas que esperan en una cola si todos los

agentes están ocupados.

Join Empty: Se puede permitir que la cola funcione sin agentes. No se recomienda

Leave when empty: si se pone en yes, los usuarios que estén en espera en la cola serán

removidos de la misma si todos los agentes abandonan la cola.

Ring strategy: Existen 6 tipos de estrategias: ringall, leastrecent, fewestcalls, random,

rrmemory, linear, wrandom.

Wrap-up-time: Tiempo entre llamadas exitosas por agente

Call Recording: Opción para grabar llamadas

Fail Over Destination: Destino a donde van las llamadas entrantes no contestadas

IVR Un IVR funciona como una recepcionista digital

Es necesario grabar o subir sonidos al servidor antes de configurar el IVR

Se pueden tener tantos IVR como sean necesarios

Para que sean accesibles desde las troncales se deben configurar rutas entrantes

IVR: Grabar o subir sonido Para grabar o subir un sonido se debe ingresar a PBX → PBX Configuration →

Grabaciones del Sistema

35

Capítulo 6


Para subir un audio haga clic en “Subir un Archivo”, navegue hasta ubicarlo,

selecciónelo y haga clic en “Enviar”.

Continúe al paso 2, asigne un nombre a su grabación y haga clic en “Guardar”.

Archivos WAV deben estar codificados en PCM, 16 bits y a 8000Hz.

Si desea grabar desde un teléfono ingrese el número de extensión y haga clic en “ir”

Marque *77 para grabar el mensaje (desde la extensión que ingresó)

Marque *99 para escuchar la grabación (desde la extensión que ingresó)

Una vez grabado el mensaje asignamos un nombre y hacemos clic en “Guardar”

IVR: Grabar o subir sonido

Ir a PBX → PBX Configuration → IVR – clic en Añadir IVR

Configurar las siguientes variables:

Cambiar nombre: Asignamos un nombre al IVR

Tiempo de espera: Tiempo de espera, en segundos, antes de ir al destino por

defecto.

Habilitar marcación directa: Permitir marcar directamente a extensiones

36

Capítulo 6


Anuncio: Seleccionamos un anuncio previamente grabado o cargado en el

sistema.

Se agregan los números de opción y sus destinos.

La opción t sirve para timeout

La opción i para opciones equivocadas

Una vez concluido hacemos clic en “Guardar “

La forma mas sencilla de hacer un IVR es con único Audio que al ser reproducido

indique todas las opciones.

Cuando tenemos varios Audios, tendremos que hacer un IVR para cada Audio.

Una vez que tenemos cada IVR creado, los relacionamos en orden colocando t

como la opción que enlazará el actual IVR al siguiente (siendo t la opción de

timeout)

Es necesario incluir todas las opciones de marcado disponibles en todos los IVRs

creados para no tener errores.

Salas de Conferencia Una sala de conferencia permite hablar a 3 o más personas simultáneamente

Se pueden hacer conferencias con extensiones locales y números remotos

Existen 2 tipos de salas de conferencias:

Permanentes y temporales

De ser necesario se pueden proteger con clave

Salas de conferencia: Temporales Se crean por un tiempo definido y desaparecen

Para crear se debe ingresar a PBX → Conference

Ejemplo de configuración:

37

Capítulo 6


Salas de conferencia: Estáticas Se crean para uso permanente

Ejemplo de Configuración: Ir a PBX → PBX Configuration → Conferencias

Número de conferencia: la extensión a la que marcaremos para acceder.

Nombre de la conferencia: Un nombre referencial

PIN de usuario: Clave para acceso a la conferencia (opcional)

PIN de administración: Necesaria únicamente si se selecciona la opción esperar al

administrador.

Opciones de la conferencia

38

Capítulo 6


Parqueo de llamadas Sirve para enviar las llamadas a un lugar temporal cuando el destino no es conocido.

Esto permite que sean recuperadas desde otra extensión.

La llamada es transferida desde una extensión inicial a un estacionamiento o parking

slot.

Después puede ser recuperada desde otra locación marcando un número asignado.

Para crear un estacionamiento ingrese a:

PBX → PBX Configuration → Estacionamiento

La extensión de marcado para enviar una llamada a aparcamiento es por defecto 70.

El tiempo de configuración para espera en el estacionamiento va de 15 segundos a 10

minutos.

El contexto de aparcamiento por defecto es: parkedcalls. Esto no debería ser

cambiado.

Al activar la opción de estacionamiento es necesario configurar el destino donde deben

ir las llamadas que no son recuperadas.

Ejemplo:

Durante la llamada marque ## 70 # - Usted escuchará un número de estacionamiento.

Usualmente 71, 72, 73,...n (un máximo de 20).

Luego usted puede recuperar la llamada que puso en el estacionamiento, desde otra

extensión ´marcando el número que escuchó en la grabación.

39

Capítulo 6


Música en espera Se puede subir música en formatos wav o mp3 al servidor

Se pueden crear listas de música para asignar en diferentes lugares de nuestra central.

Ej. Callcenter, colas, etc..

Para configurar se debe ingresar a PBX → Configuración → Música en Espera.

Es recomendable usar .wav estar codificado en PCM, 16 bits y a 8000Hz. Mp3 podría

consumir mas recursos.

Bookmark de menúes comunes Elastix 2.2 permite marcar menúes comunes para fácil.

Esta funcionalidad está localizada en la esquina derecha de cada sección con un icono

★ (estrella).

Para añadir un bookmark basta con hacer clic en ★ Iy la sección se mostrará en el

menú de la columna izquierda

40

Capítulo 6


Flash Operator Panel (1) Es una aplicación web hecha en flash que permite monitorizar la central

Cumple las funciones de un teléfono de recepcionista

Se pueden transferir llamadas, crear conferencias, etc.

La clave de administración es la que configuramos al instalar Elastix en la clave del

admin de la interfaz web.

Flash Operator Panel es un desarrollo de terceros. Elastix introdujo desde la versión

2.0 su propio panel de operador denominado: Elastix Operator Panel.

Pantalla del FOP:

41

Capítulo 7


CONFIGURACIÓN DE TELÉFONO IP

¿Qué es un teléfono IP? Un teléfono IP es un dispositivo que permite realizar una comunicación de voz utilizando

la red IP, ya sea mediante red de área local o a través de Internet.

La tecnología que hace esto posible esto se conoce como VoIP (Voz sobre IP).

El teléfono IP convierte y comprime la señal de la voz en paquetes de datos que serán

enviados en la red IP, en lugar de utilizar una conexión de red teléfonica.

Configuración de teléfono IP Para configurar un teléfono IP debemos tener en cuenta tres aspectos:

1. Configuración de red

2. Registro del dispositivo con el servidor Elastix

3. El Teléfono IP apropiado

Para ilustrar de mejor manera los puntos mencionados, utilizaremos un teléfono Yealink

SIP-T22P.

Configuración de red

La configuración de red puede realizarse por DHCP (lo más común) o se puede asignar

una dirección IP estática.

DHCP

Mediante esta opción, el teléfono obtendrá una dirección IP desde un setvidor DHCP

ubicado dentro de la red local.

Elastix puede ser nuestro servidor DHCP, si no se cuenta con uno en la red local.

42

Capítulo 7


IP estática

Esta opción es útil si deseamos contar contar con un registro exacto de las direcciones

IP de cada teléfono.

Es también útil si deseamos colocar los dispositivos IP en segmentos específicos de

nuestra red.

En esta opción, además de la IP se necesita ingresar la máscara de red y la puerta de

enlace en el caso de que su teléfono se encuentre en otro segmento de red.

La configuración de Teléfonos Yealink SIP-T22P o cualquier otro modelo de Yealink se

puede realizar ingresando a un web browser colocando la dirección IP del teléfono.

El usuario y contraseña por defecto en todos los modelos Yealink es: admin

Nota: también es posible configurar la extensión del teléfono desde el Endpoint Configurator de

Elastix (PBX → Endpoint Configurator) , esto lo veremos más adelante.

Para configurar la extensión debe ir a Cuenta.

El teléfono Yealink SIP-T22P puede ser configurado con 3 cuentas.

La información básica necesaria para la configuración es:

Línea Activa: Habilita la cuenta

Nombre de registro: Extensión de usuario

Nombre de usuario: Extensión de usuario

Contraseña: Secret - La contraseña de la extensión

Servidor SIP: Dirección IP del servidor Elastix

Servidor de salida Proxy: IP del servidor Elastix

Interfaz de administración web de Yealink

43

Capítulo 7


Aprovisionamiento El aprovisionamiento permite la configuración en lote de teléfonos IP.

Este proceso se realiza desde la interfaz web de Elastix y su principal herramienta es el

módulo de configuración de Endpoints (Endpoint Configurator).

El proceso adecuado es:

1. Creación de extensiones

2. Habilitar los teléfonos IP para el aprovisionamiento

3. Detección de los dispositivos en la red

4. Asignación de extensiones desde la interfaz.

Aprovisionamiento: Endpoint Configurator El Endpoint Configurator realiza un scan de la red del servidor Elastix.

En el scan se obtiene información de las direcciones IP y MAC de los dispositivos

conectados.

Al obtener la información de todos los dispositivos este trata de identificar los equipos

que pudieran ser teléfonos IP.

Luego trata de recabar información del fabricante y modelo para elegir cuáles se pueden

configurar.

Actualmente Elastix soporta las siguientes marcas:

Aastra, Atcom, AudioCodes, Cisco, Grandstream, Linksys, Polycom, Siemens, Snom,

Yealink y Zultys.

Se prevé soportar en versiones teléfonos Escene, Voptech y otros.

Cuando ya se tiene el grupo de teléfonos a configurar se presenta la información de los

mismos en la interfaz Web de Elastix.

Se mostrará algo similar a la siguiente imagen:

44

Capítulo 7


Para la mayoría de teléfonos, el Endpoint Configurator generará un archivo de

configuración que se graba en el directorio /tftboot del servidor Elastix.

Este archivo lleva el nombre mac_address_del_telefono.cfg (ej: 0015651ab08f.cfg).

En este archivo se guarda la configuración de los teléfonos para hacer el

aprovisionamiento via tftp desde Elastix

Aprovisionamiento: Habilitación de Teléfonos IP En la actualidad la mayoría de las marcas de teléfonos IP permiten configuración para

aprovisionamiento.

Hay algunas marcas (e.g. Atcom) en que aprovisionamiento no requiere de configuración

previa.

Para habilitar teléfonos Yealink, debemos configurar los siguientes parámetros desde la

interfaz administrtiva del teléfono:

Ir a: Actualizar → Advanzado

o Configurar URL: dirección IP del Servidor Elastix

o Check New Config: Encendido.

45

Capítulo 7


Aprovisionamiento: Asignación de extensiones 1. En la interfaz web de Elastix ir a PBX

2. Luego Endpoint Configurator

3. Hacer clic en: Descrubrir Endpoints en esta Network

4. En la columna “Configurar”, marcar la casilla correspondiente

5. En la columna “Modelo”, elegir el modelo correspondiente.

6. En la columna “Extension a asignar”, elegir la extensión que queremos asignar al teléfono.

(ya debe haber sido creada previamente)

7. Hacer clic en “Configurar”

Reiniciamos el teléfono (accedemos a su interfaz web haciendo clic en la IP

correspondiente). Una vez dentro: Upgrade → Basic → Reboot).

Nota: Algunos modelos se reinician automáticamente.

¿Qué es un Softphone? Es un software que hace una simulación de teléfono IP por computadora.

Es decir, permite usar la computadora para hacer llamadas a otros softphones, teléfonos

IP o a otros teléfonos convencionales analógicos.

46

Capítulo 7


Configurando un Softphone Presionamos el botón con la figura de la herramienta y accedemos al menú de opciones.

Allí veremos una pantalla con opciones para configurar nuevas extensiones SIP y también

IAX. Zoiper cuenta con soporte para ambos protocolos.

En nuestro ejemplo configuraremos una extensión SIP. Usuario: 5678 Contraseña: 5678.

X-Lite Counterpath Zoiper Softphone

47

Capítulo 7


La información requerida es:

o Domain: La IP o nombre de dominio del servidor Elastix.

o Username: 5678

o Password: 5678

o Caller ID Name: El nombre que aparecerá en los teléfonos que reciban

nuestras llamadas.

Después de llenar la información hacemos clic en OK.

Una vez que volvemos a la pantalla de inicio de Zoiper hacemos clic en register.

Si el Zoiper se registra correctamente veremos que junto al nombre de nuestra cuenta

“Test” aparecerá la palabra “Registered”.

48

Capítulo 8


CONFIGURACIÓN DE HARDWARE

Tipos de tarjetería Esta tarjetería está disponible tanto para interfaces telefónicas analógicas como digitales.

Dentro de cada una de estas categorías existen las siguientes sub-categorías:

EHCP : Elastix Hardware Certification Program El Equipo de Desarrollo Elastix trabaja con varios fabricantes para incluir los

controladores de su hardware.

Además Elastix cuenta con un programa que pone a prueba toda la funcionalidad para

certificar la interoperabilidad con el software.

Este programa es conocido como Elastix Hardware Certification Program o EHCP por

sus siglas en inglés.

Hay muchos modelos y fabricantes de tarjetas compatibles e incluidos en la distro.

Fabricantes soportados Elastix ha probado el soporte para muchos modelos y fabricantes de tarjetería. Los

siguientes son los modelos soportados oficialmente a la fecha:

Analog:FXOFXS

Digital:E1/T1/J1BRI

49

Capítulo 8


Hardware modular Existen fabricantes que diseñan su hardware de manera modular, de tal forma que pueda

ser expandible.

Instalando una tarjeta de telefonía Esto no involucra ninguna tarea complicada, solo las precauciones obvias al instalar

tarjetas electrónicas en un computador.

Luego de encender el equipo podemos ir a consola y ejecutar el comando lspci para ver

el hardware enlistado.

Nota: En caso de instalar hardware FXS es muy común que se requiera conectar un cable de poder a la tarjeta pues hay que recordar que las interfaces FXS deben proveer potencia eléctrica a los dispositivos que se conecten a ella.

Detección de hardware Una vez que la tarjetería ha sido instalada es hora de detectarla.

En versiones muy antiguas de Elastix esta tarea se hacía manualmente ejecutando un

comando desde la consola del equipo.

Puertos

ranuras para módulos

Módulo FXS(verde)

Módulo FXO(rojo)

ConexiónFuente de alimentación

Sangoma TMD Card Model A20101

50

Capítulo 8


Actualmente se cuenta con una interfaz Web que detecta el hardware automáticamente

y nos muestra gráficamente el hardware detectado.

Esta opción podrá encontrarse en el Menú System → Hardware Detector.

Para detectar una tarjeta hacemos clic en “Avanzado” y seleccionamos la opción

Reemplazar el archivo chan_dahdi.conf.

Después debemos dar clic en Detect New Hardware y después de algunos segundos, el

proceso estará finalizado.

Tarjetas Digitales

Para este modelo hemos seleccionado una tarjeta Sangoma modelo A102. Este hardware

utiliza Wanpipe el cual usa sus propios drivers para comunicarse con Asterisk.

Para detectar la tarjeta debemos dar clic en “Avanzado” y seleccionar: Reemplazar el

archivo chan_dahdi.conf y Detección de Hardware Sangoma.

Después de esto podemos dar clic en Detectar Nuevo Hardware.

Para la detección de tarjetas que usan Dahdi simplemente se debe seleccionar la opción

“Reemplazar el archivo chan_dahdi.conf” y después clic en “Detectar Nuevo Hardware”.

Es importante verificar que la tarjeta esta dentro de la lista de hardware certificado de

Elastix, ECHP.

El reemplazo de chan_dahdi.conf permite al sistema detectar la tarjeta de forma

permanente.

51

Capítulo 8


Este acción sobre escribe los siguientes archivos:

/etc/asterisk/chan_dahdi.conf

/etc/dahdi/system.conf

/asterisk/dahdi-channels.conf

Si ya se tiene una tarjeta instalada y deseamos detectar una nueva tarjeta, es

recomendable realizar un respaldo de estos archivos para permitir incluir estas

configuraciones previas en los nuevos archivos.

Configuración Span La herramienta de detección de hardware basada en Web que viene con Elastix nos

permite detectar el hardware de manera sencilla.

La herramienta puede configurar exitosamente el hardware digital en muchos casos, sin

embargo hay que tener en cuenta que la herramienta realiza su trabajo suponiendo

muchos parámetros que pueden diferir de la realidad.

Se puede cambiar estos parámetros usando la interfaz web o mediante consola. A

continuación explicaremos como realizar estas configuraciones por consola.

Configuración Span: Bajo Nivel Un span es un grupo de canales digitales.

El span se puede configurar en el archivo /etc/dadhi/system.conf.

Usualmente un span representa un puerto digital de la tarjeta.

Por ejemplo, si la tarjeta contiene 4 puertos E1 entonces usualmente deberíamos definir

4 spans, uno por cada puerto.

Un span define en una sola línea, la cual tiene el siguiente formato:

Spannum

Es un identificador numérico único para etiquetar el span. Se debe empezar con el

número 1 e ir incrementando este identificador secuencialmente de uno en uno.

Timing

Es un dígito que define la forma en la cual se manejará la sincronización del span.

52

Capítulo 8


LBO (Line Build Out)

Es un dígito que representa la longitud del cable entre la tarjeta y el equipo (modem)

provisto por la compañía telefónica.

Framing

Como recordaremos, los protocolos de comunicación digital T-Carrier y E-Carrier

dividen la información en frames, donde cada frame transporta un número determinado

de timeslots.

Estos frames pueden ser de diferentes formatos y eso es lo que se define aquí.

Coding

Es necesario codificar la información enviada para hacerla menos susceptible a errores.

Esto es así porque la propia data se suele usar como fuente de sincronización (o reloj).

Si se transmiten tramas largas de ceros (largos segmentos sin variación de voltaje) se

puede perder dicha sincronización.

Después de realizar los cambios en el archivo system.conf, es necesario reiniciar DAHDI.

(Asterisk CLI: service dahdi restart)

Después de haber reiniciado DAHDI se ejecuta el comando “lsdahdi”.

Si todo ha sido configurado de forma correcta, se podrá ver las tarjetas configuradas y el

respectivo estado de canal.

53

Capítulo 8


Configuración Span: Interfaz Web En la interfaz web tenemos las siguientes opciones: Configuración de Span y Parámetros

de Span.

En Parámetros de Span podremos configurar el timing source, LBO, Framing y Coding.

También podemos seleccionar el tipo de tarjeta T1/E1 (para tarjetas que soporten modo

de selección por software).

En la Configuración de Span podemos seleccionar por cada canal el software de

cancelación de eco.

Tarjeta detectada con formato TI

Cambio de formato a E1

Troncalización: chan_dahdi.conf Asterisk cuenta con un módulo llamado chan_dahdi que sirve para conectarse con los

drivers de DAHDI y de esta manera conectar Asterisk con hardware telefónico.

Este módulo se configura a través de un archivo llamado chan_dahdi.conf

En el archivo chan_dahdi.conf básicamente se configura la señalización de los canales de

voz y se mapean los canales de Asterisk con los circuitos o líneas telefónicas definidos en

el archivo system.conf que configuramos antes.

Estos canales se pueden agrupar en troncales troncales.

54

Capítulo 8


La siguiente imagen muestra el archivo chan_dahdi.conf:

Signalling

Este parámetro define la señalización de cada canal o grupo de canales.

Lo más común que veremos para circuitos analógicos será fxs_ls y para circuitos digitales

pri_cpe.

Switchtype

Este parámetro es para circuitos digitales y especifica el tipo de switch PRI usado.

Lo más común es national y euroisdn, dependiendo de en qué país nos encontremos

claro está.

55

Capítulo 9


ASTERISK ESSENTIALS

¿Qué es Asterisk? Es un sistema de telefonía basado en software libre que proporciona todas las

funcionalidades que se espera de una central telefónica (PBX).

Esto hace posible conectar un número determinado de teléfonos para hacer llamadas

entre sí y conectar a un proveedor de VoIP PSTN.

Asi tambien proveedores PSTN de telefonia digital y analoga usando hardware

especializado, esto es tarjetas telefonicas FXO/FXS, ISDN pri/bri, entre otras.

Breve Historia de Asterisk Asterisk fue creado por Mark Spencer quien es su principal desarrollador.

Al ser Software libre, tiene tambien una amplia comunidad de desarrolladores que

contribuyen a corregir errores y añadir novedades y funcionalidades.

Mark había creado en 1999 la empresa "Linux Support Services" con el objetivo de dar

soporte a usuarios de Linux.

Para ello necesitaba una centralita telefónica, pero ante la imposibilidad de adquirirla

dados sus elevados precios, decidió construir una con un PC bajo GNU/Linux, utilizando

lenguaje C.

Funcionalidad de Asterisk Asterisk puede funcionar como un sistema IP nativo o uno hibrido, manejando el ruteo

de llamadas, interconectando protocolos y transcodificando medios.

Tiene muchas características internas como buzón de voz, conferencias, IVRs, CDRs,

distribución automática de llamadas, parqueo, tranferencias, captura, musica en espera

Entre muchas otras funcionalidades.

Asterisk tambien soporta multiples protocolos y codecs.

56

Capítulo 9


Asterisk soporta diferentes señalizaciones y protocolos para la interconexion con

sistemas de telefonia tradicionales.

Encendido y apagado de Asterisk Asterisk cuenta con scripts ubicados en /etc/rc.d/init.d/asterisk y pordemos iniciarlo con

el comando /etc/init.d/asterisk start y detenerlo con /etc/init.d/asterisk stop.

Sin embargo en elastix es recomendable manejar su inicio o apagado con el script

amportal, mismo que a su vez llama a otros scripts que inician ademas otros servicios

necesarios para ciertas funcionalidades

Su uso es:

o amportal start → inicia asterisk

o amportal stop → detiene asterisk

PROTOCOLOS CODECSIAXTM (Inter-Asterisk Exchange) ADPCMH.323 G.711A/U (A-Law y µ-Law)SIP (Session Initiation Protocol) G.722MGCP (Media Gateway Control Protocol) G.723.1SCCP (Cisco® Skynny®) G.726

G.729 (con una licencia comercial)GSMiLBCLinearLPC-10Speex

Señalización Protocolos PRIE&M 4ESSE&M Wink BRI (ISDN4Linux)Feature Group D DMS100FXS EuroISDNFXO Lucent 5EGR-303 National ISDN2Loopstart NFASGroundstartKewlstartSoporte para MF y DTMFSeñalización Robbed-bit (RBS)MFC-R2 (a través de parches de código)

57

Capítulo 9


Estructura de directorios de Asterisk

Módulos de Asterisk Asterisk utiliza módulos para extender su funcionalidad.

Estos módulos residen en la carpeta /usr/lib/asterisk/modules/ (32 bits)

/usr/lib64/asterisk/modules/ (64 bits).

Son archivos con extensión .so

Es posible controlar estos módulos desde el archivo modules.conf, en la carpeta

/etc/asterisk.

Este archivo controla cuáles módulos se cargan o no (load, noload). Además puede

controlar el orden en que se cargan con la opción ”preload”.

Por defecto en elastix se cargan todos los módulos que están en

/usr/lib/asterisk/modules/ a no ser que sea especificado en el archivo modules.conf que

no lo haga

Ejemplos en el archivo modules.conf:

noload => chan_modem.so : Hace que no se carge el módulo.

load => format_ogg_vorbis.so : Hace que se carge el módulo.

preload => res_config_mysql.so : Hace que se carge primero ese módulo

Directorio Descripción/etc/asterisk archivos de configuración de Asterisk/usr/lib/asterisk/modules/ módulos de Asterisk/usr/sbin/ incluye el Binario de Asterisk/var/log/asterisk/ logs de Asterisk/var/lib/asterisk/agi-bin/ AGI scripts/var/lib/asterisk/mohmp3 archivos d audio para Music On Hold

/var/lib/asterisk/soundsIncluye sonidos que Asterisk utiliza como prompts de voz

/var/spool/asterisk/archivos generados por Asterisk durante su operación normal (tales como grabaciones y voicemails)

/var/run/ archivos PID

/var/log/asterisk/Aquí residen los archivos de log de Asterisk como los CDRs o el /var/log/asterisk/full

58

Capítulo 9


DAHDI Dahdi es, básicamente, un conjunto de drivers para controlar hardware telefónico,

principalmente tarjetas.

Estas tarjetas son como cualquier otra tarjeta de expansión de una computadora pueden

usar bahías PCI, puertos USB, etc.

Dahdi tiene su propio archivo de configuración /etc/dahdi/system.conf

Historia del proyecto Zaptel En el año 2000 Jim Dixon lanzó el proyecto Zaptel bajo licencia GPL.

El nombre es una abreviación de Zapata Telephony Project. Lo nombró así en honor a

Emiliano Zapata, héroe de la revolución mexicana.

Inicialmente Zaptel contenía drivers para tarjetas Tormenta fabricadas por Zapata

Telecom.

Digium comenzó a mejorar los drivers y extender el soporte para nuevos modelos de

hardware, entre ellos los que el mismo Digium fabricaba.

Pronto Digium se convirtió en el principal desarrollador de Zaptel.

Comunicación Asterisk con DAHDI Asterisk interactúa con dahdi mediante el modulo chan_dahdi.so, mismo que se controla

a través del archivo chan_dahdi.conf.

En este archivo se mapean los puertos fisicos hacia canales tipo DAHDI, estos canales

son usados por asterisk.

59

Capítulo 9


Archivos de configuración Los archivos se encuentran en /etc/asterisk

Plan de marcado (dialplan) El plan de marcado se configura en el archivo extensions.conf, existen otros archivos que

contienen porciones del plan de marcado:

o extensions_additional.conf: el plan de marcado variable escrito por FreePBX,

los cambios realizados manualmente se pierden cunado FreePBX sobreescribe

este archivo.

o extensions_custom.conf: el plan de marcado definido por el usuario, no se

pierden los cambios que se realizan manualmente.

Todos los archivos son de texto plano en formato definido por Asterisk.

Se dividen en secciones llamadas contextos.

Dialplan: Contextos Agrupan la lógica del plan de marcado.

Pueden incluir otros contextos con la claúsula ”include”.

El plan de marcado se agrupa en contextos.

Se definen como agrupadores u organizadores del plan de marcado.

Deben tener un nombre único que va entre los símbolos [ ].

Existen dos contextos reservados [globals] y [general].

extensions.conf

sip.confiax.confchan_dahdi.conf

Reside el plan de marcado, losarchivos adicionales empiezan conextensions_.

Se definen los endpoints SIP.

Se definen los endpoints IAX.

Archivo de configuración paracanales DAHDI, se troncalizan loscanales.

60

Capítulo 9


Dialplan: Extensiones Son líneas del plan de marcado.

Son instrucciones llamadas extensiones.

Tienen la siguiente sintaxis:

o exten => nombre_extensión, prioridad, aplicación

Una línea del plan de marcado es una serie de lógica del plan de marcado.

Se puede crear la lógica necesaria para un marcado específico.

Dialplan: Extensiones (Nombre_extensión) Es un identificador númerico de la extensión.

Se lo puede asociar al número de teléfono.

Existe una extensión particular ”s”.

La extensión ”s” significa cualquier extensión.

Esta extensión ”s” se usa cuando el usuario que llama no ha presionado el número de

extensión. Por ejemplo, cuando está en el IVR de bienvenida.

Dialplan: Instrucciones (Prioridad) Indica el orden de ejecución de una instrucción.

La primera prioridad debe ser siempre 1 porque Asterisk busca esta prioridad cuando

lee un contexto para ejecutarlo.

Existe una prioridad especiales n.

La prioridad n indica que a la prioridad de la instrucción anterior se le debe sumar uno.

Sirve para facilitar la estructura del plan de marcado.

Dialplan: Instrucciones (Aplicaciones) Las aplicaciones de un plan de marcado equivalen a las funciones de un lenguaje de

programación.

Permiten realizar acciones programadas en el plan de marcado.

Las aplicaciones permiten realizar ejecuciones entre contextos.

Pueden recibir parámetros para su ejecución.

61

Capítulo 9


Dialplan: Variables Las variables en el plan de marcado equivalen a las variables de un lenguaje de

programación.

Son abstracciones que almacenan información de naturaleza variable.

Tiene la siguiente sintaxis:

${NNNN}

donde NNNN es el nombre de la variable.

Pueden ser de tres tipos:

Globales: Se definen en la sección [globals] del archivo extensions.conf o en

globals_custom.conf dentro de cualquier Elastix, pueden ser referenciadas desde

cualquier lugar del plan de marcado.

De canal: Pueden ser definidas usando el comando (o aplicación) ”Set”.

Predefinidas: Asterisk administra algunos nombres de variables con nombres

predefinidos

${CALLERID(all)}, ${CALLERID(name)}, ${CALLERID(num)},

${CHANNEL}, ${CONTEXT}, ${EPOCH}, ${EXTEN},

${SIPUSERAGENT}, ${UNIQUEID},

Estas variables almacenan cierta información dependiendo del comportamiento de la

llamada u otros factores.

Aplicaciones Answer

o Sintaxis: Answer ([delay])

o Contesta un canal si éste está timbrando, recibe el parámetro delay que indica el

tiempo en milisegundos antes de contestar.

Background

o Sintaxis: Background(filename1[&filename2...][|opciones[|langoverride][|context]])

o Reproduce un listado de archivos mientras Asterisk continúa ejecutando el plan

de marcado.

o Aplicación usada para reproducir el mensaje de IVR.

Playback

o Sintaxis: Playback(filename1[&filename2...][,options])

62

Capítulo 9


o Reproduce archivos de audio, a diferencia de Background, no permite a Asterisk

tener el control mientras no acabe de reproducir los archivos.

Hangup

o Sintaxis: Hangup()

o Cuelga el canal y retorna -1.

Goto

o Sintaxis: Goto([[context|]extension|]priority)

o Salta la ejecución del plan de marcado a un contexto, extensión o prioridad

indicada. Si se pasa un solo parámetro se entiende que es una prioridad del

mismo contexto.

Dial

o Sintaxis: Dial(type/identifier, timeout, options, URL)

o Marca un canal especificado y lo vincula con el canal corriente.

Asterisk CLI Es el nombre de la consola de Asterisk.

Línea de comandos para controlar Asterisk directamente.

Para ingresar a la consola se ejecuta el comando ”asterisk -r”

Cuando se obtiene un prompt CLI>, se pueden ejecutar comandos de Asterisk

Provee información en tiempo real de la actividad de Asterisk.

Permite controlar el grado de detalle de la información, para ello se usan los comandos:

o Core set debug N

o Core set verbose N

Mientras más alto sea el nivel de las variables debug N y verbose N más detallada será la

información mostrada.

Estos comandos se deben utilizar para tareas de diagnóstico.

63

Capítulo 10


PLAN DE MARCADO AVANZADO

Manipulación de Variables Sintaxis para eliminar dígitos

${VAR:x:y} Donde VAR es una variable numérica, ”x” es el número de dígitos a

eliminar al principio y ”y” es cuantos números tendrá la variable final

Ejemplo VAR=1234567890, x=3, y=4 – ${VAR:3:4} → 4567

${VAR:x} Donde VAR es una variable numérica, ”x” es el número de dígitos a eliminar

al principio

Ejemplo VAR=1234567890, x=3 – ${VAR:3} → 4567890

Concatenar variables

exten =>s,n,Set(VAR_CONCAT=${var1}${var2}${VAR3})

Expresiones

$[expresion]

ej. $[ ${VAR1} + ${VAR2} ]

Sintaxis Condicional

expresión?destino1:destino2

Macros Sirven para reutilizar códigos

Se definen como contextos anteponiendo el prefijo macro-

Ej. [macro-nombremacro]

Puede recibir parámetros cuando se llama al macro

El macro es llamado de la siguiente forma:

Macro(nombremacro,parametro1,parametro2,....)

Los parámetros son invocados como:

${ARG1}, ${ARG2}, ....

64

Capítulo 10


Variables disponibles en Macros A más de las definidas por el usuario ${ARGn} se pueden usar las siguientes variables

AstDB Pequeña base de datos accesible desde el plan de marcado

Agrupa información por familias.

Familias importantes: AMPUSER y DEVICE

Aplicaciones importantes:

Plan de Marcado de FreePBX Reside principalmente en extensions.conf que incluye a:

extensions_additional.conf: Archivo generado por FreePBX que nunca se debe

modificar pues todos los cambios serán sobre escritos cuando FreePBX recargue su

configuración

extensions_custom.conf: archivo que se puede editar para crear nuestros

contextos y que éstos no sean sobre escritos por FreePPX

65

Capítulo 10


Macros de Apoyo

Contextos de Entrada Son los contextos desde donde se reciben llamadas

Conocimientos Útiles Determinar si una variable esta vacía

ej. exten => s,1,GotoIf($[${LEN(${VARIABLE_TEST})} > 0]?destino)

Obtener la fecha actual

ej. exten => s,4,AGI(recordingcheck,${STRFTIME(${EPOCH},,%Y %m%d-

%H%M%S)},${UNIQUEID})

Sobrescribir extensión.conf.- Para sobreescribir un contexto definido se puede utilizar

el archivo: extensions_override_freepbx.conf

66

Capítulo 11


ASTERISK: AGI & AMI

AGI (Asterisk Gateway Interface) Es una manera de interactuar con Asterisk desde un programa de línea de comandos

Este programa puede ser escrito en cualquier lenguaje

El programa AGI es invocado desde el dialplan

La salida estándar debe tener cierto formato. Es lo que se llaman comandos AGI

Gracias a AGI podemos desarrollar funcionalidades extra en nuestro plan de marcado

como: IVRs de consulta a base de datos, etc.

Los programas AGI residen en /var/lib/asterisk/agi-bin/

Elastix trae algunos scripts allí preinstalados

Ejecución de scripts AGI Los scripts AGI se comunican con Asterisk a través de STDIN, STDOUT y STDERR

Por tanto, los scripts AGI se deberían poder ejecutar desde la línea de comandos

Cuando son ejecutados a través de Asterisk los permisos son muy importantes.

Para invocar al script desde el dialplan podemos utilizar la función AGI()

Se le pueden enviar parámetros al script utilizando la sintaxis:

AGI(script.agi,par1,par2,...)

Adicionalmente Asterisk le envía al script ciertos parámetros por omisión, que

veremos a continuación

67

Capítulo 11


Algunos parámetros enviados por omisión

A continuación algunos de los más importantes:

agi_request – El nombre del archivo script

agi_channel – El canal que originó la llamada

agi_type – El tipo de canal. Por ej. SIP o DAHDI

agi_uniqueid – Un identificador único para la llamada

agi_callerid – El caller ID en caso de estar disponible

agi_context - Contexto

agi_extension - Extensión

agi_accountcode – Código de cuenta, en caso de estar disponible

Algunos comandos AGI útiles say digits: Sintetiza y reproduce números. Util para IVRs que recuperan data de la DB

hangup: Cuelga el canal (llamada) actual

stream file: Reproduce un archivo de audio

set context: Establece un contexto para continuar luego de la finalización del AGI

noop: Sólo muestra mensajes en el log

set variable: Establece una variable de canal

Ejemplo AGI sencillo Veamos lo sencillo que es usando un ejemplo escrito en PHP. Llamaremos al script

simple.agi

Ahora pongámoslo accesible desde el dialplan cuando se marque el número 6789

68

Capítulo 11


AMI (Asterisk Management Interface)

Es otra manera de controlar Asterisk pero a través de la red IP. La comunicación es de

tipo texto.

Se pueden desarrollar aplicaciones remotas

Un ejemplo es el módulo de call center de Elastix, otro ejemplo es el FOP

El puerto AMI por omisión es el 5038

No cualquier equipo puede interactuar con el puerto AMI. Previamente su IP tiene que

ser habilitada en el archivo /etc/asterisk/manager.conf

/etc/asterisk/manager.conf

Probando desde telnet Una manera sencilla de probar si nos podemos conectar al puerto AMI

En el siguiente ejemplo nos conectaremos desde el propio servidor. Lo primero que

veremos es el mensaje de bienvenida:

69

Capítulo 11


Luego probaremos autenticándonos:

Si los datos estuvieron correctos recibiremos un mensaje de éxito

¿Recuerdan cual es la contraseña de AMI?

Tipos de paquetes AMI En la comunicación por AMI se pueden identificar tres tipos de paquetes de

información.

Acción: Un comando enviado por el cliente al servicio AMI para que sea procesado

Respuesta: La respuesta de Asterisk a la Acción requerida por la aplicación cliente

Evento: Se trata de información de un evento asincrónico ocurrido en Asterisk. Por

ejemplo, ingresó una llamada telefónica

Para relacionar las respuestas con las acciones se puede incluir un ActionID en cada

Acción. Asterisk devolverá este parámetro en la respuesta.

Acciones AMI comunes Login: Nos permite autenticarnos con AMI

Logoff: Termina la sesión

Events: Controla el flujo de eventos

Originate: Inicia una llamada telefónica

Redirect: Transfiere una llamada

Hangup: Cuelga una llamada

Getvar: Obtiene una determinada variable de canal

70

Capítulo 12


ELASTIX CONFIGURACIÓN AVANZADA

Ruteo de Llamadas Rutas Entrantes:

Esta opción permite configurar el destino de las llamadas que ingresan por una

determinada troncal.

Cuando una llamada entra, Asterisk puede buscar “matchear” el DID ó el CallerID de

la troncal.

71

Capítulo 12


Rutas Salientes:

Mediante las rutas salientes podemos indicar por qué troncal o troncales deben ser

enviadas las llamadas.

Troncales Una troncal es el camino lógico que permite llevar una llamada a cualquier destino

externo.

Alguno de los tipos de troncales son:

DAHDI

IAX2

SIP

Custom

Troncal DAHDI Parámetros a configurar en una troncal DAHDI:

72

Capítulo 12


Troncales de tipo IAX2 y SIP Además de las configuraciones especificadas, se deben incluir configuraciones entrantes

y salientes

Esta información generalmente es especificada por el proveedor de servicios de voz.

Las configuraciones pueden incluir username, password, codec, el host destino, etc.

Ejemplo de configuración de los detalles del Peer:

Nota: Es posible que se requiera una cadena de registro que tiene la siguiente sintaxis:

nombre_de_usuario:password@host

Troncales Personalizadas Estas troncales son creadas cuando se usan protocolos no estándares como

h323,misdn, etc.

Se debe especificar un string de marcado. Por ejemplo:

73

Capítulo 12


Tarifación La opción Rates/Tarifas (Reports → Billing → Rates) nos permite visualizar y

configurar las tarifas que se usarán para la facturación de llamadas.

Crear Tarifa

Para agregar una nueva tarifa dar clic en el botón Crear Nueva Tarifa. Se mostrará un

formulario en el que se ingresarán los siguientes campos:

Prefijo: Prefijo telefónico al cual se aplicará la tarifa.

Nombre: Nombre para la tarifa.

Tarifa: Valor de la tarifa por minuto.

Rate offset: Valor de interconexión.

Dígitos Ocultos: oculta los últimos "n" dígitos del número en el reporte.

Troncal: Troncal asignada para la tarifa.

74

Capítulo 12


Para tener disponible una troncal debemos habilitarla en Billing Setup (Reports →

Billing → Billing Setup).

En este menú podemos configurar además la tarifa por defecto y el rate offset por

defecto.

Visualizar, Editar y Eliminar

El enlace Ver nos llevará a una pantalla donde se mostrará los datos de la tarifa.

Podemos editar los valores de la tarifa haciendo clic en el botón “Editar”, o eliminarla

haciendo clic en “Eliminar”

Reporte de Facturación

Este reporte (Reports → Billing → Billing report) nos permite ver todos los detalles de

las llamadas y su respectivo costo y ruta aplicada.

Este reporte cambiará dependiendo de 3 valores de filtro:

Fecha Inicio: Fecha que queremos configurar como inicial para el reporte.

Fecha Fin: Fecha final para el reporte.

Campos de filtro adicional son: Tarifa aplicada, Duración, Rate value, Fuente,

Destino, Canal destino, Account Code.

75

Capítulo 12


Distribución de Destinos

Esta opción (Reports → Billing → Destination distribution) nos permite ver una gráfico

de distribución de llamadas salientes agrupadas por tarifa.

El gráfico cambiará dependiendo de los valores de filtro:

Fecha Inicio: Fecha que queremos iniciar la revisión de llamadas.

Fecha Fin: Fecha final para la revisión.

Criterios de distribución: Distribución por tiempo, distribución por número de

llamadas, distribución por costo.

Reportes: CDR CDR es la abreviación para Registro de Detalle de Llamada (Reports → CDR Reports).

Este reporte nos permite ver un listado con el detalle de todas las llamadas.

76

Capítulo 12


Los reportes son exportables a CSV, XLS (para acceso lectura/escritura), o PDF

(lectura-únicamente) formatos.

Este reporte cambiará dependiendo de los siguientes valores de filtro:

Fecha Inicio: Fecha que queremos iniciar la revisión de llamadas.

Fecha Fin: Fecha final para la revisión.

Grupo de timbrado: permite filtrar por grupo de ringado si existe.

Estado: Contestado, Ocupado, Fallido, No Contestado.

Campo de filtros adicionales: Fuente, Canal de Origen, Account code, Canal de

Destino.

Uso de canales El reporte de uso de canales: “Channels Usage” report (Reports → Channels Usage)

permite ver de manera gráfica el número de llamadas simultáneas por canal.

77

Capítulo 12


Configuración DISA DISA permite que los usuarios puedan acceder telefónicamente a su servidor Elastix

desde fuera y obtener un tono "interno" de marcado.

E.g. podría realizar llamadas internacionales, a teléfonos móviles, entre otros.

Nombre de DISA: El nombre referencial para este accedo DISA

PIN: La contraseña necesaria para acceder al soporte DISA.

Tiempo de espera para la respuesta: Máximo tiempo que la aplicación esperará al

usuario por el PIN.

Tiempo de espera de marcado: Máximo tiempo entre dígitos.

Pedir confirmación: Pregunta por una confirmación antes del pedido de la contraseña.

Identificador de llamante: Todas las llamadas DISA usarán este Caller ID (opcional)

Contexto: Contexto que usará el DISA

Permitir colgar: Permite colgar la llamada presionando "**" para tener tono

nuevamente.

Condiciones de tiempo El uso de condiciones de tiempo es una característica muy útil para modificar el

comportamiento de la PBX dependiendo de la hora o del día de la semana.

EJEMPLOS:

78

Capítulo 12


La compañía X desea que por las noches se reproduzca un mensaje indicando el

horario de atención e indicando que en casos de urgencias se podrían comunicar con

un número alterno.

La compañía Z desea reproducir un IVR de bienvenida distinto al habitual durante los

fines de semana ya que siempre lanza promociones durante estos días.

79

Capítulo 13


INTERCONEXIÓN CON ELASTIX REMOTOS

A través de troncales SIP Una de las ventajas de usar Elastix es que fácilmente podemos interconectar dos cajas

Elastix de tal manera que se puedan unir las comunicaciones de dos lugares remotos.

Por ejemplo en un solo plan de marcado.

A continuación veremos como configurar la interconexión de dos Elastix mediante una

troncal de tipo SIP.

Escenario:

En el escenario mostrado a continuación queremos interconectar la central A con la

central B de tal forma que el teléfono A y el teléfono B se puedan comunicar

únicamente marcando las extensiones de forma directa

Para implementar esto se requiere definir dos cosas:

La troncal

Las rutas salientes en cada Elastix

Definiendo la troncal

Definimos el nombre de la troncal, el cual en nuestro caso servirá de username para el

proceso de registro.

A la troncal del servidor A la llamaremos elastixA y la troncal del servidor B la

llamaremos elastixB.

Luego definimos los detalles del peer.

80

Capítulo 13


Ejemplo de configuración del peer:

Configuración que se repite en ambos servidores Elastix. Como se ve hemos definido

como “secret” la palabra welcome.

Register String

Definimos el register string siguiendo el formato especificado anteriormente:

En este caso para la central Elastix A debería ser:

y para la central Elastix B debería ser:

Una vez establecida esta configuración en ambos servidores podemos verificar en si se

encuentran registradas las troncales.

En el Asterisk CLI mediante el comando: sip show registry y deberíamos ver algo como

esto:

El siguiente paso es definir los detalles del user, es decir en donde se quiere terminar la

llamada.

En este caso queremos que sea accesible a la extensiones local, bastará con colocar el

contexto primario. Esto indica que cuando la llamada entre por la troncal iniciará en el

contexto aquí especificado.

La configuración es como sigue:

81

Capítulo 13


Definiendo la ruta saliente

Primero determinamos el nombre de la ruta salientes. En este caso le pondremos:

HaciaElastixB.

Luego definimos el patrón de marcado, en este caso usaremos el siguiente patrón de

marcado: 2|XXX (asumimos que para marcar al servidor B debemos marcar el prefijo

2).

En tercer lugar escogemos por qué troncal deberá enrutarse la llamada, en este caso

escogemos por la troncal sip/elastixA

Conexión con proveedores VoIP

Hoy en día ha tenido mucho auge los VSP (Voice Services Provider) ó proveedores de

servicios de voz.

Estos proveen conexiones SIP o IAX principalmente, a su infraestructura para permitir

conectar llamadas locales en una región.

En esta sección implementaremos una conexión SIP con un proveedor VSP que nos

permitirá hacer llamadas dentro de Estados Unidos.

Escenario:

En el siguiente escenario queremos registrar una troncal de tipo SIP con un VSP que

nos permita realizar llamadas a EEUU desde cualquier teléfono IP.

Para implementar esto se requiere definir dos cosas:

La troncal

Las rutas salientes en cada Elastix

82

Capítulo 13


Definiendo la troncal

Como vimos en la sección anterior se debe definir el nombre de la troncal en este

caso la llamaremos: VP-SIP

Luego definimos las características del peer.

Esta información debe ser proporcionada por el VSP y generalmente es la misma para

todos los usuarios a registrar, lo único que cambia es el usuario y el password.

En nuestro caso el VSP nos pide que configuremos la troncal de la siguiente forma:

Luego agregaremos la cadena de registro que en nuestro caso sería:

Primero determinamos el nombre de la ruta salientes. En este caso le pondremos:

INTERNACIONAL

Luego definimos el patrón de marcado, en este caso usaremos el siguiente patrón de

marcado: 00.

En tercer lugar escogemos por que troncal debe irse la llamada en este caso

escogemos por la troncal SIP/VP-SIP

Una vez realizada la configuración podemos verificar en el Asterisk CLI si se la troncal

se encuentra registrada.

Usamos el comando: sip show registry y deberíamos ver algo como esto:

83

Capítulo 13


Módulo VoIP Provider

Desde la versión 2.0 Elastix tiene un módulo con proveedores incluidos por defecto.

El módulo permite configurar cuentas VoIP de manera automática.

Si el proveedor no está enlistado usted puede escoger “Custom” como opción para

mostrar el cuadro de “PEER Settings”.

La opción “Custom” es además una alternativa al proceso de crear una conexión con

un proveedor SIP.

Usted puede seguir el procedimiento descrito en la sección anterior o crear una

cuenta a través del módulo VoIP Provider.

Si usted tiene ya una cuenta con alguno de los proveedores incluidos, solo necesita

ingresar la información y la cuenta se creará.

Usted puede revisar el registro en el Asterisk CLI

84

Capítulo 13


Posterior a esto revisamos la troncal en PBX → PBX Configuration → Troncales.

Observaremos la cuenta como un SIP Trunk, en este ejemplo: N2P-DRB (sip).

Luego es necesario crear la ruta saliente para esta troncal y podemos empezar a usar

el servicio.

85

Capítulo 14


CALIDAD DE VOZ

Síntomas que afectan la calidad de voz

Son los problemas que el usuario percibe desde su perspectiva

Existen muchos, sin embargo los más comunes son:

Eco

Bajo volumen

Retardo

Distorsión de la voz

Comunicación entrecortada

Síntomas: Eco

La señal de ida se refleja en la de vuelta

Fácil de identificar por un humano

Una causa común es un desbalance en el híbrido

También hay eco acústico. Ej. El producido por speaker

Algunas tarjetas permiten ajustar este desbalance. La utilería fxotune puede ser usada

con este fin

El famoso híbrido de 2 a 4 hilos

fxotune

El comando fxotune viene en Elastix

Debe ejecutarse con Asterisk apagado

86

Capítulo 14


Simplemente se ejecuta “fxotune -i 5”

El número 5 sólo indica qué dígito se debe marcar para suspender el tono de marcado.

En casi todo los casos es cualquier dígito

Guarda los resultados en /etc/fxotune.conf

Para que DAHDI se calibre en base a este archivo hay que ejecutar “fxotune -s”

Síntomas: Bajo Nivel o Volumen

La señal eléctrica se atenúa

Usualmente conductores de mala calidad

Es posible amplificar la señal con el uso de los parámetros rxgain y txgain pero hay que

tener cuidado pues esto podría generar eco

Estos parámetros se modifican a nivel de DAHDI en chan_dahdi.conf.

Síntomas: Retardo

La voz se demora más de lo usual en llegar a destino

Si es menor a 200ms pasa desapercibido

Retardo de más de 500ms provoca que la conversación se traslape, lo cual es molesto

para el interlocutor

Las redes de paquetes pueden introducir retardo si se sobrepasa su capacidad

Hay que tratar de solucionar a nivel de red

Síntomas: Distorsión de la voz

Sonido “robotizado”

Los codecs que comprimen la voz ahorran ancho de banda pero eliminan información,

esto provoca disminución de calidad de voz

Se puede cambiar de codec pero hay que tener en cuenta la disponibilidad de ancho de

banda

Algunos codecs se comportan muy mal frente a problemas de red como pérdida de

paquetes o retardos de red.

87

Capítulo 14


Síntomas: Comunicación entrecortada

Se pierde la voz por pequeños instantes de tiempo

Provoca que la conversación sea menos entendible y por lo tanto es molestoso

Usualmente se trata de problemas de red debido a equipos defectuosos, ruido

eléctrico en el cableado o equipos saturados en su capacidad

Se puede mejorar en cierta medida con un jitterbuffer

Parámetros en redes de paquetes relacionados con la calidad de voz

Hablamos de parámetros medibles aquí

A partir de estos podemos determinar cuantitativamente cómo se verá afectada la

calidad de voz por la red de paquetes

Para simplificar las cosas resumiremos todo con tres parámetros de fácil medición:

Retardo de red

Pérdida de paquetes

Jitter

Parámetros: Retardo de red

No estamos hablando de retardo de voz sino de paquetes de red

El retardo se mide en milisegundos

Aunque no es lo ideal se puede medir fácilmente con un ping

Parámetros: Pérdida de paquetes

Porcentaje de paquetes que no llegaron a su destino

Si un paquete llega demasiado tarde ya no se espera por él

La pérdida de paquetes no es deseable en ningún porcentaje. Incluso un 1% puede

afectar significativamente la calidad de voz

También se puede medir (aproximadamente) con un ping

88

Capítulo 14


Parámetros: Jitter

Es la variabilidad del retardo

También se mide en milisegundos

No basta con tener un promedio de retardo aceptable si la variabilidad (jitter) es muy

alta

En aplicaciones de tiempo real como la voz si la información no llega justo a tiempo no

se puede esperar por ella

Para esperar paquetes con pequeños retardos se utiliza un jitterbuffer. Este feature ya

viene disponible en Asterisk 1.4

Jitterbuffer

Es un buffer donde se encolan paquetes por un tiempo determinado en espera de que

lleguen todos o la mayor parte posible

El tamaño del jitterbuffer es el tiempo que de espera y está en milisegundos. Un valor

usual es de 200ms

En el sip.conf (o equivalente) el parámetro se llama jbenable=yes

En el iax.conf (o equivalente) el parámetro se llama jitterbuffer=yes

Cuando el teléfono incide en la calidad de voz

Sin duda hay electrónica mejor que otra. Algunos chips procesan mejor la voz,

especialmente cuando se trata de codecs de alta compresión

Algunos chips también añaden tecnología inteligente para mejorar la calidad de voz

La calidad del micrófono y audífono también incide

89

Capítulo 14


Lamentablemente, a mayor calidad, mayor precio

Los softphones no están libres de problemas y dependen del computador. Cualquier

problema de desempeño podría afectar la calidad de voz

¿Cómo medir la calidad de voz?

Algo muy difícil pues tiene un componente subjetivo

La mente humana es muy complicada

Hay muchos modelos que intentan medir la calidad de voz. Dos que han cobrado

relevancia son MOS y el modelo E. Los estudiaremos brevemente en este curso

La escala MOS es más subjetiva y el modelo E es más objetivo

Escala MOS

Es una recomendación ITU basada en la toma de muestras subjetivas a participantes

Se les pide a algunas personas que califiquen la calidad de voz del 1 al 5

Previamente se les hace escuchar algunas conversaciones y se les muestra la calificación

para que tengan un marco referencial

Las frases que se hacen escuchar a los participantes se encuentran pre-definidas

también

90

Capítulo 14


Modelo E

También es una recomendación ITU

Se trata de un modelo más objetivo y matemático, no “necesariamente” mejor que

MOS

Se calcula en base a algunos parámetros medibles y tiene una escala distinta a MOS

(incluyendo valores negativos)

En este curso utilizaremos una fórmula simplificada que depende básicamente del

retardo de red y la pérdida de paquetes

La fórmula es:

R = 94,2 – Id – Ie

Donde,

R representa la calidad de voz

Id representa cómo afecta el retardo a la calidad

Ie representa cómo afecta la pérdida de paquetes

Notar que el parámetro Id representa el retardo ¡pero no es el retardo en sí!

También es interesante notar que el valor máximo que puede tomar R es de 94,2

Para obtener Id:

Id = 0.024 · d + 0.11 · (d – 177.3) · H(d – 177.3)

Donde d es el retardo en milisegundos y H( ) es la función de Heavyside

H(x) = 0 para x < 0 y 1 para x ≥ 0

Para obtener Ie utilizaremos un gráfico que simplificará las cosas

Vemos que Ie depende del codec, así que ahora es más obvio que algunos codecs se

ven más afectados por la pérdida de paquetes que otros.

91

Capítulo 14


Traduciendo R a la escala MOS

Es muy útil ya que MOS es más conocido y sencillo de relacionar con calidad

La fórmula es la siguiente:

Cancelador de eco

Existen versiones hardware y software

En la actualidad ya casi no existe diferencias entre el desempeño de ambas ya que la

capacidad computacional ha crecido mucho

El objetivo es calcular en tiempo real qué porcentaje de la señal de ida se refleja en la

de regreso. Si puede predecir con exactitud sólo queda restar ese porcentaje y

obtendremos una señal sin eco

Esta predicción la realiza un componente llamado filtro adaptativo

En la realidad el eco no sólo es una señal atenuada sino que también puede estar

desplazada en el tiempo (con retardo)

El filtro adaptativo tiene entonces que predecir no sólo el porcentaje de señal reflejada

sino también el retardo

Por lo tanto, analiza la señal por un lapso de tiempo llamado “cola” (o tail) y que está

en el orden de milisegundos

Valores típicos de cola son 64ms o 128ms

92

Capítulo 14


Estándar G.168

Especificación propuesta por la ITU para definir parámetros de funcionamiento de

canceladores de eco

Existen canceladores de eco compatibles con G.168 y existen otros que no

Hay empresas en el mundo que se encargan de certificar si un cancelador de eco es o

no compatible con G.168.

Por lo general esta certificación la sacan los canceladores de eco comerciales como

Softecho de Octasic

Oslec

Elastix incorpora un interesante software de cancelación de eco, open source,

conocido como OSLEC.

Este cancelador de eco es parte de DAHDI y puede ser configurado, de manera

independiente por cada canal, de manera fácil desde la interfaz Web de Elastix.

La siguiente imagen muestra la configuración de una tarjeta de telefonía analógica. En

ella se selecciona el software para la cancelación de eco.

OSLEC está seleccionado por defecto.

Para configurar el cancelador de eco en una tarjeta instalada ir a System → Hardware

Detector → Configuración de Span.

93

Capítulo 15


PROTOCOLOS VoIP AL DESCUBIERTO

Protocolo SIP

El protocolo SIP (Session Initialization Protocol) es un protocolo de señalización

(application-layer control)

Creado para administrar sesiones multimedia entre dos o más partes.

Muchos se confunden pensando en que el protocolo SIP es el que transporta la voz

propiamente dicha pero no es así

Esta labor la realiza otro protocolo que veremos más adelante; de lo que sí se encarga

SIP es de la comunicación necesaria para establecer una llamada, modificarla, así como

para finalizarla.

Detalles del protocolo

RTP es el portador de la voz y el video.

SDP se usa para negociar las capacidades de los endpoints.

Usa dos importantes protocolos como RTP/RTCP y SDP.

La última versión del estándar es la RFC3261.

Basado en texto, lo que nos permite entender los mensajes de una manera

relativamente fácil.

94

Capítulo 15


Señalización SIP: Métodos y Respuestas

95

Capítulo 15


SIP y Asterisk

Algunos detalles a tener en cuenta cuando se usa el protocolo SIP con Asterisk son los

siguientes:

• A pesar de que SIP es independiente de la capa de transporte (puede ser usado

con TCP, UDP, ATM, X.25, entre otros)

• En Asterisk su implementación estaba limitada a UDP hasta la versión 1.6. En la

versión 1.8 viene con soporte nativo para TCP.

• Por omisión se usa el puerto 5060, pero este parámetro se puede modificar en

el archivo sip.conf

• SIP tiene problemas de NAT traversal. Parámetros especiales como externip,

localnet y nat, pueden ser definidos en sip_general_custom.conf para resolver

esto.

• En Asterisk es posible hacer diagnóstico del protocolo SIP. Esto se verá más

adelante.

Una sección de llamada SIP entre dos teléfonos – sin SIP proxy

Protocolo IAX: Generalidades

El protocolo IAX (Inter-Asterisk eXchange) es un protocolo de señalización creado

por Mark Spencer, el mismo creador de Asterisk, con el objetivo de solucionar algunos

problemas existentes con otros protocolos.

En esencia IAX presenta tres ventajas muy interesantes sobre otras alternativas como

SIP.

Consume menos ancho de banda

96

Capítulo 15


Soluciona mejor problemas de NAT

Pasa más fácilmente a través de firewalls

Actualmente se usa la versión 2 del protocolo IAX,sin embargo la nomenclatura

general se intercambia entre IAX e IAX2.

IAX es un protocolo binario, a diferencia de SIP que como recordaremos es un

protocolo basado en texto.

IAX usa UDP y normalmente usa el puerto 4569.

Lo interesante de IAX es que por un solo puerto transmite tanto la voz como la

señalización y es esto lo que le permite resolver problemas de NAT

Además de esta característica el protocolo permite la troncalización de varios canales

de audio en el mismo flujo de datos.

Llamada usando IAX Una llamada IAX se puede dividir en 3 fases:

Establecimiento de la llamada

Llamada en curso

Terminación de la llamada

Establecimiento de la llamada

El equipo que la inicia (equipo A) le envía un mensaje NEW al equipo B y éste último

responde con un mensaje ACCEPT.

Luego el equipo destino timbrará en espera de que el usuario conteste. Si contesta, el

equipo B enviará un mensaje ANSWER al equipo A.

Llamada en curso

Si se contestó la llamada se inicia el intercambio de audio mediante unos paquetes

llamados frames.


Para terminar la llamada cualquiera de las partes involucradas debe enviar un mensaje

HANGUP.

97

Capítulo 15


Estableciendo una llamada


Frames IAX

Para intercambiar el audio entre los participantes de la llamada se utilizan dos tipos de

frames llamados Full y Mini.

También se les suelen llamar F y M.

Una conversación está compuesta en su mayoría por frames tipo Mini cuya virtud es

ser ligeros. Esto quiere decir que tienen una cabecera pequeña (de 4 bytes), lo cual

ayuda a ahorrar ancho de banda.

De cuando en cuando se intercambian frames tipo Full, los cuales conllevan

adicionalmente información de sincronización.

98

Capítulo 15


Protocolo RTP

RTP es el protocolo que se encarga de transportar la voz propiamente dicha.

Muchas personas se confunden y piensan que ese es el trabajo de SIP pero no es así.

Una vez que SIP establece una llamada es RTP quien toma la posta para transportar la

voz a su destino.

RTP trabaja sobre UDP y por lo tanto no hay mucho control de transmisión.

Es decir que el equipo emisor envía la voz hacia el otro extremo con la esperanza de

que llegue, pero no espera recibir confirmación de esto y a decir verdad tampoco hay

tiempo para hacerlo pues la voz necesita ser transmitida en tiempo real.

Si un paquete de voz se pierde en el camino simplemente se rellenará ese espacio con

un silencio. Lo que técnicamente se llama ruido confortable (comfort noise).

Es por esta necesidad de transmitir la información en tiempo real que resulta evidente

que RTP sea un acrónimo de Real-time Transport Protocol.

Protocolo RTCP A pesar de encargarse de casi toda la labor de transportar la voz, RTP no está solo y

tiene un protocolo de apoyo llamado RTCP.

RTCP no es del todo indispensable pero proporciona valiosa ayuda al momento de

transportar la voz de manera óptima pues proporciona estadísticas e información de

control que le permiten a Asterisk o al otro extremo tomar decisiones para mejorar la

transmisión en caso de ser posible.

Por lo tanto, los paquetes RTCP se transmiten periódicamente para comunicar dicha

información a los equipos de voz involucrados.

99

Capítulo 16


DIAGNÓSTICO BÁSICO

Interpretando logs

Todo software es perfectible, por lo cuál no debe sorprendernos si alguna vez

encontramos un bug en su funcionamiento, inclusive si se trata de Asterisk o algún

otro componente de Elastix.

Para ayudarnos a encontrar la causa por la cuál nuestro Asterisk no se está

comportando de forma habitual, se recomienda revisar la bitácora o también podemos

ayudarnos de depuradores.

Un depurador es un programa que nos permite examinar la ejecución de un programa

a un nivel de detalle mayor que el habitual

Alternativas de herramientas de depuración: strace y gdb

Cuando tenemos un problema con un servidor, antes de perder la cabeza se

recomienda seguir los siguientes pasos:

Identificar el componente que está causando problemas

Reproducir el bug

Buscar si se trata de un bug que ya se encuentra identificado

Depurar

Reportar el bug

Para poder interpretar un error debemos al menos conocer los errores más comunes

de programación, y mejor aún si en nuestras capacidades está el poder aportar con una

corrección en el código fuente.

Algunas causas son:

Falla de segmentación

Deadlock

División para cero

Buffer overflow

Strace

Es un depurador para Linux muy fácil de usar que monitorea las llamadas a sistema que

realiza un programa determinado y todas las señales que este recibe.

Sintaxis:

100

Capítulo 16


strace [opciones] programa [argumentos]

Ejemplo:

strace cat /proc/cpuinfo

GDB

Nos permite hacer seguimiento de la ejecución de un programa insertando pausas

cuando creamos necesario.

También nos permite observar lo que un programa estaba haciendo cuando se colgó.

Existen tres maneras de usar gdb:

Depurando un programa desde el depurador

Depuración sobre Asterisk en plena ejecución

Depuración haciendo backtrace sobre un Asterisk caído

Sintaxis: gdb programa opciones

Diagnóstico con el CLI

Asterisk posee una interfaz de línea de comandos (CLI) que permite trabajar

directamente ingresando comandos.

Para ingresar debemos ejecutar asterisk -r

Para depurar los mensajes de Elastix, podemos incrementar el nivel de detalle de los

mensajes mostrado. Para ello usamos el comando: core set verbose 6

Con ello subimos a nivel de detalle 6, con lo que Asterisk será más informativo. El

valor inicial es 3.

Es importante también conocer si todos los dispositivos de mi plan de marcado están

disponibles.

Lo consultamos con el siguiente comando: core show hints

Una forma de consultar la ayuda para revisar los comandos disponibles es ejecutando:

help

Si necesitamos ayuda con algún comando en específico ejecutamos: help [comando]

Sniffing

Sniffing es una práctica que consiste en escuchar los paquetes que circulan por la red.

101

Capítulo 16


Para poder capturar el tráfico se utiliza una aplicación llamada Sniffer y existen algunas

alternativas disponibles.

Si podemos capturar los paquetes RTP de una llamada podemos utilizar herramientas

para convertir estos paquetes en audio que podamos escuchar.

El protocolo SIP es un protocolo de texto, capturando paquetes SIP de la red

podremos ver información como Caller Ids, comandos y respuestas SIP.

Algunas herramientas disponibles:

VoIPong: rastrea la red en busca de llamadas VoIP, las guarda en formato wav.

Wireshark: el antiguo proyecto Ethereal permite análisis de VoIP y grabar el payload en

formato crudo.

Oreka: algo más complejo pero que permite incluso decodificar codecs, provee

interfaz web de monitoreo.

Para evitar escuchas o pinchazos telefónicos a nivel de VoIP tenemos la alternativa de

encriptar la comunicación (SRTP, VPN, IAX encriptado)

102

Capítulo 17


SISTEMA DE CORREO EN ELASTIX

Arquitectura del sistema de email

Un sistema de correo electrónico esta formado de varios componentes. Los

principales son:

MUA (Mail User Agent),

MTA (Mail Transfer Agent),

MDA (Mail Delivery Agent).

MUA (Mail User Agent)

Programa con el que se genera el correo electrónico.

Puede residir en la estación de trabajo del usuario, como Mozilla Thunderbird o

Microsoft Outlook.

Puede residir en el servidor, como servicio de Webmail o sistemas de Voicemail y de

Fax.

Los usuarios acceden a sus buzones de correo a través del MUA, mediante los

protocolos POP y/o IMAP, que deben estar activos en el servidor de correos.

MTA (Mail Transfer Agent)

Mediante protocolo SMTP, recibe el mensaje del MUA.

Decide a quién debe entregar el mensaje.

103

Capítulo 17


Si el mensaje está destinado a otro dominio, el MTA trata de contactarse con el

servidor de correo de dicho dominio y transfiere mediante el protocolo SMTP el

mensaje.

Si el mensaje está destinado al dominio local, el MTA transfiere el mensaje al MDA que

se encarga de colocarlo en el buzón respectivo.

MDA (Mail Delivery Agent)

Es un software que acepta correo entrante.

Distribuye los mensajes a los buzones de los destinatarios si la cuenta de destino está

en el servidor local.

Reenvía los mensajes a un servidor SMTP si la cuenta de destino está en una ubicación

remota o está dirigido a otro dominio.

En Elastix

El MTA que usa Elastix es Postfix.

El MDA que usa Elastix es Cyrus IMAP, que además provee los servicio de POP e

IMAP.

Elastix tiene una interfaz de webmail incorporada que se llama RoundCube Mail, que

puede ser usada como MUA.

Configurando el sistema de email

Elastix facilita la tarea de configuración del servidor de correo.

En la interfaz gráfica de Elastix, ir a Email → Domains.

Tomando en cuenta que el servicio de correo de Elastix es multi-dominio, podemos

configurar el servidor para recibir los correos de diferentes dominios.

Para crea un nuevo dominio se utiliza el botón ”Crear Dominio”, lo que muestra una

nueva pantalla en la que se ingresa el nuevo dominio.

104

Capítulo 17


Después de crear un dominio nuevo podremos crear cuentas de correo. Ir a Email →

Accounts.

Seleccione el dominio deseado y haga clic en "Crear una nueva cuenta"

Ingresamos la información básica de la cuenta de correo, la cuota y la contraseña.

Luego guardamos.

El nombre de la cuenta tiene la siguiente syntaxis: nombre_de_la_cuenta@dominio.

Para editar la contraseña y/o la cuota basta con hacer clic en el link de la cuenta.

Relay

Si se va a utilizar un software manejador de correos (Microsoft Outlook, Mozilla

Thunderbird u otro similar), se deberá configurar en el servidor las direcciones de red

que estarán autorizadas para realizar el envío de correos hacia dominios que no son

locales.

El proceso para realizar este envío a un dominio externo se denomina RELAY .

Para configurarlo debemos ir a Email → Relay .

105

Capítulo 17


Se muestran las direcciones de red que están permitidas, y se puede agregar una

dirección de red por línea, indicando además la máscara de red de la misma.

RoundCube Mail

Es una interfaz gráfica de correo integrada en Elastix localizada en: Email → Webmail

(Interfaz de Elastix).

Para acceder directamente puede colocar la siguiente dirección en su browser:

https://IP_del_Servidor/mail y hacer login con una de las cuentas creadas

anteriormente.

Para hacer login es necesario ingresar la dirección de correo electrónico completa

(usuario@dominio) y la contraseña.

Configuraciones a bajo nivel

Postfix

Servicio de correo MTA usado por Elastix.

Potente, seguro y flexible para configuraciones avanzadas.

Smart Relay (Mensajes de correo no destinados a dominios locales se transfieran a un

servidor específico que a su vez se encarga de transferirlo a los servidores de destino).

En Postfix esta opción es llamada "relayhost"

Para configurar la opción "relayhost":

En una consola ir al archivo: /etc/postfix/main.cf

Se agrega la línea relayhost = [servidor_SMTP_GATEWAY]

Se debe reiniciar el servidor para aplicar cambios.

Luchando contra el SPAM

Elastix provee un filtro contra SPAM que verifica los mensajes recibidos por el servidor

de correo y les asigna un puntaje dependiendo de ciertas características.

Se puede configurar un nivel de atrapar del 1 al 10, siendo 1 el nivel con el

minuciosidad mas alta.

El filtro de SPAM tiene dos políticas:

106

Capítulo 17


Marcar Asunto.- Marcara correo como spam con un prefijo ([SPAM] está configurado

por defecto) y lo enviará al buzón de entrada.

Capturar Spam: Marcará el spam con un prefijo, pero lo enviará a una carpeta de spam

en lugar del buzón de entrada.

El Antispam debe estar activado para trabajar.

Instalando Antivirus

En Elastix, cualquier antivirus que trabaje con Postfix puede ser instalado.

Es importante seguir las instrucciones del fabricante.

Existen varias opciones de antivirus libres:

ClamAV

F-Prot

Avira

Vexira

Entre otros.

107

Capítulo 18


FAX EN ELASTIX

Sistema de Fax en Elastix

El sistema de fax en Elastix está compuesto de 4 componentes importantes:

Asterisk: telefonía IP.

Iaxmodem: Programa de fax-modem que se conecta a asterisk mediante un canal IAX.

Crea un dispositivo (/dev/ttyIAX), que será utilizado por Hylafax

Hylafax: Programa para envío y recepción de fax.

Framework NEO: Esquema de desarrollo que incluye librerías que implementan Elastix.

Esquema básico del sistema de fax

laxmodem

Es una aplicación que simula un faxmodem mediante librerias DSP (Digital Signal

Processing).

Esta aplicación puede ser usada por cualquier programa de envío y recepción de fax.

Cuando se implementa iaxmodem se crea un archivo que contendrá los datos que

define el dispositivo virtual y lo asocia a una extensión de asterisk.

En Elastix ese archivo es:

108

Capítulo 18


El archivo iaxmodem-cfg.ttyIAX# es generado por Elastix como sigue:

Hylafax

Es un sistema de envío y recepción de fax.

En su esencia Hylafax consta de un programa servidor llamado Faxgetty que se encarga

de estar monitoreando los dispositivos ttyIAX y de un programa despachador de fax

llamado faxrcvd

El servidor Faxgetty está siempre leyendo unos archivos especiales llamados

FIFO.ttyIAX# que es en donde los dispositivos ttyIAX# reciben comandos de modem.

Elastix utiliza un archivo que permite asociar los modems a Hylafax, es archivo :

El archivo config.ttyIAX# es generado por Elastix como sigue:

109

Capítulo 18


Funcionamiento Básico

Estructura del Sistema de Fax

El Sistema de Fax de Elastix está compuesto de 7 Módulos:

faxclients

faxlist

faxmaster

faxnew

faxviewer

sendfax

email_template

Utiliza la base de datos fax.db

Cada módulo contiene las carpetas y archivo:

configs

themes

index.php

El módulo de Fax utiliza librerías del framework principal:

/var/www/html/libs/paloSantoFax.class.php

110

Capítulo 18


Base de datos del Sistema de Fax

La base de datos para el sistema de fax se llama fax.db

Analizando la librería “paloSantoFax.class.php”

Función _createFaxSystem

111

Capítulo 18


Función _configureIaxmodem

Función _configureHylafax

Función _writeInittab

112

Capítulo 18


Al final de la función createFaxSystem() se ejecuta los siguientes comandos que hacen

que tomen efecto los archivos creados:

Configurando Fax en Elastix

El menú de Fax muestra por defecto el listado de Faxes virtuales. En este menú

podemos ver todas las extensiones de fax creadas.

Podemos modificar cualquier extensión haciendo clic en ella.

Para crear una extensión de Fax debemos crear primero una extensión IAX.

Luego debemos ir a Fax → New Virtual Fax. Ahí podemos crear la extensión de fax

con la información usada para la creación de la extensión IAX.

El email de recepción puede ser cualquiera.

El menú de Fax Master nos permite incluir una dirección de correo general

(normalmente un email de administración) que permita recibir todos los mensajes de

confirmación o errores del servidor de fax.

113

Capítulo 18


El menú Fax Client permite incluir la dirección IP permitida para el envío de fax a

través de Elastix.

El menú Fax Viewer nos permite ver un listado completo de fax recibidos. Podemos

además filtrarlos por fecha o por tipo de fax.

Existe además un campo de búsqueda por nombre de compañía y otro por fax de

compañía.

El menú template de Email (Email Template) nos permite configurar ciertos parámetros

del correo que será enviado con el fax.

Protocolo T.38

El protocolo T.38 es un protocolo recomendado por la ITU que sirve para transportar

FAX sobre redes IP.

T.38 surge como solución a ciertos problemas y métodos de tratamiento de fax como

audio a la hora de transportarlos.

114

Capítulo 18


El protocolo T.38 resuelve estos problemas usando algunas técnicas interesantes como

la redundancia de paquetes.

Es decir que por cada paquete enviado a través de la red es probable que se envíen

algunas copias por si alguno se pierde en el camino.

A partir de Asterisk 1.4 se introdujo soporte limitado para el protocolo T.38. Asterisk

no es capaz de terminar una transmisión T.38, ni de entender el protocolo.

Lo único que puede hacer Asterisk con T.38 es pasar la comunicación de un lado a

otro. O sea que T.38 puede pasar a través de Asterisk y a esta modalidad de

funcionamiento se le llama passthrough.

La versión 1.6 de Asterisk añade más soporte para T.38 y estará en la capacidad de

entender el protocolo un poco más y por lo tanto hacer algunas cosas interesantes.

AvantFax, un GUI Alternativo

AvantFax es un GUI que facilita la administración de faxes.

AvantFax utiliza como fax server Hylafax.

Permite el envío y recepción de faxes a través de la interfaz web.

Recientemente se ha lanzado un instalador RPM de AvantFAX que puede ser

descargado del repositorio de Extras de Elastix.

115

Technology

Elastix slide book-ect