You are on page 1of 82

Asterisk

Instalacin y configuracin

Prof: Julio Yupanqui V.


1
Introduccin a Asterisk.
Los equipos de telefona han sido desarrollos propietarios de marcas
grandes, por lo que el acceso a centrales telefnicas de bajo costo para las
empresas medianas y pequeas, van de la mano con las bajas
funcionalidades. Adicionalmente la convergencia de los servicios de telefona
sobre las redes de datos, dan como resultado la telefona IP, que no solo
nos permite beneficiarnos de sus bajos costos en comparacin con la
telefona tradicional, sino tambin de nuevas aplicaciones que permiten a las
compaas y a sus empleados trabajar con mayor eficiencia en beneficio de
sus clientes.

Ejemplo de centrales:

Asterisk aparece como la herramienta de cdigo abierto ideal para cubrir


estos requerimientos, no solo por el hecho de ser libre y gratuita, si no
tambin por ser altamente flexible ya que nos permite interactuar con
diferentes tecnologas. Telefona Tradicional, Telefona Digital, SIP,H23,
IAX2= y aplicaciones (Billing, CRMS, Software de Call Center, etc)

Prof: Julio Yupanqui V.


2
Asterisk es una aplicacin para controlar y gestionar comunicaciones de cualquier
tipo, ya sean analgicas, digitales o VoIP mediante todos los protocolos VoIP que
implementa.

Asterisk es una aplicacin OpenSource basada en licencia GPL y por lo tanto con
las ventajas que ello representa, lo que lo hace libre para desarrollar sistemas de
comunicaciones profesionales de gran calidad, seguridad y versatilidad.

CONCEPTOS BASICOS DE TELEFONIA


La telefona tradicional provee servicios de voz basados en la conmutacin de
circuitos.

La cual consiste en convertir la voz a un formato electrnico (analgico o digital) y


transportarla a travs de una red para comunicar a dos o ms personas.

Prof: Julio Yupanqui V.


3
La telefona est basada en la conmutacin de circuitos entre dispositivos
conocidos como centrales de conmutacin, las cuales permiten interconectar a dos
usuarios alejados geogrficamente utilizando un equipo terminal. (telfono).

Elementos de una red de telefona:

El equipo terminal. (un telfono)


La central de conmutacin. Que puede ser pblica o privada.
El bucle de abonado o usuario.
Las troncales de comunicacin.

Dependiendo de la red podemos tener 2 tipos :

La red pblica com la PSTN


La red privada com las redes conformadas por una o ms PBX.

Prof: Julio Yupanqui V.


4
LA PSTN

Red Telefnica Publica Conmutada es el conjunto de centrales telefnicas y


enlaces (troncales) que transportan la voz de los abonados distribuidos en una
rea geogrfica, optimizada para comunicaciones de voz en tiempo real.

Caractersticas de la PSTN

El bucle de abonado es generalmente analgico.


Los enlaces troncales son en su mayora digitales.
Conexin dplex.
Ancho de banda conmutado 64 kbps, 0 300-3,400 Hz para intercambios
analgicos.
Movilidad limitada.

Prof: Julio Yupanqui V.


5
LA PSTN
Los COs (Oficinas central) son centrales de conmutacin locales que interconectan
los telfonos en un rea especfica.

Entre los telfonos y la centra local (CO) la comunicacin es analgica a este


tramo se le conoce como bucle de abonado.

Entre las centrales la comunicacin se realiza a travs de las troncales, las cuales
generalmente son digitales. Se le conoce como red de transporte.

Prof: Julio Yupanqui V.


6
Troncales
Las troncales interconectan a las centrales telefnicas. Estas transportan la voz
entre los abonados de la central.

Las troncales pueden ser de dos tipos:

Analgicas
Digitales

Analgicas: Son centrales antiguas que utilizan sealizacin analgica (E&M,R2),


cada troncal est formada por un conjunto de cables (pares), de los cuales uno es
utilizado para la sealizacin y el otro para el transporte de la voz.

Digitales: utilizan estructuras multiplexadas que utilizan sealizacin (E1, T1) las
cuales estn formadas por centrales digitales que transportan voz y sealizacin.
Son ms eficientes que las troncales analgicas y permiten la implementacin de
aplicaciones de valor agregado.

Una central telefnica tipo PBX utiliza una lnea troncal para poder hacer de la
central parte de la red de otras centrales y mantener comunicaciones.
Generalmente las lneas troncales de los PBX son enlaces digitales E1 y T1 que
soportan hasta 30 canales (lneas) de voz para la intercomunicacin. Si se llegase
a interrumpir la comunicacin de la lnea troncal, no habra manera de establecer
comunicacin entre las centrales por ninguno de sus 30 canales.

Prof: Julio Yupanqui V.


7
BUCLE DE ABONADO

La unin entre el equipo terminal y la central telefnica utiliza un cable de cobre


de dos hilos.

La transmisin de la voz est en un rango de frecuencia entre:

300 3400 Hz.

Normalmente el bucle del abonado puede estar entre 5 y 7Km , para este calculo
se toma como referencia la resistencia del circuito.

La sealizacin controla el inicio y fin de cada llamada.

Prof: Julio Yupanqui V.


8
INTERFACES ANALOGICAS

FXS y FXO son los nombres de los puertos usados por las lneas telefnicas analgicas (tambin
denominados POTS - Servicio Telefnico Bsico y Antiguo)

FXS La interfaz de abonado externo es el puerto que efectivamente enva la lnea analgica al
abonado. En otras palabras, es el enchufe de la pared que enva tono de marcado, corriente para la
batera y tensin de llamada.

Por lo tanto a un FXS se le conectan telfonos analgicos tradiciones.

FXO Interfaz de central externa es el puerto que recibe la lnea analgica. Es un enchufe del telfono
o aparato de fax, o el enchufe de su centralita telefnica analgica. Enva una indicacin de
colgado/descolgado (cierre de bucle). Como el puerto FXO est adjunto a un dispositivo, tal como un
fax o telfono, el dispositivo a menudo se denomina dispositivo FXO.

Por lo tanto aqu se conectan las lneas analgicas de las COs tradicionales y los puertos de las
extensiones de PBXs.

Prof: Julio Yupanqui V.


9
FXS/FXO

Los GATEWAY nos permiten conectar telfonos convencionales y conectarlos a la


red de telefona ip.

Prof: Julio Yupanqui V.


10
FXS/FXO

Prof: Julio Yupanqui V.


11
LA PBX PRIVATE BOX EXCHANGE

PBX son las siglas en ingls de Private Branch Exchange, la cual es la red telefnica
privada que es utilizada dentro de una empresa. Los usuarios del sistema telefnico PBX
comparten un nmero definido de lneas telefnicas para poder realizar llamadas externas.

El sistema PBX conecta las extensiones internas dentro de una empresa y al mismo tiempo
las conecta con la red pblica conmutada, conocida tambin como PSTN (public switched
telephone network).

Una de las tendencias ms recientes en telefona es la telefona computarizada, paralelo al


desarrollo de sistemas telefnicos que transmiten la voz por medio de la red de internet.
Estos llevan el nombre de VoIP PBX IP PBX.

