Slide Book Ece

Captulo 1

Elastix Certified Technician PaloSanto Solutions 2012 Todos los derechos reservados

INSTALACIN DE ELASTIX

Instalando desde CD Es recomendable instalar la ltima versin estable de Elastix disponible en la pgina del

proyecto.

Para realizar la instalacin desde CD, debemos descargar el archivo de imagen (con

extensin iso), y grabarlo en un disco en blanco.

Es importante grabar el iso usando software especializado para este propsito.

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 instalacin 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 instalacin 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 instalacin estndar basta con presionar ENTER

Advertencia: La instalacin estndar borrar completamente el disco duro.

1

Captulo 1


Seleccionamos el idioma para la instalacin.

El instalador nos pide seleccionar el esquema del teclado

Seleccionamos el tipo de particionamiento (primera opcin).

2

Captulo 1


Confirmamos que se remuevan todas las particiones (S).

Revisar/modificar la capa de partiticiones (No).

Configurar interfaces de red (S).

3

Captulo 1


Seleccionar que se active al inicio y soporte para IPv4.

Seleccionar ya sea DHCP o configuracin manual.

Si se utiliza configuracin manual, ingresar la direccin y la mscara.

4

Captulo 1


Ingresar la direccin IP de la puerta de enlace y del servidor DNS.

Ingresar el nombre del host.

Seleccionamos el huso horario adecuado.

5

Captulo 1


Ingresar la contrasea del usuario root

Esperar hasta que finalice la instalacin automtica de paquetes.

Ingresamos la contrasea para el usuario root de MySQL (no confundir con usuario

root de linux).

6

Captulo 1


Ingresar nuevamente la contrasea de root de MySQL.

Ingresar la contrasea para el usuario admin del web GUI de Elastix.

Nota: Esta ser adems la contrasea para los siguientes servicios: FreePBX, Vtiger, A2Billing y FOP.

Aunque no se menciona esta contrasea es adems la contrasea del AMI admin.

Ingresar nuevamente la contrasea admin de Elastix.

7

Captulo 1


La instalacin ha sido completada, podremos ingresar a nuestro sistema con usuario

root y su contrasea ingresada durante la instalacin.

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

ofrecer redundancia de informacin.

Dependiendo el nmero 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 continuacin 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

Captulo 1


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

Seleccione la opcin "Nuevo

Tamaos de disco:

1era particin = 100MB para el boot,

2da particin = el doble del tamao del RAM del sistema para swap (en este ejemplo el

RAM es 512 MB),

3ra particin = debe ser completada con el espacio disponible.

9

Captulo 1


En cada particin 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 particin (swap)

Imagen del proceso para la tercera particin (seleccionamos ocupar todo el espacio disponible)

Al final tendremos 3 particiones en cada disco.

No se preocupe por el orden de cada particin se re-ordenarn cuando configuremos

el RAID.

10

Captulo 1


Para iniciar la particin en espejos debemos seleccionar la opcin "RAID".

Aqu seleccionaremos las particiones que sern miembros del RAID, el "Tipo de

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

Punto de Montaje: particin boot = /boot, swap = no coloque nada, particin "root"

= use /

Tipo de sistema de archivos: particin boot = seleccione ext3, particin swap =

seleccione swap, y seleccione ext3 para la particin "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 particin boot.

Nota: Es importante seleccionar los particiones correspondientes en la seccin Miembros del RAID. En este

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

Las configuraciones de RAID aparecern sobre las particiones previamente creadas.

Cuando finalice seleccione "Aceptar" para continuar con la instalacin normalmente.

11

Captulo 2


VIRTUALIZACIN

Virtualizacin

Una mquina virtual simula un sistema fsico con caractersticas de hardware

especficas.

En un solo servidor se pueden implementar varias mquinas virtuales para cumplir

varios servicios.

Esto nos permite la reutilizacin de hardware existente, lo cual implica ahorro de

recursos.

Nos permite adems reduccin de costos y una administracin global centralizada y

simple.

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

consumo de energa.

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 operacin real, lo cual es til

previo a una actualizacin y nos ser til en este curso para probar el potencial de

Elastix.

12

Captulo 2


Entre las alternativas que revisaremos estn:

VMware

VirtualBox

XEN

VMware Una mquina virtual simula un sistema fsico con caractersticas de hardware

especficas.

En un solo servidor se pueden implementar varias mquinas virtuales para cumplir

varios servicios.

Esto nos permite la reutilizacin de hardware existente, lo cual implica ahorro de

recursos.

Nos permite adems reduccin de costos y una administracin global centralizada y

simple.

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

Inicialmente no permita crear mquinas virtuales, pero esta limitacin fue removida en

la versin 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 produccin

Pgina web: http://www.vmware.com/

VirtualBox Es un software de virtualizacin 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 anfitrin: 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

Captulo 2


Es un software de virtualizacin para arquitecturas x86/amd64 desarrollado








Es un software de virtualizacin 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 slo para acceder a redes externas pero no se puede acceder a la

mquina 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 mquinas virtuales

Adaptador solo-anfitrin: La mquina virtual es vista como otra mquina en la red.

Controlador genrico: usado para compartir una interfaz de red genrica. Un

ejemplo es la interconexin entre dos mquinas virtuales ubicados en diferentes hosts.

Con Elastix podemos usar: Adaptador puente y Adaptador solo anfitrin. Para este

curso utilizaremos Adaptador puente.

14

Captulo 2


XEN Es la alternativa ms eficiente de virtualizacin

Solucin recomendada para servidores por su eficiencia