El procesador se encarga de establecer la direccin que puede tomar una llamada, la


mejor ruta para la conexin, la facturacin, etc.

Estas pueden usar diferentes interfaces para comunicarse con la PSTN.

FXO
E1,T1
E&M

Prof: Julio Yupanqui V.


12
FUNCIONALIDADES DE LA PBX
1. Funcionalidades de una PBX.

Transferencia de llamada
Conferencias
Captura de Llamadas
Llamada en espera
Servicio Diurno y Nocturno
Clases de Servicio
IVR
Interfaces con porteros y telfonos de puerta
NO Molestar
Desvos de llamadas
Grupos de hunting (Ejemplo: los grupos de timbrado)
Re llamada sobre interno ocupado
Etc.

Prof: Julio Yupanqui V.


13
Telefona IP
Conceptos de telefona IP

Prof: Julio Yupanqui V.


14
TELEFONA IP

La Telefona IP es una solucin tecnolgica que sirve para transmitir


comunicaciones de voz sobre una red de datos basada en el estndar IP.
Con la solucin de Telefona IP, la organizacin reduce costos integrando
sus aplicaciones de voz y datos sobre una nica plataforma de Red. Esta
solucin permite elevar la productividad, reducir costos operativos de la
empresa mediante la convergencia de las comunicaciones; adems de
escalar las soluciones de acuerdo a las necesidades de las empresas, las
cuales pueden ser corporativas, medianas o pequeas.

El concepto de telefona ip es ms ampli ya que implica la interconexin


con otras redes de telefona: PSTN, GSM, etc. Generalmente nos referimos
a este concepto cuando hablamos de VOIP.

Como la voz viaja por una red de conmutacin, se debe tener en cuenta que
esta debe cumplir requisitos necesarios sin que se deteriore la
comunicacin. Para esto debemos asegurar una calidad de servicio,
trabajando con retardos pequeos, dispositivos que administren el trfico de
voz eficientemente. (jitter retardo).

Prof: Julio Yupanqui V.


15
Una red de telefona ip, transporta la voz de los usuarios a travs de una red
de datos , utilizando equipos diversos como:

Terminales de voz: Telfonos ip por hardware, softphones, vide telfonos,


etc.

Gateway de voz: Son dispositivos que actan como interfaces entre


diferente grupo de redes permitiendo integrar la red de telefona ip con
otras redes, como la PSTN.

ATA: Dispositivos que permiten conectar telfonos analgicos a la red de


datos.

Call managers: Se encargan de administrar la comunicaciones entre


dispositivos terminales. Pueden almacenar informacin sobre la facturacin,
despliegan servicios de valos agregado.

Estos dispositivos usan diferentes interfaces:

FXS/FXO

E1

E&M

Prof: Julio Yupanqui V.


16
Protocolos

Los protocolos de sealizacin son utilizados para establecer la conexin,


ubicar al destino, identificar la llamada, desconexin, etc.

La telefona hace uso de los protocolos para mantener la sesin, finalizar y


administrar la comunicacin de voz.

Los ms utilizados son:

SIP: (Sesion initiation Protocol). Protocolo de inicio de sesin es un protocolo


ligero ampliamente utilizado actualmente es aplicaciones de telefona IP y
otros.

H323. Estndar de telefona ip bastante pesado, comprende a su vez una


seria de protocolos

MGCP. (media gateway Control Protocol)

Prof: Julio Yupanqui V.


17
CODECS:
Nos dan la posibilidad de utilizar menos ancho de banda por canal de voz.
Permitindonos pasar ms canales de voz. (Llamadas) por la red:

Entre los ms utilizados tenemos:

G.711 (ulaw/alaw) 64 Kbps :

Algoritmos:

u-law Norteamerica / JAPON

a-law Europa y el resto del mundo

G.726 32 Kbps. Alcanza tasas de transmisin: 16,24,32 y 40 Kbps

G.729 --- 8 Kbps (Necesita licencia). Su calidad es parecida a la del G726

GSM 13 Kbps. - Codec usado para la telefona celular.

Prof: Julio Yupanqui V.


18
MOS,
Mean Opinion Score (Calidad de experiencia)
Una unidad de medida referente a la calidad del habla humana en sistemas de
telefona VoIP, representada con un porcentaje. MOS es calculada tomando el
promedio numrico entre puntajes dados por un jurado utilizndolo como un
indicador para medir la calidad de un sistema.

MOS CALIDAD DEFICIENCIA


5 Excelente Imperceptible
4 Buena Perceptible pero no incomoda
3 Pasable Incomoda mnimamente
2 Pobre Incomoda
1 Mala Incomoda bastante

El Resultado obtenido para algunos codecs:

CODEC Ancho de banda RESULTADO


(kbps)
G.711 64 4.19
G.726 32 3.85
G.729 8 3.92
GSM 12.2 3.5

Prof: Julio Yupanqui V.


19
ARQUITECTURA DE ASTERISK

Historia de Asterisk

Asterisk fue creada en 1999 por Mark Spencer de la empresa Digium y donada
a la comunidad con licencia libre tras lo cual se han recibido muchas
colaboraciones y mejoras por parte de muchos desarrolladores libres y empresas
sin solicitar nada a cambio.

Poco a poco, esta aplicacin se ha convertido en la evolucin de las tradicionales


centralitas analgicas y digitales permitiendo tambin integracin con la tecnologa
ms actual: VoIP. Asterisk se convierte as en el mejor, ms completo, avanzado y
econmico sistema de comunicaciones existente en la actualidad.

Otro aliciente es su capacidad de ser programada, permitiendo realizar labores que


hasta el da de hoy lo llevaban realizando sistemas extremadamente costosos y
complicados y, gracias a Asterisk, esta misma labor se realiza de una forma ms
econmica lo que fomenta el uso de sistemas libres como Linux y estndares
abiertos como SIP, H323 o IAX.

Una de las ventajas ms interesantes es su posibilidad como sistema hbrido, ya


que permite gestionar comunicaciones telefnicas tradicionales (analgicas,
digitales, mviles, ...) como comunicaciones IP mediante el uso de los protocolos
estandar de VoIP.

Prof: Julio Yupanqui V.


20
ASTERISK

Asterisk es un programa de software libre (bajo licencia GPL) que proporciona


funcionalidades de una central telefnica (PBX). Como cualquier PBX, se puede
conectar un nmero determinado de telfonos para hacer llamadas entre s e
incluso conectar a un proveedor de VoIP o bien a una RDSI tanto bsicos como
primarios.

Asterisk es una plataforma de comunicaciones convergentes diseada para aceptar


diferentes tipos de hardware para telefona ip, telefona analgica, y software que
interacte entre ellos de forma consistente.

Existen versiones de Asterisk para MAC y Windows.

Versiones
Asterisk LibPri Zaptel DAHDI
1.8 1.8.4.3 1.4.11.5 n/a 2.4.1.2
1.6.2 1.6.2.18 1.4.11.5 n/a 2.4.1.2
1.4 1.4.41 1.4.11.5 1.4.12.1 2.4.1.2
1.2 1.2.31 1.2.8 1.2.27 n/a

Todas estas versiones se pueden descargar desde:


http://downloads.digium.com/pub/

Prof: Julio Yupanqui V.


21
ASTERISK

TELEFONA IP: SIP, IAX, H323

CODECS: G711.G729, GSM

Telefona IP: Asterisk utiliza protocolos y estndares de la telefona IP,


puede integrarse a una red LAN y administrar telfonos ip en hardware o
software. Se requiere una tarjeta de red.

Telefona Tradicional: Para interactuar con la telefona tradicional ,


requiere tarjetas FXS para telfonos analgicos, FXO para lneas analgicas,
E1 para lneas digitales.

Prof: Julio Yupanqui V.


22
HARDWARE DE ASTERISK
TDM400P -Analgica
4 INTERFACES FXS/FXO
LOS MODULOS DE PUEDEN
INTERCAMBIAR

Tarjeta Digium TE121 1E14


Tarjeta Digital

TDM400P: ESTAS ESTAN DESTINADAS A OFICINAS PEQUEAS , A las


cuales se les puede instalar interfaces FXO/FXS.

TE121 1E14: La tarjeta TE121 PCI Express de Digium suministra hasta 30


canales de voz o datos a travs de una interfaces E1, T1 o J1 sobre una
tarjeta "PCIe x1 form factor.

Prof: Julio Yupanqui V.


23
IMPLEMENTACIONES

Prof: Julio Yupanqui V.


24
IMPLEMENTACIONES

Prof: Julio Yupanqui V.


25
ARQUITECTURA

Su arquitectura es bastante simple, Asterisk acta como un middleware


entre las tecnologas de telefona en la parte inferior y las aplicaciones de
telefona en la parte superior, siendo Asterisk quien proporciona las
interfaces para que ambos interacten, creando un entorno consistente para
desplegar soluciones heterogneas.

Prof: Julio Yupanqui V.


26
CANALES
Es equivalente a un circuito de voz digital. Puede ser una lnea analgica o
un circuito digital. (Ejmplo: GSM, SIP)

API de Canales: Los apis de canales controlan las llamadas del sistema, sean
voz IP, llamadas analgicas , o de cualquier otra tecnologa; pudiendo
desarrollar nuevos canales.

Las aplicaciones interactan con los archivos, codecs, y canales a travs de APIS, Asterisk
posee 4 APIS:
API DE CANALES
API DE CODECS
API DE FORMATO DE ARCHIVOS
API DE APLICACIONES

El Api de Canales le permite a Asterisk interactuar con canales diferentes tanto TDM como de
TDM, VoIP,
Canales para la red Pblica:
chan_dahdi: Digium Dahdi (tarjetas analgicas)
system.conf : tarjetas Digitales

Canales para VoIP:


sip.conf : para utilizar SIP.
Iax.conf : Para utilizar iax2
h323.conf: para utilizar h323

Prof: Julio Yupanqui V.


27
API DE TRADUCCION DE CODEC:
Controla la traduccin de CODECs entre participantes de una comunicacin.

G.711 -> (ulaw/alaw) 64 Kbps :

Algoritmos:

u-law Norteamerica / JAPON

a-law Europa y el resto del mundo

G.726 ->32 Kbps. Alcanza tasas de transmisin: 16,24,32 y 40 Kbps

G.729 -> 8 Kbps (Necesita licencia). Su calidad es parecida a la del G726

GSM -> 13 Kbps. - Codec usado para la telefona celular.

Prof: Julio Yupanqui V.


28
ARQUITECTURA

APLICACIONES: Para que asterisk pueda conectar llamadas de entrada o


salida, utilizar el buzn de voz, conferencia, etc. Necesita ejecutar aplicaciones.

API de Aplicaciones: Se han desarrollado muchas aplicaciones de IVR,


Multiconferencia, etc. Teniendo la posibilidad de desarrollar nuevas mediante
AGI, utilizando lenguajes como C, C++, php, java,etc.

Prof: Julio Yupanqui V.


29
ARQUITECTURA

ARCHIVOS:

Asterisk soporta algunos tipos de archivos que utiliza para reproducir audio como:
mp3,wav,gsm,etc.

API de formato de ficheros: permite al sistema controlar diferentes formatos de


archivos.

Prof: Julio Yupanqui V.


30
INSTALACION DE ASTERISK

Requisitos de Software.

La instalacin de asterisk sobre LINUX requiere de los siguientes paquetes


instalados:

Kernel (Fuestes y cabeceras)


gcc
ncurses (para el uso del CLI).
bison para los archivos de configuracin.

La instalacin del asterisk se compone de los siguientes elementos:


El programa principal de asterisk.(Instalar solo si se va usar VoIP pura).

Drivers DAHDI (anteriormente zaptel)- drivers para las tarjetas. Analgicas o digitales

Libreras para PRI (libpri). Libreras para las tarj. Usarla cuando tenga interfaces ISDN PRI, esto
ahorra memoria RAM.

NOTA: Es recomendable instalas los tres paquetes para activar los modulos que se van
necesitando segn sea el escenario

Prof: Julio Yupanqui V.


31
Pasos iniciales para la instalacin

Obtener de la direccin:

http://www.asterisk.org/downloads

los paquetes:
asterisk
asterisk-addons
asterisk-sounds
dahdi
libpri

Estos paquetes descargaran en formato tar.gz los cuales debern ser desempaquetados en:

/usr/src/

#tar xvzf libpri

#tar xvzf dahdi

#tar xvzf asterisk

#tar xvzf asterisk-addons (ofrece soporte mysql par alas CDR y soporte mp3 para MOH (music on
Hold)

Prof: Julio Yupanqui V.


32
1. Instalacin del librpi

Ingresamos a: /usr/src, luego ejecutamos lo siguiente:

#make clean

#make

#make install

2. Instalacin de DAHDI
#make clean
#./configure
#make
#make install
#make

3. Instalacin del asterisk


#make
#make clean
#make install
#make samples
#make config

4. Instalacin del asterisk-addons


#./configure
#make
#make install

#make samples : Instala los archivos de configuracin por defecto. Despues de instalar asterisk si
se vuelve a ejecutar make samples borrara la configuracin anterior.

#make config.- instala los script de arranque , esta linea define el autoinicio del programa durante
la carga del sistema operative.

#make clean no es necesario la primera vez que compilamos los drivers, pero es necesario cuando
se recompila los drivers, asi nos aseguramos que se eliminaran los archivos de configuracin y
binarios anteriores.

Prof: Julio Yupanqui V.


33
Iniciando Asterisk

Para iniciar Asterisk :

#service Asterisk start

#asterisk -rvvvvv

El cual inicia a asterisk y lo pasa al modo comando.

-v Verbosity: La usamos para determinar la cantidad de informacin de


debugging que deseamos revicibir desde la interfase de comandos, a mas v
ms informacin.

-r remote: Lo usamos cuando Asterisk se est ejecutando , y queremos


entrar en el modo comando.

-x: en combinacin con -r ejecuta el comando especificado sin conectarse a


la interface de comandos.

Prof: Julio Yupanqui V.


34
Directorios de instalacin:

/etc/asterisk Archivos de configuracin de