Es lo que utilizan la mayora de proveedores de hosting de VPS con Elastix

Existe 2 tipos de virtualizacin: completa y para-virtual

Permite hacer migraciones de mquinas virtuales en caliente

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

Arquitectura en XEN XEN se comunica directamente con el hardware a travs de un componente llamado

Hipervisor.

Cuando XEN arranca levanta automticamente un dominio conocido como dom0

Dom0 es un dominio privilegiado donde se administran otros dominios.

Los dems 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

opcin para este servidor

Se puede instalar con virtualizacin completa o paravirtual

Se puede instalar sobre una mquina virtual de CentOS 5.x. Esto es muy til si

tenemos un servidor VPS remoto con CentOS cargado

15

Captulo 3


LINUX PARA ADMINISTRADORES DE ELASTIX

Introduccin 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 travs del protocolo SSH (Secure Shell)

El SSH es un protocolo encriptado.

Lnea de Comandos en Linux Ejemplo terminal Linux de Elastix:.

16

Captulo 3


Comandos Bsicos

Sistema de Archivos Estructura de rbol de directorios

Todos empiezan en la raz /

Directorios importantes en Elastix:

o /etc/asterisk: guarda la configuracin 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 Descripcin

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. Tambin se lo usa para renombrar archivos.

rm Elimina un archivo

tail -f filename Muestra las ltimas lneas 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 diagnstico.

find Permite buscar archivos

vim Programa para ver y editar archivos de texto plano.

ifconfig Muestra informacin de las interfaces de red y permite modificarlas temporalmente.

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

reboot Reinicia el equipo

shutdown -h now Apaga el equipo

17

Captulo 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 ejecucin(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: Notacin Octogonal Los permisos se pueden representar con nmeros

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

Captulo 3


YUM Maneja la instalacin 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

Captulo 4


ELASTIX: GENERALIDADES

Qu es Elastix? Una solucin de servidor de comunicaciones unificadas: telefona, fax, IM, email,

colaboracin.

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.

Adems de otros paquetes de cdigo abierto.

Rpido crecimiento, 1000.000 descargas hasta Noviembre de 2010.

Reconocimiento con el premio INTERNET TELEPHONY product of the year Award

aos 2011 y 2012

Servidor de Comunicaciones Unificadas? Integracin de diferentes sistemas de comunicaciones.

Por ejemplo, el telfono es contestado por Asterisk (telefona) y en caso de resultar un

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

enva por email a travs de Postfix a su destinatario.

Mejora la productividad: ahorro de tiempo, papel, mejor acceso a la informacin

compartida.

Esquema General

20

Captulo 4


Breve historia del Proyecto Lanzado en Marzo de 2006 por la compaa PaloSanto Solutions de Ecuador.

Inicialmente no era una distro sino una interfaz de reportacin para llamadas de

Asterisk

En Diciembre de 2006 se lanza la primera versin 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 lder del mercado.

Caractersticas de Elastix Algunas de las caractersticas y funcionalidades de Elastix son:

Voicemail

Fax-a-email

Soporte para soft phones

Consola de operador

IVR (recepcionista digital)

Interfaz de configuracin Web

Sala de conferencias

Music-on-hold con soporte mp3s

Campaas de tele-mercadeo

Grabacin de llamadas

Parqueo de llamadas

Call-pickup

Colas de atencin

Limitacin de tiempo de llamada

Least Cost Routing

Roaming de extensiones

Interconexin entre PBXs

Identificacin del llamante

CRM incluido Reportacin avanzada

Personalizacin y desarrollo

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

Licenciamiento de Elastix Elastix es software libre licenciado bajo GPL versin 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 todava existe la duda: Elastix puede ser descargado sin costo alguno.

21

Captulo 4


Interfaz Web de administracin

Men System

Men PBX

Men Email

Men Fax

22

Captulo 4


Men Reports

Men extendido

Interfaz Web de administracin Mdulo de Add-ons: Funcionalidad adicional disponible en un slo clic

www.elastix.org Sitio Web oficial del proyecto.

Mantenido por PaloSanto Solutions y la comunidad Elastix.

Aqu podemos encontrar:

Foros

Wiki (Documentacin)

Chat en vivo IRC

Suscripcin a listas de correo

Links de descargas

Informacin Comercial y Proyectos

Eventos

23

Captulo 5


FUNCIONAMIENTO INTERNO DE FREEPBX

Fundamentos de FreePBX Software de configuracin de Asterisk

Integrado en la distribucin Elastix

Genera los archivos de configuracin de Asterisk

o Incluye el plan de marcado o Basados en la configuracin ingresada por el usuario

Dos pasos para la configuracin:

o Guarda la informacin en una base de datos de configuracin. o En el caso de Elastix el motor de base de datos usado es MySQL. o Convierte la informacin de la base de datos en archivos de configuracin a

travs de parsing.

24

Captulo 5


Organizacin de archivos

Configuracin de FreePBX amportal.conf: Archivo de texto plano, ledo por FreePBX.

Informacin general de configuracin.

Editable en caso de requerirse.

Informacin de acceso a la base de datos.

Tipo de autenticacin para usuarios Web.

Documentacin para manejo de opciones y directivas de configuracin.

retrieve.conf: Escrito en PHP

Genera el plan de marcado a partir de la informacin almacenada en la base de datos.

Directorio Descripcin

/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 configuracin de Asterisk.

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

/var/lib/asterisk/bin/ Directorio de binarios, links simblicos a carpetas de mdulos.

/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

Captulo 5


Programa ejecutable desde la lnea de comandos.

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

Esta operacin ser muy frecuente en la mayora 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 extensin y otras configuraciones de la misma (call forward, call

waiting, do not disturb).

Toma acciones a partir del estado y la configuracin de la extensin.

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

Mdulo de FreePBX: Estructura

Nombre del Archivo Descripcin

module.xml Informacin del mdulo en formato XML.

page.nombredelmodulo.php Archivo principal del mdulo escrito en PHP.

functions.inc.php Librera especial con funciones PHP.

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

uninstall.sql Contiene sentencias SQL para desinstalar el mdulo.

install.php Script PHP que se ejecuta al momento de instalar el mdulo.

uninstall.php Script PHP que se ejecuta al momento de desinstalar el mdulo

26

Captulo 5


Cmo se embebe en Elastix? Para poder embeber freePBX en Elastix se desarroll un cdigo WRAPPER

Este cdigo se acopla los mdulos de freePBX como un mdulo Elastix.

Este desarrollo consiste en:

o Mdulo pbxadmin de Elastix o Archivo /var/www/html/config.php

Mdulo pbxadmin de Elastix

Encargado de obtener el contenido de mdulos de freePBX por medio de inclusin de

archivos de PHP.

El index.php de ste mdulo (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 mnima del que

esta ubicado dentro del cdigo 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 mdulos de freePBX.

Lo que hace es redireccionar las peticiones al mdulo pbxadmin de Elastix e incluir el

index.php del framework Elastix.

Grfico ilustrativo de FreePBX embebido

config.phpIndex.php

Framework Elastix


Redirecciona las peticiones a

Redirecciona a

Obtiene el contenido de mdulos de FreePBX pero sin estilos

Mdulos de FreePBXHacen las peticiones alconfig.php ubicado enla raz

WRAPPER

1

23

4

27

Captulo 5


FUNCIONAMIENTO INTERNO DE FREEPBX

Fundamentos de FreePBX Software de configuracin de Asterisk

Integrado en la distribucin Elastix

Genera los archivos de configuracin de Asterisk

o Incluye el plan de marcado o Basados en la configuracin ingresada por el usuario

Dos pasos para la configuracin:

o Guarda la informacin en una base de datos de configuracin. o En el caso de Elastix el motor de base de datos usado es MySQL. o Convierte la informacin de la base de datos en archivos de configuracin a

travs de parsing.

28

Captulo 5


Organizacin de archivos

Configuracin de FreePBX amportal.conf: Archivo de texto plano, ledo por FreePBX.

Informacin general de configuracin.

Editable en caso de requerirse.

Informacin de acceso a la base de datos.

Tipo de autenticacin para usuarios Web.

Documentacin para manejo de opciones y directivas de configuracin.

retrieve.conf: Escrito en PHP

Genera el plan de marcado a partir de la informacin almacenada en la base de datos.

Directorio Descripcin

/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 configuracin de Asterisk.

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

/var/lib/asterisk/bin/ Directorio de binarios, links simblicos a carpetas de mdulos.

/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

Captulo 5


Programa ejecutable desde la lnea de comandos.

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

Esta operacin ser muy frecuente en la mayora 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 extensin y otras configuraciones de la misma (call forward, call

waiting, do not disturb).

Toma acciones a partir del estado y la configuracin de la extensin.

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

Mdulo de FreePBX: Estructura

Nombre del Archivo Descripcin

module.xml Informacin del mdulo en formato XML.

page.nombredelmodulo.php Archivo principal del mdulo escrito en PHP.

functions.inc.php Librera especial con funciones PHP.

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

uninstall.sql Contiene sentencias SQL para desinstalar el mdulo.

install.php Script PHP que se ejecuta al momento de instalar el mdulo.

uninstall.php Script PHP que se ejecuta al momento de desinstalar el mdulo

30

Captulo 5


Cmo se embebe en Elastix? Para poder embeber freePBX en Elastix se desarroll un cdigo WRAPPER

Este cdigo se acopla los mdulos de freePBX como un mdulo Elastix.

Este desarrollo consiste en:

o Mdulo pbxadmin de Elastix o Archivo /var/www/html/config.php


Encargado de obtener el contenido de mdulos de freePBX por medio de inclusin de

archivos de PHP.

El index.php de ste mdulo (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 mnima del que

esta ubicado dentro del cdigo 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 mdulos de freePBX.

Lo que hace es redireccionar las peticiones al mdulo pbxadmin de Elastix e incluir el

index.php del framework Elastix.

Grfico ilustrativo de FreePBX embebido

config.phpIndex.php

Framework Elastix


Redirecciona las peticiones a

Redirecciona a

Obtiene el contenido de mdulos de FreePBX pero sin estilos

Mdulos de FreePBXHacen las peticiones alconfig.php ubicado enla raz

WRAPPER

1

23

4

31

Captulo 6


CONFIGURACIN BSICA DE ELASTIX

Ingreso a Elastix va Web Abrir en un navegador web: https://ip-servidor (Direccin IP de Elastix)

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

excepcin en su navegador web

Ingresar con los siguientes datos

Usuario: admin

Password: La clave de admin registrada durante la instalacin

Configuracin de Red Elastix utiliza DHCP por defecto

En la mayora de casos se debe configurar:

IP esttico

Puerta de Enlace

DNS

Para configurar se debe acceder al men Sistema Red

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

32

Captulo 6


Creando una extensin Se pueden crear extensiones: sip, iax, zap, dahdi y custom

SIP: protocolo estndar para terminales de voz/ip. Soportado por la mayora de

telfonos de ip

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

sip en ambientes nat

Zap: Usada para extensiones anlogas o tradicionales

dahdi: Usada para extensiones anlogas o tradicionales

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

lnea externa a una extensin

Ejemplo para crear extensin SIP Para crear una extensin ingrese a:

PBX PBX Configuration extensiones

Seleccione: Generic SIP Device

Como mnimo debe ingresar: nmero de extensin, display name y el secret

El mode DTMF (dtmfmode) de la extensin y telfono debe ser el mismo.

El dtmfmode predeterminado es: rfc2833

Otras opciones para el modo rfc son:

info

inband

auto

33

Captulo 6


Ejemplo: Configuracin de Softphone La configuracin de un telfono IP de software debe incluir por lo menos: el usuario

(normalmente la extensin), el password (secret) y la direccin IP del servidor Elastix.

En la grfica: configuracin de cuenta en el softphone Zoiper

Configuraciones generales Configuraciones importantes

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

grabacin de llamadas

Company Directory: Para acceder al directorio telefnico desde un ivr con *411 o

#

Security Settings: No permite llamadas sip annimas

Actualizaciones: Bloqueada por defecto

Colas Agrupan a varias extensiones conocidas como agentes

Agentes estticos o dinmicos

Existen varias Estrategias de marcado:

Sonar todos: Timbra a todos los miembros de la cola

Agente con ltima llamada ms 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

Captulo 6


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

utilizando una penalidad como medida de probabilidad.

Colas: configuracin bsica Queue number: El nmero por el que se podr llamar a la extensin

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

administrativa

Queue password: Clave que deber ingresar un agente dinmico

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 telfono sepa a que cola pertenece la llamada.

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

Max callers: El nmero mximo de personas que esperan en una cola si todos los

agentes estn 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 estn en espera en la cola sern

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: Opcin 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

Captulo 6


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

seleccinelo y haga clic en Enviar.

Contine al paso 2, asigne un nombre a su grabacin y haga clic en Guardar.

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

Si desea grabar desde un telfono ingrese el nmero de extensin y haga clic en ir

Marque *77 para grabar el mensaje (desde la extensin que ingres)

Marque *99 para escuchar la grabacin (desde la extensin 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 Aadir 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 marcacin directa: Permitir marcar directamente a extensiones

36

Captulo 6


Anuncio: Seleccionamos un anuncio previamente grabado o cargado en el

sistema.

Se agregan los nmeros de opcin y sus destinos.

La opcin t sirve para timeout

La opcin 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 opcin que enlazar el actual IVR al siguiente (siendo t la opcin 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 ms personas simultneamente

Se pueden hacer conferencias con extensiones locales y nmeros 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 configuracin:

37

Captulo 6


Salas de conferencia: Estticas Se crean para uso permanente

Ejemplo de Configuracin: Ir a PBX PBX Configuration Conferencias

Nmero de conferencia: la extensin 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 administracin: Necesaria nicamente si se selecciona la opcin esperar al

administrador.

Opciones de la conferencia

38

Captulo 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 extensin.

La llamada es transferida desde una extensin inicial a un estacionamiento o parking

slot.

Despus puede ser recuperada desde otra locacin marcando un nmero asignado.

Para crear un estacionamiento ingrese a:

PBX PBX Configuration Estacionamiento

La extensin de marcado para enviar una llamada a aparcamiento es por defecto 70.

El tiempo de configuracin para espera en el estacionamiento va de 15 segundos a 10

minutos.

El contexto de aparcamiento por defecto es: parkedcalls. Esto no debera ser

cambiado.

Al activar la opcin 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 nmero de estacionamiento.

Usualmente 71, 72, 73,...n (un mximo de 20).

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

extensin marcando el nmero que escuch en la grabacin.

39

Captulo 6


Msica en espera Se puede subir msica en formatos wav o mp3 al servidor

Se pueden crear listas de msica para asignar en diferentes lugares de nuestra central.

Ej. Callcenter, colas, etc..

Para configurar se debe ingresar a PBX Configuracin Msica en Espera.

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

consumir mas recursos.

Bookmark de menes comunes Elastix 2.2 permite marcar menes comunes para fcil.

Esta funcionalidad est localizada en la esquina derecha de cada seccin con un icono

(estrella).

Para aadir un bookmark basta con hacer clic en Iy la seccin se mostrar en el

men de la columna izquierda

40

Captulo 6


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

Cumple las funciones de un telfono de recepcionista

Se pueden transferir llamadas, crear conferencias, etc.

La clave de administracin 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 versin

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

Pantalla del FOP:

41

Captulo 7


CONFIGURACIN DE TELFONO IP

Qu es un telfono IP? Un telfono IP es un dispositivo que permite realizar una comunicacin de voz utilizando

la red IP, ya sea mediante red de rea local o a travs de Internet.

La tecnologa que hace esto posible esto se conoce como VoIP (Voz sobre IP).

El telfono IP convierte y comprime la seal de la voz en paquetes de datos que sern

enviados en la red IP, en lugar de utilizar una conexin de red telfonica.

Configuracin de telfono IP Para configurar un telfono IP debemos tener en cuenta tres aspectos:

1. Configuracin de red

2. Registro del dispositivo con el servidor Elastix

3. El Telfono IP apropiado

Para ilustrar de mejor manera los puntos mencionados, utilizaremos un telfono Yealink

SIP-T22P.

Configuracin de red

La configuracin de red puede realizarse por DHCP (lo ms comn) o se puede asignar

una direccin IP esttica.

DHCP

Mediante esta opcin, el telfono obtendr una direccin 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

Captulo 7


IP esttica

Esta opcin es til si deseamos contar contar con un registro exacto de las direcciones

IP de cada telfono.

Es tambin til si deseamos colocar los dispositivos IP en segmentos especficos de

nuestra red.

En esta opcin, adems de la IP se necesita ingresar la mscara de red y la puerta de

enlace en el caso de que su telfono se encuentre en otro segmento de red.

La configuracin de Telfonos Yealink SIP-T22P o cualquier otro modelo de Yealink se

puede realizar ingresando a un web browser colocando la direccin IP del telfono.

El usuario y contrasea por defecto en todos los modelos Yealink es: admin

Nota: tambin es posible configurar la extensin del telfono desde el Endpoint Configurator de

Elastix (PBX Endpoint Configurator) , esto lo veremos ms adelante.

Para configurar la extensin debe ir a Cuenta.

El telfono Yealink SIP-T22P puede ser configurado con 3 cuentas.

La informacin bsica necesaria para la configuracin es:

Lnea Activa: Habilita la cuenta

Nombre de registro: Extensin de usuario

Nombre de usuario: Extensin de usuario

Contrasea: Secret - La contrasea de la extensin

Servidor SIP: Direccin IP del servidor Elastix

Servidor de salida Proxy: IP del servidor Elastix

Interfaz de administracin web de Yealink

43

Captulo 7


Aprovisionamiento El aprovisionamiento permite la configuracin en lote de telfonos IP.

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

mdulo de configuracin de Endpoints (Endpoint Configurator).

El proceso adecuado es:

1. Creacin de extensiones

2. Habilitar los telfonos IP para el aprovisionamiento

3. Deteccin de los dispositivos en la red

4. Asignacin 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 informacin de las direcciones IP y MAC de los dispositivos

conectados.

Al obtener la informacin de todos los dispositivos este trata de identificar los equipos

que pudieran ser telfonos IP.

Luego trata de recabar informacin del fabricante y modelo para elegir cules 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 telfonos Escene, Voptech y otros.

Cuando ya se tiene el grupo de telfonos a configurar se presenta la informacin de los

mismos en la interfaz Web de Elastix.

Se mostrar algo similar a la siguiente imagen:

44

Captulo 7


Para la mayora de telfonos, el Endpoint Configurator generar un archivo de

configuracin 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 configuracin de los telfonos para hacer el

aprovisionamiento via tftp desde Elastix

Aprovisionamiento: Habilitacin de Telfonos IP En la actualidad la mayora de las marcas de telfonos IP permiten configuracin para

aprovisionamiento.

Hay algunas marcas (e.g. Atcom) en que aprovisionamiento no requiere de configuracin

previa.

Para habilitar telfonos Yealink, debemos configurar los siguientes parmetros desde la

interfaz administrtiva del telfono:

Ir a: Actualizar Advanzado

o Configurar URL: direccin IP del Servidor Elastix o Check New Config: Encendido.

45

Captulo 7


Aprovisionamiento: Asignacin 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 extensin que queremos asignar al telfono.

(ya debe haber sido creada previamente)

7. Hacer clic en Configurar

Reiniciamos el telfono (accedemos a su interfaz web haciendo clic en la IP

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

Nota: Algunos modelos se reinician automticamente.

Qu es un Softphone? Es un software que hace una simulacin de telfono IP por computadora.

Es decir, permite usar la computadora para hacer llamadas a otros softphones, telfonos

IP o a otros telfonos convencionales analgicos.

46

Captulo 7


Configurando un Softphone Presionamos el botn con la figura de la herramienta y accedemos al men de opciones.

All veremos una pantalla con opciones para configurar nuevas extensiones SIP y tambin

IAX. Zoiper cuenta con soporte para ambos protocolos.

En nuestro ejemplo configuraremos una extensin SIP. Usuario: 5678 Contrasea: 5678.

X-Lite Counterpath Zoiper Softphone

47

Captulo 7


La informacin 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 telfonos que reciban

nuestras llamadas.

Despus de llenar la informacin 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

Captulo 8


CONFIGURACIN DE HARDWARE

Tipos de tarjetera Esta tarjetera est disponible tanto para interfaces telefnicas analgicas como digitales.

Dentro de cada una de estas categoras existen las siguientes sub-categoras:

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

controladores de su hardware.

Adems 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 ingls.

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 tarjetera. Los

siguientes son los modelos soportados oficialmente a la fecha:

Analog:FXOFXS

Digital:E1/T1/J1BRI

49

Captulo 8


Hardware modular Existen fabricantes que disean su hardware de manera modular, de tal forma que pueda

ser expandible.

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

tarjetas electrnicas 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 comn que se requiera conectar un cable de poder a la tarjeta pues hay que recordar que las interfaces FXS deben proveer potencia elctrica a los dispositivos que se conecten a ella.

Deteccin de hardware Una vez que la tarjetera ha sido instalada es hora de detectarla.

En versiones muy antiguas de Elastix esta tarea se haca manualmente ejecutando un

comando desde la consola del equipo.

Puertos

ranuras para mdulos

Mdulo FXS(verde)

Mdulo FXO(rojo)

ConexinFuente de alimentacin

Sangoma TMD Card Model A20101

50

Captulo 8


Actualmente se cuenta con una interfaz Web que detecta el hardware automticamente

y nos muestra grficamente el hardware detectado.

Esta opcin podr encontrarse en el Men System Hardware Detector.

Para detectar una tarjeta hacemos clic en Avanzado y seleccionamos la opcin

Reemplazar el archivo chan_dahdi.conf.

Despus debemos dar clic en Detect New Hardware y despus 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 Deteccin de Hardware Sangoma.

Despus de esto podemos dar clic en Detectar Nuevo Hardware.

Para la deteccin de tarjetas que usan Dahdi simplemente se debe seleccionar la opcin

Reemplazar el archivo chan_dahdi.conf y despus 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

Captulo 8


Este accin 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.

Configuracin Span La herramienta de deteccin 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 parmetros que pueden diferir de la realidad.

Se puede cambiar estos parmetros usando la interfaz web o mediante consola. A

continuacin explicaremos como realizar estas configuraciones por consola.

Configuracin 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 deberamos definir

4 spans, uno por cada puerto.

Un span define en una sola lnea, la cual tiene el siguiente formato:

Spannum

Es un identificador numrico nico para etiquetar el span. Se debe empezar con el

nmero 1 e ir incrementando este identificador secuencialmente de uno en uno.

Timing

Es un dgito que define la forma en la cual se manejar la sincronizacin del span.

52

Captulo 8


LBO (Line Build Out)

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

provisto por la compaa telefnica.

Framing

Como recordaremos, los protocolos de comunicacin digital T-Carrier y E-Carrier

dividen la informacin en frames, donde cada frame transporta un nmero determinado

de timeslots.

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

Coding

Es necesario codificar la informacin enviada para hacerla menos susceptible a errores.

Esto es as porque la propia data se suele usar como fuente de sincronizacin (o reloj).

Si se transmiten tramas largas de ceros (largos segmentos sin variacin de voltaje) se

puede perder dicha sincronizacin.

Despus de realizar los cambios en el archivo system.conf, es necesario reiniciar DAHDI.

(Asterisk CLI: service dahdi restart)

Despus 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

Captulo 8


Configuracin Span: Interfaz Web En la interfaz web tenemos las siguientes opciones: Configuracin de Span y Parmetros

de Span.

En Parmetros de Span podremos configurar el timing source, LBO, Framing y Coding.

Tambin podemos seleccionar el tipo de tarjeta T1/E1 (para tarjetas que soporten modo

de seleccin por software).

En la Configuracin de Span podemos seleccionar por cada canal el software de

cancelacin de eco.

Tarjeta detectada con formato TI

Cambio de formato a E1

Troncalizacin: chan_dahdi.conf Asterisk cuenta con un mdulo llamado chan_dahdi que sirve para conectarse con los

drivers de DAHDI y de esta manera conectar Asterisk con hardware telefnico.

Este mdulo se configura a travs de un archivo llamado chan_dahdi.conf

En el archivo chan_dahdi.conf bsicamente se configura la sealizacin de los canales de

voz y se mapean los canales de Asterisk con los circuitos o lneas telefnicas definidos en

el archivo system.conf que configuramos antes.

Estos canales se pueden agrupar en troncales troncales.

54

Captulo 8


La siguiente imagen muestra el archivo chan_dahdi.conf:

Signalling

Este parmetro define la sealizacin de cada canal o grupo de canales.

Lo ms comn que veremos para circuitos analgicos ser fxs_ls y para circuitos digitales

pri_cpe.

Switchtype

Este parmetro es para circuitos digitales y especifica el tipo de switch PRI usado.

Lo ms comn es national y euroisdn, dependiendo de en qu pas nos encontremos

claro est.

55

Captulo 9


ASTERISK ESSENTIALS

Qu es Asterisk? Es un sistema de telefona basado en software libre que proporciona todas las

funcionalidades que se espera de una central telefnica (PBX).

Esto hace posible conectar un nmero determinado de telfonos 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 aadir novedades y funcionalidades.

Mark haba creado en 1999 la empresa "Linux Support Services" con el objetivo de dar

soporte a usuarios de Linux.

Para ello necesitaba una centralita telefnica, 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 caractersticas internas como buzn de voz, conferencias, IVRs, CDRs,

distribucin automtica de llamadas, parqueo, tranferencias, captura, musica en espera

Entre muchas otras funcionalidades.

Asterisk tambien soporta multiples protocolos y codecs.

56

Captulo 9


Asterisk soporta diferentes sealizaciones 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

Sealizacin Protocolos PRIE&M 4ESSE&M Wink BRI (ISDN4Linux)Feature Group D DMS100FXS EuroISDNFXO Lucent 5EGR-303 National ISDN2Loopstart NFASGroundstartKewlstartSoporte para MF y DTMFSealizacin Robbed-bit (RBS)MFC-R2 (a travs de parches de cdigo)

57

Captulo 9


Estructura de directorios de Asterisk

Mdulos de Asterisk Asterisk utiliza mdulos para extender su funcionalidad.

Estos mdulos residen en la carpeta /usr/lib/asterisk/modules/ (32 bits)

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

Son archivos con extensin .so

Es posible controlar estos mdulos desde el archivo modules.conf, en la carpeta

/etc/asterisk.

Este archivo controla cules mdulos se cargan o no (load, noload). Adems puede

controlar el orden en que se cargan con la opcin preload.

Por defecto en elastix se cargan todos los mdulos que estn 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 mdulo.

load => format_ogg_vorbis.so : Hace que se carge el mdulo.

preload => res_config_mysql.so : Hace que se carge primero ese mdulo

Directorio Descripcin/etc/asterisk archivos de configuracin de Asterisk/usr/lib/asterisk/modules/ mdulos 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 operacin 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

Captulo 9


DAHDI Dahdi es, bsicamente, un conjunto de drivers para controlar hardware telefnico,

principalmente tarjetas.

Estas tarjetas son como cualquier otra tarjeta de expansin de una computadora pueden

usar bahas PCI, puertos USB, etc.

Dahdi tiene su propio archivo de configuracin /etc/dahdi/system.conf

Historia del proyecto Zaptel En el ao 2000 Jim Dixon lanz el proyecto Zaptel bajo licencia GPL.

El nombre es una abreviacin de Zapata Telephony Project. Lo nombr as en honor a

Emiliano Zapata, hroe de la revolucin mexicana.

Inicialmente Zaptel contena 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.

Comunicacin Asterisk con DAHDI Asterisk interacta con dahdi mediante el modulo chan_dahdi.so, mismo que se controla

a travs del archivo chan_dahdi.conf.

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

son usados por asterisk.

59

Captulo 9


Archivos de configuracin 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 lgica del plan de marcado.

Pueden incluir otros contextos con la clasula 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 smbolos [ ].

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 configuracin paracanales DAHDI, se troncalizan loscanales.

60

Captulo 9


Dialplan: Extensiones Son lneas del plan de marcado.

Son instrucciones llamadas extensiones.

Tienen la siguiente sintaxis:

o exten => nombre_extensin, prioridad, aplicacin Una lnea del plan de marcado es una serie de lgica del plan de marcado.

Se puede crear la lgica necesaria para un marcado especfico.

Dialplan: Extensiones (Nombre_extensin) Es un identificador nmerico de la extensin.

Se lo puede asociar al nmero de telfono.

Existe una extensin particular s.

La extensin s significa cualquier extensin.

Esta extensin s se usa cuando el usuario que llama no ha presionado el nmero de

extensin. Por ejemplo, cuando est en el IVR de bienvenida.

Dialplan: Instrucciones (Prioridad) Indica el orden de ejecucin de una instruccin.

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 instruccin 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

programacin.

Permiten realizar acciones programadas en el plan de marcado.

Las aplicaciones permiten realizar ejecuciones entre contextos.

Pueden recibir parmetros para su ejecucin.

61

Captulo 9


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

programacin.

Son abstracciones que almacenan informacin 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 seccin [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 aplicacin) 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 informacin 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 parmetro 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 contina ejecutando el plan

de marcado.

o Aplicacin usada para reproducir el mensaje de IVR. Playback

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

62

Captulo 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 ejecucin del plan de marcado a un contexto, extensin o prioridad

indicada. Si se pasa un solo parmetro 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.

Lnea 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 informacin en tiempo real de la actividad de Asterisk.

Permite controlar el grado de detalle de la informacin, para ello se usan los comandos:

o Core set debug N o Core set verbose N

Mientras ms alto sea el nivel de las variables debug N y verbose N ms detallada ser la

informacin mostrada.

Estos comandos se deben utilizar para tareas de diagnstico.

63

Captulo 10


PLAN DE MARCADO AVANZADO

Manipulacin de Variables Sintaxis para eliminar dgitos

${VAR:x:y} Donde VAR es una variable numrica, x es el nmero de dgitos a

eliminar al principio y y es cuantos nmeros tendr la variable final

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

${VAR:x} Donde VAR es una variable numrica, x es el nmero de dgitos 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

expresin?destino1:destino2

Macros Sirven para reutilizar cdigos

Se definen como contextos anteponiendo el prefijo macro-

Ej. [macro-nombremacro]

Puede recibir parmetros cuando se llama al macro

El macro es llamado de la siguiente forma:

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

Los parmetros son invocados como:

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

64

Captulo 10


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

AstDB Pequea base de datos accesible desde el plan de marcado

Agrupa informacin 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 sern sobre escritos cuando FreePBX recargue su

configuracin

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

contextos y que stos no sean sobre escritos por FreePPX

65

Captulo 10


Macros de Apoyo

Contextos de Entrada Son los contextos desde donde se reciben llamadas

Conocimientos tiles Determinar si una variable esta vaca

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 extensin.conf.- Para sobreescribir un contexto definido se puede utilizar

el archivo: extensions_override_freepbx.conf

66

Captulo 11


ASTERISK: AGI & AMI AGI (Asterisk Gateway Interface) Es una manera de interactuar con Asterisk desde un programa de lnea de comandos

Este programa puede ser escrito en cualquier lenguaje

El programa AGI es invocado desde el dialplan

La salida estndar 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

Ejecucin de scripts AGI Los scripts AGI se comunican con Asterisk a travs de STDIN, STDOUT y STDERR

Por tanto, los scripts AGI se deberan poder ejecutar desde la lnea de comandos

Cuando son ejecutados a travs de Asterisk los permisos son muy importantes.

Para invocar al script desde el dialplan podemos utilizar la funcin AGI()

Se le pueden enviar parmetros al script utilizando la sintaxis:

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

Adicionalmente Asterisk le enva al script ciertos parmetros por omisin, que

veremos a continuacin

67

Captulo 11


Algunos parmetros enviados por omisin

A continuacin algunos de los ms 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 - Extensin

agi_accountcode Cdigo de cuenta, en caso de estar disponible

Algunos comandos AGI tiles say digits: Sintetiza y reproduce nmeros. 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 finalizacin del AGI

noop: Slo 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 pongmoslo accesible desde el dialplan cuando se marque el nmero 6789

68

Captulo 11


AMI (Asterisk Management Interface)

Es otra manera de controlar Asterisk pero a travs de la red IP. La comunicacin es de

tipo texto.

Se pueden desarrollar aplicaciones remotas

Un ejemplo es el mdulo de call center de Elastix, otro ejemplo es el FOP

El puerto AMI por omisin 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

Captulo 11


Luego probaremos autenticndonos:

Si los datos estuvieron correctos recibiremos un mensaje de xito

Recuerdan cual es la contrasea de AMI?

Tipos de paquetes AMI En la comunicacin por AMI se pueden identificar tres tipos de paquetes de

informacin.

Accin: Un comando enviado por el cliente al servicio AMI para que sea procesado

Respuesta: La respuesta de Asterisk a la Accin requerida por la aplicacin cliente

Evento: Se trata de informacin de un evento asincrnico ocurrido en Asterisk. Por

ejemplo, ingres una llamada telefnica

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

Accin. Asterisk devolver este parmetro en la respuesta.

Acciones AMI comunes Login: Nos permite autenticarnos con AMI

Logoff: Termina la sesin

Events: Controla el flujo de eventos

Originate: Inicia una llamada telefnica

Redirect: Transfiere una llamada

Hangup: Cuelga una llamada

Getvar: Obtiene una determinada variable de canal

70

Captulo 12


ELASTIX CONFIGURACIN AVANZADA

Ruteo de Llamadas Rutas Entrantes:

Esta opcin 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

Captulo 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 lgico que permite llevar una llamada a cualquier destino

externo.

Alguno de los tipos de troncales son:

DAHDI

IAX2

SIP

Custom

Troncal DAHDI Parmetros a configurar en una troncal DAHDI:

72

Captulo 12


Troncales de tipo IAX2 y SIP Adems de las configuraciones especificadas, se deben incluir configuraciones entrantes

y salientes

Esta informacin generalmente es especificada por el proveedor de servicios de voz.

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

Ejemplo de configuracin 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 estndares como

h323,misdn, etc.

Se debe especificar un string de marcado. Por ejemplo:

73

Captulo 12


Tarifacin La opcin Rates/Tarifas (Reports Billing Rates) nos permite visualizar y

configurar las tarifas que se usarn para la facturacin de llamadas.

Crear Tarifa

Para agregar una nueva tarifa dar clic en el botn Crear Nueva Tarifa. Se mostrar un

formulario en el que se ingresarn los siguientes campos:

Prefijo: Prefijo telefnico al cual se aplicar la tarifa.

Nombre: Nombre para la tarifa.

Tarifa: Valor de la tarifa por minuto.

Rate offset: Valor de interconexin.

Dgitos Ocultos: oculta los ltimos "n" dgitos del nmero en el reporte.

Troncal: Troncal asignada para la tarifa.

74

Captulo 12


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

Billing Billing Setup).

En este men podemos configurar adems 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 botn Editar, o eliminarla

haciendo clic en Eliminar

Reporte de Facturacin

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, Duracin, Rate value, Fuente,

Destino, Canal destino, Account Code.

75

Captulo 12


Distribucin de Destinos

Esta opcin (Reports Billing Destination distribution) nos permite ver una grfico

de distribucin de llamadas salientes agrupadas por tarifa.

El grfico cambiar dependiendo de los valores de filtro:

Fecha Inicio: Fecha que queremos iniciar la revisin de llamadas.

Fecha Fin: Fecha final para la revisin.

Criterios de distribucin: Distribucin por tiempo, distribucin por nmero de

llamadas, distribucin por costo.

Reportes: CDR CDR es la abreviacin para Registro de Detalle de Llamada (Reports CDR Reports).

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

76

Captulo 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 revisin de llamadas.

Fecha Fin: Fecha final para la revisin.

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 grfica el nmero de llamadas simultneas por canal.

77

Captulo 12


Configuracin DISA DISA permite que los usuarios puedan acceder telefnicamente a su servidor Elastix

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

E.g. podra realizar llamadas internacionales, a telfonos mviles, entre otros.

Nombre de DISA: El nombre referencial para este accedo DISA

PIN: La contrasea necesaria para acceder al soporte DISA.

Tiempo de espera para la respuesta: Mximo tiempo que la aplicacin esperar al

usuario por el PIN.

Tiempo de espera de marcado: Mximo tiempo entre dgitos.

Pedir confirmacin: Pregunta por una confirmacin antes del pedido de la contrasea.

Identificador de llamante: Todas las llamadas DISA usarn 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 caracterstica muy til para modificar el

comportamiento de la PBX dependiendo de la hora o del da de la semana.

EJEMPLOS:

78

Captulo 12


La compaa X desea que por las noches se reproduzca un mensaje indicando el

horario de atencin e indicando que en casos de urgencias se podran comunicar con

un nmero alterno.

La compaa Z desea reproducir un IVR de bienvenida distinto al habitual durante los

fines de semana ya que siempre lanza promociones durante estos das.

79

Captulo 13


INTERCONEXIN CON ELASTIX REMOTOS

A travs de troncales SIP Una de las ventajas de usar Elastix es que fcilmente 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 continuacin veremos como configurar la interconexin de dos Elastix mediante una

troncal de tipo SIP.

Escenario:

En el escenario mostrado a continuacin queremos interconectar la central A con la

central B de tal forma que el telfono A y el telfono 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

Captulo 13


Ejemplo de configuracin del peer:

Configuracin 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 debera ser:

y para la central Elastix B debera ser:

Una vez establecida esta configuracin en ambos servidores podemos verificar en si se

encuentran registradas las troncales.

En el Asterisk CLI mediante el comando: sip show registry y deberamos 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 configuracin es como sigue:

81

Captulo 13


Definiendo la ruta saliente

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

HaciaElastixB.

Luego definimos el patrn de marcado, en este caso usaremos el siguiente patrn 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

Slide Book Ece

Documents

Transcript of Slide Book Ece