asterisk, con excepcin del dahdi
/etc/dahdi Archivos de configuracin de
dahdi
/usr/lib/asterisk/modules Contiene los mdulos que asterisk
puede cargar: aplicaciones,
codecs, canales y formatos
Estos se cargan
usando:/etc/asterisk/modules.conf
/var/spool/asterisk Contiene:
Voicemail: aqui se graban los
correos de voz
Meetme: aqu se guardan las
grabaciones de la sala de
conferencias.
Monitor: aqu se guardan las
llamadas monitoreadas.
Sounds: aqu se guardan los
archivos de sonido
/usr/sbin
/usr/lib/asterisk
/usr/include/asterisk
/var/lib/asterisk/agi-bin
/var/lib/asterisk/astdb
/var/lib/asterisk/images
/var/lib/asterisk/keys
/var/lib/asterisk/mohmp3
/var/run/asterisk.pid
/var/run/asterisk/ctl

Prof: Julio Yupanqui V.


35
CONFIGURACION DE LOS TELEFONOS IP

Prof: Julio Yupanqui V.


36
FUNCIONES DE LA PBX

Estas es una central privada de una compaa u oficina que se encarga de administrar las llamadas
entre las extensiones conectadas a ella, asi como las lneas telefnicas de entrada y salida.

Funciones:

Administra las llamadas entre dos o mas usuarios.(Llamadas internas o externas)

O funciones avanzada:

Marcador automtico.
Contestador automatico
Distribuidor automatico de trafico de llamadas
Cuentas con codigos para registrar llamadas
Desvio de llamadas.
Transferencias de llamadas
Llamada en espera
Conferencia entre tres o mas usuarios
Mensaje de bienvenida
Marcado de una extensin desde el exterior del sistema
NO molestar
Musica en espera
Servicio de modo nocturno /hora almuerzo
Reporte de llamadas CDR

Prof: Julio Yupanqui V.


37
CANALES:

Esta es una conexin producto de una llamada en la central.

Tipos:

DAHDI: canal que conecta lneas telefnicas ordinarias

SIP: canales que conectan a dispositivos SIP

IAX: canales que conectan a dispositivos IAX

H323: canales que conectan a dispositivos H323

Skinny: canales que conectan dispositivos cisco utilizando el protocolo skinny

Si usted quiere identificar el tipo de canal empleado :

#sip show channels

Prof: Julio Yupanqui V.


38
Nomenclatura de canales:
Para nombrar un canal en el (extensions.conf), usamos el siguiente formato:

DAHDI/2

SIP/4001

IAX/iax-server-remoto

Canales SIP: Se genera cuando un dispositivo SIP recibe una comunicacin:

Salida:

SIP/[<exten>@] <peer>[:<puertono>]

exten: Pregunta por la extensin a la que nos conectaremos

peer: es el nombre del punto a donde nos vamos a conectar. Puede ser un nombre o una ip.

Puertono: es el puerto que recibe la comunicacin.(por defecto es el puerto 5060)

Ejemplos:

SIP/3001@jyupanqui:5060
SIP/jyupanqui@172.17.0.50:5060
SIP/2001

Entrada:

Por ejemplo cuando se integra con una central remota que ofrece bolsa de minutos.

SIP/<peer>-<id>

Peer Es el nombre del servidor remote

Id es el identificador remoto

Ejemplo:

SIP/172.17.3.100-02FB43D6

Prof: Julio Yupanqui V.


39
PROTOCOLO SIP

Este es un protocolo punto a punto, implementado como cliente servidor. Est basado en los
protocolos HTTP y SMTP. Usado originalmente para establecer y terminar las sesiones
multimedia en la internet.

Sesiones como: voz, video, chat, juegos interactivos.

SIP es un protocolo simple de sealizacin y su propsito principal es mantener la comunicacin


entre puntos remotos, pero no manejar voz.

Para el envi de voz se utiliza el protocolo RTP, el cual la enva directamente entre dos puntos.

Los puntos remotos son los user agents, los cuales pueden ser de dos tipos: clientes o servidores:

User agent cliente: es el punto que genera la comunicacin.

User agent server: es el punto que procesa los requerimientos y genera una respuesta.

Prof: Julio Yupanqui V.


40
REGISTRO SIP

Todos los clientes antes de poder iniciar una llamada debern registrarse
primero. Este proceso consiste en asociar un nombre de la cuenta sip con el
numero ip del dispositivo conectado.

Prof: Julio Yupanqui V.


41
Modulo SIP
El modulo SIP permite a asterisk comunicarse via VoIP con otros dispositivos
SIP.

Asterisk puede actuar como:

Cliente SIP: Cuando se conecta a otro proveedor SIP/Bolsa de minutos

Servidor SIP: Registra las sesiones de los clientes SIP

Gateway: En este modo asterisk trabaja como intermediario entre


diferentes protocolos: IAX,SIP,H323, o entre la PSTN,etc.

Prof: Julio Yupanqui V.


42
Configuracin de las cuentas SIP:
#vi /etc/asterisk/sip.conf

[general]

bindport=5060

bindaddr=0.0.0.0

context=local

language=es

disallow=all

allow=all

[general] aqu se ingresan los parmetros genricos. Estos se tomaran por


defecto, a menos que ellas especifiquen un valor distinto.

bindport= aqui se especifica el Puerto de escucha par alas comunicaciones


sip.

bindaddr= aqu se especifica de que direcciones se escucharan peticiones


SIP.

context= el context al cual pertenecern los dispositivos por defecto.

language= lenguaje por defecto para ser usado por las aplicaciones
PlayBack y Background.

disallow= Deshabilita los codecs de la configuracin global

allow= habilita los codecs.

Prof: Julio Yupanqui V.


43
Configuracin de una cuenta SIP.

[4001]

type=friend

secret=sistemas

nat=no

host=dynamic

disallow=all

allow=ulaw

allow=gsm

context=local

[xxxx].- aqu se especifica el nmero de anexo.

type= peer/user/friend. Indicamos el tipo de dispositivo que vamos a


conectar:

Peer. Solo recibe llamadas


User. Permite solo hacer llamadas
Friend. Permite hacer y recibir llamadas.

secret= contrasea del cliente usada para registrarse en el servidor.

nat= yes/no Deber configurarse cuando el cliente esta atrs de un servidor.


(NAT).

host= dynamic/hostname/IPaddr. Determina como encontramos al


dispositivo SIP. Para que se registre automticamente utilizar Dynamic.

Prof: Julio Yupanqui V.


44
context= determina el context que usara para las llamadas entrantes y
salientes. Si no se coloca usara el contesto definido en general.

Otros parmetros para la configuracin SIP.

carentive=yes (para hacer transcodificacion). Permite hacer pasar paquetes


RTP, directamente entre los nodos de la comunicacin.

Prof: Julio Yupanqui V.


45
Instalando un softPhone
X-lite:

La versin libre maneja dos lneas.

Mute

Redial

Videoconferencia

G711,GSM

Display name= Es el nombre que se


mostrara en la pantalla del telfono

User name= es el nombre del


usuario definido en asterisk

password= clave definida en asterisk


(secret)

domain= dominio de pertenencia

sip proxy= ip del servidor asterisk

Prof: Julio Yupanqui V.


46
Testeando al configuracin
CLI> sip show peers

Muestra una relacin de los dispositivos logueados.

CLI> sip show peer 2000

Muestra la informacin especfica de un dispositivo SIP.

Prof: Julio Yupanqui V.


47
PLAN DE DISCADO
Aqu se define como se manejaran las llamadas entrantes, salientes y
locales.

Un plan est compuesto de:

Contextos
Extensiones
Prioridades
Aplicaciones

Contextos: El plan de discado est dividido en secciones llamadas


contextos.

El uso de contextos permite implementar:


Seguridad, permite implementar llamadas solo a ciertos telfonos.
Mens con multiples niveles.
Rutear llamadas
Autenticacion.
Horario diurno y nocturno.

Prof: Julio Yupanqui V.


48
Plan de discado.
Extensiones: es una lista de instrucciones que asterisk ejecuta disparadas
por una llamada entrante.

exten=> extensin,prioridad, aplicacin()

ejemplo:

exten=> 2000,1,answer

APLICACIONES
Answer Contesta el canal al que esta
llamando
Dial Marca un canal especifico
Hangup Cuelga un canal que esta activo
Playback Toca un archivo de sonido
Background Toca un archivo de sonido mientras
se puede seguir interactuando en el
plan
wait Espera un tiempo determinado

Dial Intenta establecer una conexin con un canal y


lo enlaza con el canal que inicia la llamada.
Dial(type/identifier,Timeout,Options,url)
Type/idendifier- indica el canal
Ejemplo: SIP/2001, IAX2/SALIDA1,
DAHDI/1

Timeout- indica el tiempo en


segundos que timbrara el canal,
antes de pasar a la siguiente
prioridad.
Options:
t: Permite al usuario llamada ,
transferir una llamada
T: permite al usuario llamante
transferiri una llamada.
r: genera un tono de timbrado
m:provee music on hold

Prof: Julio Yupanqui V.


49
Ejemplo de un plan de discado

[entrada]
exten=> 1001,1,Answer()
exten=> 1001,2,playback(bienvenidos.wav)
exten=> 1001,3,hangup()

exten=> 1002,1,Dial(SIP/1002,10)
exten=> 1002,3,Hangup()

Prof: Julio Yupanqui V.


50
Protocolo IAX
IAX (Inter - Asterisk eXchange protocol) es un protocolo propietario,
desarrollado por Mark Spencer (creador de Asterisk), Brian Capouch, Ed Guy y
Frank Miller. La versin ms reciente es la 2 y por ello lo encontramos ms
comnmente como IAX2. Aunque surgi como un proyecto privado, desde
febrero del 2010 figura ya dentro de los RFCs bajo el nmero 5456 con el
carcter de informativo y en el mismo documento se aclara que tal publicacin,
se hace a discrecin del editor y que de ninguna manera IAX2 es candidato a
convertirse en estndar de la IETF.

IAX2 representa una alternativa frente a los protocolos ms difundidos en el


mercado VoIP como SIP y H.323. IAX2 posee algunas ventajas y desventajas.

Prof: Julio Yupanqui V.


51
PROTOCOLO IAX2

PUERTO: 4569

IAX es un protocolo para medios y sealizacin peer to peer


su sealizacin es parecida al sip.

Prof: Julio Yupanqui V.


52
Nomenclatura de canales IAX2

La sintaxis de los canales IAX es la siguiente:

Canales de salida:

IAX/[<user>[:<secret>]@]<peer>[:<portno>][/<exten>[@<context
>][/options]]

Ejemplo:

exten=> 4001,1,dial(IAX2/iax-server-A/2001,20)

user= usuario

secret = password

peer+ es el host al que vamos a conectar

portno= es el nmero de puerto a l que nos vamos a conectar.

exten=es la extensin que se est solicitando comunicar.

context= ex el contexto de la extensin.

Option. Opciones de conexin.

Prof: Julio Yupanqui V.


53
Interconectando 2 ASTERIK

La interconexin de dos asterisk , se puede llevar acabo utilizando sip


o IAX2.

La ventaja del IAX2 radica en que utilizando el modo


trunking es posible enviar varias conversaciones de voz
utilizando una sola cabecera.

Prof: Julio Yupanqui V.


54
Interconectando 2 Asterisk

El archivo iax2.conf esta formado por secciones, el cual tiene la


siguiente configuracin:

[general]
bindport=4569
bindaddr=172.17.3.20
bandwidth=low
jitterbuffer=yes

bindport= nmero de Puerto de escucha:4569

bindaddr= la ip de escucha , por defecto se coloca la direccin ip


local.

bandwidth= low/mdium/high. Con esta opcin se controlan los


codecs que sern utilizados , dependiendo del ancho de banda del
enlace.

jitterbuffer= yes/no. Activa o desactiva el buffer para controlar el


jitter, el buffer s utilizado para maximizar la calidad balanceando la
latencia con el nmero de paquetes eliminados.

register= es utilizado para q el servidor local asterisk se registre en


otro servidor asterisk. Esto es necesario generalmente cuando el
servidor local tiene configurada una IP dinmica.

Prof: Julio Yupanqui V.


55
Interconectando 2 Asterisk

Configurando las entidades

[arequipa]
type=friend
host=dynamic
trunk=yes
secret=sistemas
context=entrada
deny=0.0.0.0/0.0.0.0
permit=172.17.3.200/255.255.252.0

permit = permite llamadas entrantes a una direccion ip de red.

Denny= niega las llamadas entrantes a la ip o red.

Trunk yes/no si esta puesto en yes IAX2 ser utilizado en modo


trunking.

Prof: Julio Yupanqui V.


56
Configurando el plan de discado:

[topiura]

exten=4001,1,dial(iax2/piura/${exten})

una vez configurado

CLI>reload

compruebe los canales iax

CLI> iax show peers

CLI> iax show channels.

Prof: Julio Yupanqui V.


57
Configuracion de Telefonos Analogicos

Introduccion: Actualmente la telefonia convencional es parte de


hogares y oficinas, por consiguiente veremos la integracion de la
telefonia ip y la telefonia convencional.

Prof: Julio Yupanqui V.


58
LAS INTERFASES FXS/FXO

La FXS: Foreigh Exchange suscriber. Esta interface analgica provee,


la batera, la corriente de timbrado y el tono de timbrado.

Por lo tanto aqu se conectan telfonos analgicos.

FXO: Foreigh Exchange Office, esta interface, recibe la corriente de


timbrado. Actua como si fuera un telfono analgico.

Por lo tanto aqu se conectan las lneas analgicas de los COS


y los puertos de las extensiones de PBX.

Prof: Julio Yupanqui V.


59
Configurando la Tarjeta DIGIUM TDM- analgica

Esta tarjeta soporta hasta 4 modulos donde se pueden colocar


interfaces fxs o fxo.

Estn disponibles hasta 24 puertos. Y requieren energa


externa, mediante un conector standard de 4 pines.

El modulo s110m es de color verde provee senalizacion FXS

El modulo x100m de color rojo provee un puerto de


sealizacin FXO

Prof: Julio Yupanqui V.


60
system.conf

se ubica en la carpeta /etc/dahdi. Aqu se configura el


hardware dahdi como es el de las tarjetas TDM400p

La configuracin que se establece aqu es:

-Un numero asignado como identificador a cada interface tdm.

El tipo de senalizacion.

El lenguaje que ser utilizado para los tonos de l atarjeta,

Aqu se asume que tenemos una tarjeta con dos modulos FXS en los
canales 1 y 2; 2 dos modulos en los canales FXO en los canales 3 y 4.
El archivo de configuracin system.conf quedara:

fxoks=1,2
fxsks=3,4
loadzone= fr
defaultzone = fr (el tipo de sealizacin la define el proveedor.
Per se basa en el standard europeo).

fxoks=1,2 Esto indica que se utilizara la sealizacin FXO en


fos canales 1 y 2.

fxsks=3,4 Esto indica que se utilizara sealizacin FXO en los


canales 3 y 4.

Prof: Julio Yupanqui V.


61
Aparentemente parece haber un error en la configuracin de la
sealizacin de los canales, lo que ocurre es que asterisk se comunica
con una interface utilizando el tipo de sealizacin inversa; es decir si
tenemos un canal FXO internamente asterisk se comunicara con una
interface FXS.

loadzone = fr Indica que se cargaran tonos de indicacin franceses.


Las zonas posibles son: usa u fr nl uk fi es jp no at nz it us-old gr tw cl
se be s gil br hui t pl za pt ee mx in de ch dk cz cn ve ph.

Los tonos son definidos en el archivo: zonedata.c

Defaulzone=fr indica que tonos sern utilizados por defecto si es que


no se especifica una zona por defecto.

Prof: Julio Yupanqui V.


62
chan_dahdi.conf (/etc/asterisk/)

Configurando y cargando el modulo dahdi, y lo dejaremos disponibl


para que cualquier aplicacin haga uso de el.

Aqu se configuran los canales de la tarjeta digium y como sern


utilizados por asterisk.

Prof: Julio Yupanqui V.


63
Ejemplo del archivo chan_dahdi.conf

[channels]
usecallerid=yes
hidecallerid=yes
callwaiting=yes
threewaycalling=yes
transfer=yes
echocancel=yes
echocancelwhenbridged=yes
rxgain=0.0
txgain=0.0

usercallerid = Esta opcion causa que el callerID sea enviado al


telefono cuando esta tiembrando, en caso de troncales hace que
asterisk busque el caller ide en las llamadas entrantes.

hidecallerid = En interfaces FXS causa qu asterisk no envie el caller


ID cuando se realiza una llamada. En interfaces PRI detiene el envio
del caller ID en las llamadas de salida.

callwaiting = si esta habilitada asterisk genera bips de llamada en


espera durante una conversacin cuando otra llamada trata d ingresar
al canal que ya esta hablando.

threewaycalling = si esta habilitada es posible poner una llamada en


espera presionando el botn FLASH, y recibir un nuevo tono de
marcar para hacer una llamada.

transfer = Esta opcin solo tiene efecto si el threewaycalling=yes, en


ese caso es posible poner la llamada en espera y hacer una
transferencia llamando al otro telfono y luego colgando.

echocancel = habilita o desactiva la cancelacin de echo.

Prof: Julio Yupanqui V.


64
echocancelswhenbridged = activa o desactiva la cancelacin d eco
durante una llamada en puente TDM.

rxgain = ajusta la ganancia de recepcin, esto sirve para aumentar o


disminuir el volumen de la seal de ingeres para compensar las
diferencias de hardware.

txgain = ajusta la ganancia de recepcin, esto sirve para aumentar o


disminuir el volumen de la seal de salida para compensar las
diferencias de hardware.

Prof: Julio Yupanqui V.


65
Ejemplo:

group 1
signalling = fxo_fxs
Language = en
Context = ventas
channel => 1

signalling = fxo_ks
language = fr
context = operaciones
channels => 2

signalling = indica el tipo de senalizacion , se cumple lo mismo que en


archivo system.conf

language = en indica el lenguaje que se utilizara en ese canal.

context = es el contexto donde se ejecuta el canal.

channel => 1 crea el canal 1 con las opciones indicadas en la parte


superior.

Prof: Julio Yupanqui V.


66
Implementando el plan de discado

La sintaxis para nombrar canales DHDI es la sig:

Canales de salida:
dahdi/[g] ,identifier.[c][r<cadense.]

Ejemplo:
zap/1
zap/g1
dahdi/1
dahdi/g1

[g] <identifier> es el identificado numrico del canal fsico, si este


identificador esta precedido por g entonces se interpreta como el
nmero de grupo.

[c] esta opcin requiere una confirmacin de respuesta, es decir el


canal no se considerara respondido si no se presiona la tecla #

[r] <cadense>esta combinacion indica que se utilizara un timbrado


distintivo representado por <cadense> que toma valores de 1 a 4.

Ejemplos>

Dahdi/1. Canal TDM 1.

Dahdi/g1. El primer canal disponible en el grupo 1

Dahdi/3r2 canal TDM 3 en el segundo timbre distintivo.

Dahdi/g2c. el primer canal disponible del grupo 2 con confirmacin de


rrpta.

Prof: Julio Yupanqui V.


67
Plan de discado

La configuracin de un plan de discado para los canales dahdi FXS 1 y


2 es la siguiente:

[local]

exten => 2001,1,dial(dahdi/1,20,trT)

exten => 2001,2,hangup()

exten => 2002,1,dial(dahdi/2,20,rtT)

exten => 2002,2,hangup()

Prof: Julio Yupanqui V.


68
Aplicaciones

Record = graba la voz que ingresa a un canal.

La sintaxis es la siguiente:

Record(filename.format[|silence][|mxduration][|option]

File.format es el nombre del archive que se desea guarder y format esl


format. El archivo guardado se almacena en /var/lib/asterisk/sounds

Si el nombre contiene %d entonces cada vez que se grabe se le


agregara un numero auto incremental al final del nombre del archivo.

silence. Indica los segundos de silencio se debern esperar antes de


detener la grabacin.

maxduration es el tiempo mximo que durara la grabacin en


segundos.

Prof: Julio Yupanqui V.


69
background tocara la lista de archivos especificada mientras espera
se ingrese un numero de extensin.

wait. Espera un nmero de segundos especificados.

La sintaxis es la siguiente:

wait(seconds)

waitExten. Espera a que se ingrese una nueva extensin, dndole la


oportunidad al que llama de marcar una nueva extensin.

Echo. Devuelve el audio de regreso al mismo canal que lo ha


generado. La ejecucin terina cuando el usuario presiona # o cuelga el
telfono.

Ejemplos:

exten => 5000,1,Playback(echo-ini)

exten => 2000,2,echo

exten => 5000,3,playback(echo-fin)

exten => 5000,4,hangup

Prof: Julio Yupanqui V.


70
Prof: Julio Yupanqui V.
71
Prof: Julio Yupanqui V.
72
CONFIGURANDO CUENTAS SIP

sip.conf
El fichero de configuracin del canal sip se encuentra en
/etc/asterisk/sip.conf y por tanto ser donde configuremos las cuentas SIP.
Su formato es similar al de los ficheros .ini; por lo que se encuentra dividido en
secciones conocidas en Asterisk como contextos. En el fichero sip.conf hay un
contexto predefinido, se llama [general]:

En el contexto [general] definiremos parmetros que se aplicarn en todos los


contextos posteriores. Algunos de los parmetros generales del canal SIP son:

port: es el puerto que utilizar Asterisk para escuchar conexiones SIP


entrantes. El puerto SIP por defecto es el 5060.
binaddr: interfaz de red que utilizar Asterisk para atender las
conexiones SIP entrantes. El valor por defecto es 0.0.0.0, es decir,
escucha en todas las interfaces de red disponibles.
context: contexto que se aplica a las llamadas entrantes. Se aplica
cuando una cuenta SIP no tiene definido un contexto.
videosupport: soporte de video en SIP. Permite los valores yes o no.

Prof: Julio Yupanqui V.


73
language: lenguaje utilizado por defecto para todos los clientes SIP.
allow: especificamos los cdecs de sonido que vamos a utilizar. Permite
valores como all, alaw, ulaw, gsm, etc.
disallow: cdecs de audio que no vamos a permitir. Cuando vamos a
restringir los cdecs de audio, lo mejor es siempre prohibirlos todos
(disallow=all) y luego permitir aquellos que queramos.
nat: habilitamos o deshabilitamos el soporte de nat para la extensin.

Un ejemplo para el contexto [general] en /etc/asterisk/sip.conf podra ser la siguiente:

[general]
port=5060
bindaddr = 0.0.0.0
context = normal
videosupport = no
language = es
disallow = all
allow= alaw, gsm

Definiendo los clientes SIP


Como he comentado anteriormente, antes de que un cliente SIP pueda enviar o recibir llamadas a
travs de Asterisk, debe ser declarado y configurado en el fichero /etc/asterisk/sip.conf. Cada
cliente SIP se configurar como si de otro contexto / seccin se tratase, y podemos especificar
varios parmetros. Hasta ahora los que he utilizado han sido los siguientes:

type: define la clase de conexin que tendr el cliente. Hay tres tipos de clientes SIP:
1. peer: solo puede recibir llamadas.
2. user: solo puede realizar llamadas.
3. friend: puede recibir y realizar llamadas.
callerid: es el identificador del cliente, es decir, el nombre que aparecer cuando se realice
una llamada.
username: usuario con el que nos conectaremos al servidor Asterisk.
secret: contrasea con la que se realizar la autenticacin en Asterisk junto con el
username.
context: contexto asociado al cliente en el dialplan de Asterisk, es decir, contexto que se
aplicar en el fichero extensions.conf del cual hablaremos ms adelante.
dtmfmode: Dual-Tone Multi-Frequecy (DTMF) se refiere a la marcacin por tonos.
Normalmente le especifico que use el estandar rfc2833.
qualify: si se establece a yes podremos monitorizar la extensin. Esta configuracin no es
muy recomendable cuando tenemos muchas extensiones.

Bien! Ya tenemos lo suficiente como para empezar a registrar cada uno de los clientes SIP :-) De
esta forma, para registrar el telfono digital cuya extensin es 1001 tendremos que aadir la
siguiente configuracin al fichero /etc/asterisk/sip.conf:

Prof: Julio Yupanqui V.


74
[1001]
callerid=Gabriel
username=1001
secret=1001
type=friend
host=dynamic
context=normal
qualify=yes
pickupgroup=1
limitonpeers=yes
call-limit=4
dtmfmode=rfc2833
nat=yes

Como una breve anotacin tengo que decir que en la cabecera de la seccin, en este caso [1001],
podemos poner cualquier cadena, creo que sin espacios, pero yo opto por poner el nmero de la
extensin, me es ms cmodo al leer la configuracin.

Una que hemos configurado un cliente, los dems son coser y cantar. Vamos a registrar un nuevo
cliente SIP, por ejemplo, mi portatil cuyo username es mviera y su extensin ser 1003. La
configuracin en sip.conf sera la siguiente:

[1003]
Callerid = jyupanqui
Username = 1003
Secret = 1003
Type = friend
Host = dynamic
Context = normal
Qualify = yes
Pickupgroup = 1
Limitonpeers = yes
call-limit = 4
dtmfmode = rfc2833
nat = yes

Fcil no? Pero no os resulta esta ltima configuracin un poco redundante? Algunos ya se
habrn dado cuenta. En realidad esta ltima configuracin es igual que la anterior, solamente
cambian los parmetros callerid, username y secret. Cierto?

Para ello, Asterisk en su ltimas versiones permite el uso de mscaras. Esta funcionalidad nos
permite crear una seccin padre donde configuraremos todos los parmetros comunes. De esta
forma podremos heredar parte de la configuracin, pudiendo sobreescribir o incluir nuevos
parmetros que nos sean necesarios. Utilizaremos (!) junto al nombre de la seccin, para
especificar que una seccin actuar como una mscara. Ejemplo: [nombre_seccion](!).

Ya que sabemos sobre la existencia de las mscaras en Asterisk, vamos a modificar la


configuracin actual en /etc/asterisk/sip.conf. Crearemos una seccin [normal] con los parmetros
comunes y las extensiones 1001 y 1003 heredarn de esta seccin.

Prof: Julio Yupanqui V.


75
[normal](!)
type=friend
host=dynamic
context=normal
qualify=yes
pickupgroup=1
limitonpeers=yes
call-limit=4
dtmfmode=rfc2833
nat=yes

Para especificar que una seccin hereda de otra que acta como mscara especificaremos el
nombre de la mscara a continuacin del nombre de la seccin, es decir, de la siguiente forma:
[nombre_seccion](nombre_mascara). Por lo que la configuracin de las extensiones 1001 y
1003 se reducira a lo siguiente:

[1001](normal)
callerid=digital
username=1001
secret=1001

[1003](normal)
callerid=mviera
username=1003
secret=1003

Ahora solo nos queda reiniciar el servicio Asterisk

# /etc/init.d/asterisk restart

Nota: cuidado al reiniciar el servicio Asterisk cuando modifiquemos la configuracin. Si utilizamos


restart todas las llamadas activas se cortarn. Asi que mejor utilizad reload ;-)

La configuracin del resto de extensiones es similar a las anteriores, aun as os dejo el enlace al
fichero sip.conf.

Prof: Julio Yupanqui V.


76
COMANDOS ASTERISK

General CLI commands

! - Execute a shell command


abort halt - Cancel a running halt
cdr status - Display the CDR status
feature show - Lists configured features
feature show channels - List status of feature channels
file convert - Convert audio file
group show channels - Display active channels with group(s)
help - Display help list, or specific help on a command
indication add - Add the given indication to the country
indication remove - Remove the given indication from the country
indication show - Display a list of all countries/indications
keys init - Initialize RSA key passcodes
keys show - Displays RSA key information
local show channels - List status of local channels
logger mute - Toggle logging output to a console
logger reload - Reopens the log files
logger rotate - Rotates and reopens the log files
logger show channels - List configured log channels
meetme - Execute a command on a conference or conferee
mixmonitor - Execute a MixMonitor command.

moh reload - Music On Hold


moh show classes - List MOH classes
moh show files - List MOH file-based classes
no debug channel (null)
originate - Originate a call
realtime load - Used to print out RealTime variables.
realtime update - Used to update RealTime variables.
restart gracefully - Restart Asterisk gracefully
restart now - Restart Asterisk immediately
restart when convenient - Restart Asterisk at empty call volume
sla show - Show status of Shared Line Appearances
soft hangup - Request a hangup on a given channel
stop gracefully - Gracefully shut down Asterisk
stop now - Shut down Asterisk immediately
stop when convenient - Shut down Asterisk at empty call volume
stun debug - Enable STUN debugging
stun debug off - Disable STUN debugging
udptl debug - Enable UDPTL debugging
udptl debug ip - Enable UDPTL debugging on IP
udptl debug off - Disable UDPTL debugging

Prof: Julio Yupanqui V.


77
Agents commands

agent logoff - Sets an agent offline


agent show - Show status of agents
agent show online - Show all online agents

AGI commands

agi debug - Enable AGI debugging


agi debug off - Disable AGI debugging
agi dumphtml - Dumps a list of agi commands in html format
agi show- List AGI commands or specific help
dnsmgr reload - Reloads the DNS manager configuration
dnsmgr status - Display the DNS manager status
http show status - Display HTTP server status

Console commands

console active - Sets/displays active console


console answer - Answer an incoming console call
console autoanswer - Sets/displays autoanswer
console boost - Sets/displays mic boost in dB
console dial - Dial an extension on the console
console flash - Flash a call on the console
console hangup - Hangup a call on the console
console mute - Disable mic input
console send text - Send text to the remote device
console transfer - Transfer a call to a different extension
console unmute - Enable mic input

Core related commands

core clear profile - Clear profiling info


core set debug channel - Enable/disable debugging on a channel
core set debug - Set level of debug chattiness
core set debug off - Turns off debug chattiness
core set global - Set global dialplan variable
core set verbose - Set level of verboseness
core show applications - Shows registered dialplan applications
core show application - Describe a specific dialplan application
core show audio codecs - Displays a list of audio codecs
core show channels - Display information on channels
core show channel - Display information on a specific channel
core show channeltypes - List available channel types
core show channeltype - Give more details on that channel type
core show codecs - Displays a list of codecs
core show codec - Shows a specific codec
core show config mappings - Display config mappings (file names to config engines)
core show file formats - Displays file formats
core show file version - List versions of files used to build Asterisk
core show functions - Shows registered dialplan functions
core show function - Describe a specific dialplan function
core show globals - Show global dialplan variables
core show hints - Show dialplan hints
core show image codecs - Displays a list of image codecs
core show image formats - Displays image formats
core show license - Show the license(s) for this copy of Asterisk

Prof: Julio Yupanqui V.


78
core show profile - Display profiling info
core show switches - Show alternative switches
core show threads - Show running threads
core show translation - Display translation matrix
core show uptime - Show uptime information
core show version - Display version info
core show video codecs - Displays a list of video codecs
core show warranty - Show the warranty (if any) for this copy of Asterisk

Database commands

database del - Removes database key/value


database deltree - Removes database keytree/values
database get - Gets database value
database put - Adds/updates database value
database show - Shows database contents
database showkey - Shows database contents

Dialplan commands

dialplan add extension - Add new extension into context


dialplan add ignorepat - Add new ignore pattern
dialplan add include - Include context in other context
dialplan reload - Reload extensions and *only* extensions
dialplan remove extension - Remove a specified extension
dialplan remove ignorepat - Remove ignore pattern from context
dialplan remove include - Remove a specified include from context
dialplan save - Save dialplan
dialplan show - Show dialplan

IAX2 commands

iax2 provision - Provision an IAX device


iax2 prune realtime - Prune a cached realtime lookup
iax2 reload - Reload IAX configuration
iax2 set debug - Enable IAX debugging
iax2 set debug jb - Enable IAX jitterbuffer debugging
iax2 set debug jb off - Disable IAX jitterbuffer debugging
iax2 set debug off - Disable IAX debugging
iax2 set debug trunk - Enable IAX trunk debugging
iax2 set debug trunk off - Disable IAX trunk debugging
iax2 show cache - Display IAX cached dialplan
iax2 show channels - List active IAX channels
iax2 show firmware - List available IAX firmwares
iax2 show netstats - List active IAX channel netstats
iax2 show peers - List defined IAX peers
iax2 show peer - Show details on specific IAX peer
iax2 show provisioning - Display iax provisioning
iax2 show registry - Display IAX registration status
iax2 show stats - Display IAX statistics
iax2 show threads - Display IAX helper thread info
iax2 show users - List defined IAX users
iax2 test losspct - Set IAX2 incoming frame loss percentage

Module management

Prof: Julio Yupanqui V.


79
module load - Load a module by name
module reload - Reload configuration
module show - List modules and info
module show like - List modules and info
module unload - Unload a module by name

Queue commands

queue add member - Add a channel to a specified queue


queue remove member - Removes a channel from a specified queue
queue show - Show status of a specified queue
rtcp debug ip - Enable RTCP debugging on IP
rtcp debug - Enable RTCP debugging
rtcp debug off - Disable RTCP debugging
rtcp stats - Enable RTCP stats
rtcp stats off - Disable RTCP stats
rtp debug ip - Enable RTP debugging on IP
rtp debug - Enable RTP debugging
rtp debug off - Disable RTP debugging
say load - Set/show the say mode
show parkedcalls - Lists parked calls
show queue - Show information for target queue
show queues - Show the queues

SIP commands

sip history - Enable SIP history


sip history off - Disable SIP history
sip notify - Send a notify packet to a SIP peer
sip prune realtime - Prune cached Realtime object(s)
sip prune realtime peer - Prune cached Realtime peer(s)
sip prune realtime user - Prune cached Realtime user(s)
sip reload - Reload SIP configuration
sip set debug - Enable SIP debugging
sip set debug ip - Enable SIP debugging on IP
sip set debug off - Disable SIP debugging
sip set debug peer - Enable SIP debugging on Peername
sip show channels - List active SIP channels
sip show channel - Show detailed SIP channel info
sip show domains - List our local SIP domains.
sip show history - Show SIP dialog history
sip show inuse - List all inuse/limits
sip show objects - List all SIP object allocations
sip show peers - List defined SIP peers
sip show peer - Show details on specific SIP peer
sip show registry - List SIP registration status
sip show settings - Show SIP global settings
sip show subscriptions - List active SIP subscriptions
sip show users - List defined SIP users
sip show user - Show details on specific SIP user

Prof: Julio Yupanqui V.


80
Voicemail commands

voicemail show users - List defined voicemail boxes


voicemail show users for - List defined voicemail boxes for target context
voicemail show zones - List zone message formats

Zaptel commands

zap destroy channel - Destroys a channel


zap restart - Fully restart zaptel channels
zap show cadences - List cadences
zap show channels - Show active zapata channels
zap show channel - Show information on a channel
zap show status - Show all Zaptel cards status

DAHDI commands

dahdi show channels


dahdi show channel

Prof: Julio Yupanqui V.


81
BIBLIOGRAFIA:

Manual TECSUP : Instalacin y configuracin de ASTERISK

Asterisk : A Non-Technical Overview Nasser K.Manesh

Internet Sitio: http://www.3cx.es

Prof: Julio Yupanqui V.


82

You might also like