1.

Instalacin del servicio Asterisk en una mquina con el sistema operativo

Centos 5. Esta mquina ser nuestro servidor PBX.
2. Instalacin del servicio de base de datos mysql.
3. Instalacin del compilador para el lenguaje de programacin php 5.
4. Instalacin de la Tarjeta Digium Tdm410p Pci con 4 Puertos fxs/fxo en el
servidor.
5. Conexin y configuracin de telfonos IP marca Grandstream con
usuarios sip.
Instalacin y configuracin del softphone zoiper con un usuario iax

2.1 Protocolo SIP

SIP (Session Initiation Protocol) es un protocolo de sealizacin para
conferencia, telefona, presencia, notificacin de eventos y mensajera
instantnea a travs de Internet. Fue desarrollado incialmente en el
grupo de trabajo IETF MMUSIC (Multiparty Multimedia Session Control)
y, a partir de Septiembre de 1999, pas al grupo de trabajo IETF SIP (3).
La sintaxis de sus operaciones se asemeja a las de HTTP y SMTP, los
protocolos utilizados en los servicios de pginas Web y de distribucin de
e-mails respectivamente. Esta similitud es natural ya que SIP fue
diseado para que la telefona se vuelva un servicio ms en la Internet.
En Noviembre del ao 2000, SIP fue aceptado como el protocolo de
sealizacin de 3GPP y elemento permanente de la arquitectura IMS (IP
Multimedia Subsystem). SIP es uno de los protocolos de sealizacin
para voz sobre IP. Este protocolo usa el puerto UDP 5060 y su
documentacin se encuentra en la RFC 2543.

Funcionamiento
El protocolo SIP permite el establecimiento de sesiones multimedia entre

dos o ms usuarios. Para hacerlo se vale del intercambio de mensajes

entre las partes que quieren comunicarse.
Componentes del protocolo:
Agentes de Usuario
Servidores de Registro o Registrar
Servidores Proxy y de Redireccin

Agentes de Usuario
Los usuarios, que pueden ser seres humanos o aplicaciones de software,
utilizan para establecer sesiones lo que el protocolo SIP denomina
"Agentes de usuario". Estos son puntos extremos del protocolo, es decir
son los que emiten y consumen los mensajes del protocolo SIP. Un
videotelfono, un telfono, un cliente de software (softphone) y cualquier
otro dispositivo similar es para el protocolo SIP un agente de usuario. Los
agentes de usuario se comportan como clientes (UAC: User Agent
Clients) y como servidores (UAS: User Agent Servers). Son UAC cuando
realizan una peticin y son UAS cuando la reciben. Por esto los agentes
de usuario deben implementar un UAC y un UAS.

Servidores de Registro o Registrar

El protocolo SIP permite establecer la ubicacin fsica de un usuario
determinado, esto es en qu punto de la red est conectado. Para ello se
vale del mecanismo de registro. Este mecanismo funciona como sigue:
Cada usuario tiene una direccin lgica que es invariable respecto de la
ubicacin fsica del usuario. Una direccin lgica del protocolo SIP es de
la forma usuario@dominio es decir tiene la misma forma que una
direccin de correo electrnico. La direccin fsica (denominada
"direccin de contacto") es dependiente del lugar en donde el usuario
est conectado (de su direccin IP). Cuando un usuario inicializa su
terminal (por ejemplo conectando su telfono o abriendo su software de
telefona SIP) el agente de usuario SIP que reside en dicho terminal
enva una peticin con el mtodo REGISTER a un Servidor de Registro,
informando a qu direccin fsica debe asociarse la direccin lgica del
usuario. El servidor de registro realiza entonces dicha asociacin
(denominada binding). Esta asociacin tiene un perodo de vigencia y si
no es renovada, caduca. Tambin puede terminarse mediante un
desregistro.
Servidores Proxy y de Redireccin
Para encaminar un mensaje entre un agente de usuario cliente y un
agente de usuario servidor normalmente se recurre a los servidores.
Estos servidores pueden actuar de dos maneras:

Como Proxy, encaminando el mensaje hacia destino,

Como Redirector (Redirect), generando una respuesta que indica al
origen la direccin del destino o de otro servidor que lo acerque al
destino.

La principal diferencia es que el servidor proxy queda formando parte del

camino entre el UAC y el (o los) UAS, mientras que el servidor de
redireccin una vez que indica al UAC cmo encaminar el mensaje ya no
interviene ms. Un mismo servidor puede actuar como Redirector o como
Proxy dependiendo de la situacin (4).

2.1 Protocolo IAX

IAX (Inter-Asterisk eXchange) es uno de los protocolos utilizado por

Asterisk, creado por Mark Spencer, para el control de llamadas de voz
sobre ip, documentado en la RFC 5456, el trfico usa el puerto udp
4569. Inicialmente fue desarrollado para la PBX Asterisk y originalmente
se mantuvo para intercambio de trfico entre servidores Asterisk. Hoy en
da este protocolo es usado en diversas plataformas de voz sobre ip. IAX
fue diseado para reemplazar tempranamente a los protocolos de control
de llamada: H.323 and SIP. IAX emplea de manera eficiente el ancho de

banda comparado a otros protocolos de su tipo, habilitndolo

para

soportar un mayor nmero de llamadas concurrentes de voz sobre ip,

sobre la misma cantidad de ancho de banda, soporta autenticacin
mediante claves pblicas con RSA con el algoritmo de message diggest
SHA-1 para firmas digitales(5). El protocolo IAX ahora se refiere
generalmente al IAX2, la segunda versin del protocolo IAX. El protocolo
original ha quedado obsoleto en favor de IAX2.

Propiedades Bsicas
IAX2 es robusto, lleno de novedades y muy simple en comparacin con
otros protocolos. Permite manejar una gran cantidad de cdecs y un gran
nmero de transmisiones conocidas como streams, lo que significa que
puede ser utilizado para transportar virtualmente cualquier tipo de dato.
Esta capacidad lo hace muy til para realizar videoconferencias o realizar
presentaciones remotas; utiliza un nico puerto UDP, generalmente el
4569, para comunicaciones entre puntos finales (terminales VoIP) para
sealizacin y datos. El trfico de voz es transmitido dentro de banda (inband), lo que hace a IAX2 un protocolo casi transparente a los
cortafuegos y realmente eficaz para trabajar dentro de redes internas. En
esto se diferencia de SIP, que utiliza una cadena RTP fuera de banda
(out-of-band) para entregar la informacin.

IAX2 soporta Trunking (red), donde un simple enlace permite

enviar

datos y sealizacin por mltiples canales. Los componentes de la

sealizacin iax son muy parecidos a los del protocolo SIP.

Objetivos de IAX
El principal objetivo de IAX ha sido minimizar el ancho de banda utilizado
en la transmisin de voz y vdeo a travs de la red IP, con particular
atencin al control y a las llamadas de voz y proveyendo un soporte
nativo para ser transparente a la traduccin de direcciones de red (NAT).
La estructura bsica de IAX se fundamenta en la multiplexacin de la
sealizacin y del flujo de datos sobre un simple puerto UDP entre dos
sistemas. El ancho de banda para algunas aplicaciones se sacrifica en
favor del ancho de banda para VoIP (6).

2.2 Interfaz de puerta de enlace de Asterisk

La interfaz de puerta de enlace de Asterisk (AGI) es una interfaz para

aadir funcionalidad a Asterisk con diferentes lenguajes de programacin
como: Perl, PHP, C, Pascal, Bourne Shell.
AGI puede controlar el plan de marcado, llamado en extensions.conf.
A continuacin se mencionan sus variantes:
Async AGI.- introducido en Asterisk 1.6, permite un asincrnico scripting
de AGI.

EAGI.- brinda a la aplicacin la posibilidad de acceder y controlar el canal

de sonido adems de la interaccin con el plan de marcado.
FastAGI.- puede ser usado para hacer el procesamiento en una mquina
remota va conexin a la red.
DeadAGI.- brinda acceso a canales deshabilitados despus de ser
colgados, esta variante est descartada a partir de Asterisk 1.6.

Ambiente de ejecucin

Cuando Asterisk empieza un script AGI, este alimenta las variables de

canal para el script en entrada estndar. Los nombres de las variables
tienen el prefijo agi_ y estn separadas de sus valores por dos puntos y
un espacio. Aunque las variables de canal deben estar en maysculas,
los nombre pasados a un script agi deben estar en minsculas. Un script
agi puede retornar cualquiera de los siguientes estados en la variable
"AGISTATUS": SUCCESS, FAILURE, HANGUP.
Las variables pasadas por Asterisk son:
agi_request El nombre de archivo del script.
agi_channel El canal de origen (su telfono).
agi_language El lenguaje del cdigo (e.j. "en") .
agi_type El tipo de canal de origen (e.j. "SIP" or IAX2").
agi_uniqueid - El ID nico para la llamada.

agi_version - La version de Asterisk (desd Asterisk 1.6).

agi_callerid - El nmero del caller ID (o "unknown").
agi_calleridname El nombre del caller ID (o "unknown").
agi_callingpres La presentacin para el callerid en un canal ZAP .
agi_callingani2 El nmero que est definido en ANI2. Revisar en la lista
detallada de variables (slo para canales PRI).
agi_callington El tipo de nmero usado en canales PRI. Revisar en la
lista detallada de variables.
agi_callingtns un nmero de 4 digitos opcional(Selector de Trnsito de
Red) usado en canales PRI . Revisar en la lista detallada de variables.
agi_dnid El id del nmero marcado (o "unknown") .
agi_rdnis El nmero referente a DNIS (o "unknown") .
agi_context contexto origen en extensions.conf.
agi_extension El nmero llamado.
agi_priority La prioridad desde la cual fue ejecutado en el plan de
marcado.
agi_enhanced El valor de la bandera es 1.0 si empez como un script
EAGI , 0.0 de otro modo.
agi_accountcode Cdigo de la cuenta del canal de origen.
agi_threadid ID del hilo del script agi (desde Asterisk 1.6)

Un script agi tambin puede pasar un nmero de variables de ambiente,

que apunta a los directorios del sistema de archivos que contiene los
archivos de Asterisk, estas son (7):
AST_CONFIG_DIR

AST_DATA_DIR

AST_CONFIG_FILE

AST_LOG_DIR

AST_MODULE_DIR

AST_AGI_DIR

AST_SPOOL_DIR

AST_KEY_DIR

AST_MONITOR_DIR

AST_RUN_DIR

AST_VAR_DIR

Existen una gran cantidad de comandos para poder acceder, modificar

variables de Asterisk y entre otras funcionalidades muy tiles cuando se
emplea agi, para lo cual es recomendable revisar la documentacin
respectiva.

2.3 Archivos Call

Como su nombre lo indica, son archivos cuya extensin es call y los

cuales Asterisk procesa para generar llamadas salientes segn los
parmetros indicados en el mismo archivo, indicando bsicamente:
1. Cmo realizar la llamada, similar a la aplicacin Dial().
2. Qu hacer cuando la llamada sea respondida.

Con los archivos call se puede especificar toda esta

informacin

simplemente creando el archivo con la sintaxis requerida y colocarlo en el

directorio /var/spool/Asterisk/outgoing/ (esta ruta se puede modificar en el
archivo Asterisk.conf).
El mdulo PBX_spool examina cada segundo el contenido de dicho
directorio, creando una nueva llamada para cada archivo call que
encuentre. No se debe escribir o crear este archivo en la ruta antes
mencionada o Asterisk la leer parcialmente; por esto, el archivo debe
crearse en otra ruta y luego moverlo a la que realmente permitir su
ejecucin.

Sintaxis

El archivo call consiste de pares <clave>:<valor>, uno por lnea.

Los comentarios se indican mediante el carcter # que

debe

antecederles; los comentarios tambin pueden ser indicados con ;.

Pero no se permiten comentarios multilnea de la forma: (;-- --;) usado en
los archivos de configuracin de Asterisk. Los ; pueden ser escapados
con el smbolo: \.
Los siguientes pares claves-valor son usados para configurar la llamada:
Channel: <channel>

El canal sobre el cual se debe realizar la llamada, usa la misma sintaxis

que el Dial().
Callerid: <callerid>
El caller ID a ser usado para la llamada.
WaitTime: <number>
Nmero de segundos que el sistema debe esperar para que la llamada
sea respondida. Si no se especifica, por default es de 45 segundos.
MaxRetries: <number>
Mximo nmero de reintentos de marcado (si un intento falla porque el
dispositivo est ocupado o es inalcanzable). Si no est especificado, el
valor por default es 0 y slo un intento ser realizado.
RetryTime: <number>
Nmero de segundos para esperar antes de realizar el siguiente intento.
Si no se especifica, el valor por default es de 300 segundos.
Account: <account>
El cdigo de la cuenta para el CDR.
Context: <context>
El contexto destino.
Extension: <exten>
La extension destino, en el que la ejecucin del plan de marcada o
empieza si el dispositivo es respondido.
Priority: <priority>

La prioridad destino. Si no se especifica, el valor por default es1.

Setvar: <var=value>
Sirve para setear una variable
Archive: <yes|no>
De

manera

predeterminada,

inmediatamente

despus

de

configurado,

ellos

son

los
su

archivos
ejecucin.
copiados

call

son

eliminados

Si Archive:yes
al

est

directorio:

/var/spool/Asterisk/outgoing_done/ y Asterisk aade una lnea al archivo

que describe el resultado:
Status: <Expired|Completed|Failed>
Application: <appname>
La aplicacin a utilizar, una vez que la llamada sea respondida.
Data: <args>
Opciones o argumentos de la aplicacin (9).

2.4 Macros
Una macro es una clase de subrutina; esta puede contener complejos
flujos de trabajos pero es llamada a travs de una nica entrada. Este
reduce la repeticin en el plan de marcado y hace que sea
impecable y ms pequeo.

ms

Sintaxis

Macro(name[,args(arg1[,arg2[,...]])])

Se ejecuta una macro usando como nombre contexto: macro-nombre ,

saltando a la extensin s de este contexto y ejecutando cada paso,
entonces retorna al plan de marcado cuando los pasos hayan sido
finalizados.
La extensin llamante, contexto y prioridad son almacenados
MACRO_EXTEN,

MACRO_CONTEXT

en

MACRO_PRIORITY

respectivamente. Los argumentos enviados se convierten en ARG1,

ARG2,etc en el contexto macro.
Si MACRO_OFFSET es configurado en la terminacin, el macro intentar
continuar a la prioridad MACRO_OFFSET +N+1 si la misma existe y N+1
de otra manera (10).

2.5 Base de datos de Asterisk: AstDB

La base de datos de Asterisk, tambin conocida como AstDB, es un

mecanismo

muy poderoso

que

provee

este

software

para

el

almacenamiento de valores. Esta base de datos brinda una manera

simple de almacenar los datos para su uso en el plan de marcado.
La AstDB almacena los datos en grupos familias, con

valores

identificados por claves. Dentro de una familia, una clave puede ser

usada una sola vez. Por ejemplo si se tiene la familia llamada test, se
podra almacenar slo un valor con la clave llamada count. Cada valor
almacenado debe estar asociado con una familia.

Para almacenar datos en la AstDB se usa la aplicacin Set(). As por

ejemplo para asignar la clave count a la familia test con el valor de 1:
exten => 456,1,Set(DB(test/count)=1); si la clave ya existe, sta ser
sobrescrita.

Tambin

es equivalente

aplicar

el comando

en la

CLI>database put family key value

Para recuperar datos de la AstDB y asignarlo a una variable, se usa la

aplicacin Set() nuevamente. As por ejemplo para obtener el valor de
count de la familia test y se le asigna a la variable COUNT:
exten => 456,1,Set(COUNT=${DB(test/count)})

Para eliminar datos de la AstDB, en el caso de que se desee eliminar

una clave se usa la aplicacin DB_DELETE(). Para eliminar una familia
de claves entera se usa DBdeltree() (11).
exten => 457,1,Verbose(0, The value was ${DB_DELETE(test/count)})
exten => 457,1,DBdeltree(test)
2.6 Grupos y Categoras

Existen varios conceptos sobre grupos en Asterisk pero todos estn

relacionados. Existen:
Grupos de Canal.- como su nombre lo indica, son usados para agrupar
canales que estn teniendo comunicacin. Las principales operaciones
son:
-Hacer que el canal actual se una a un grupo dado (con identificador
alfanumrico)
-Contar la cantidad de canales que actualmente pertenecen al grupo
dado.

Un canal puede pertenecer slo a un grupo por categora. Por lo tanto, si

uno quiere hacer que un canal pertenezca a ambos grupos: Zap y SIP,
uno tendra que usarse como Zap@in y SIP@out, creando las categoras
in y out. Usando categoras se pueden establecer mltiples grupos en un
solo canal activo; por ejemplo, permitirnos establecer la cantidad de
llamadas en el canal destino y en el canal llamante.
Aqu las funciones para trabajar con este tipo de grupos a partir de
Asterisk 1.2 en adelante:
GROUP() (replaces both SetGroup() and
CheckGroup()) GROUP_COUNT()
GROUP_MATCH_COUNT()
GROUP_LIST()

Grupos de llamadas y pickup.- esta clase de grupos es configurado para

permitir capturar remotamente un tono de ring telefnico a travs de*8(#)
(por default, est denegado). El grupo de llamadas es a lo que una
extensin pertenece, el grupo de pickup o captura es el cual los grupos
de llamadas, la extensin puede remotamente capturar. Este mecanismo
es desafortunadamente local a una tecnologa/driver aunque parches
pueden levantar esta limitacin.
Grupos troncales.- agrupando puertos zapata fxo dentro de

grupos

troncales que permiten la automtica seleccin de un

puerto

deshabilitado para llamadas salientes.

Grupos de Agentes.-Esta caracterstica permite administrar agentes a
travs de grupos ms que individualmente (12).

2.7 Buzn de voz

El buzn de voz de Asterisk es configurado en el archivo voicemail.conf,

que se encuentra en la ruta /etc/Asterisk, permite al usuario grabar un
mensaje y guardarlo en un archivo de audio dado el nmero de buzn.
Para invocar el uso del buzn de voz en el plan de marcado se usa la
aplicacin VoiceMail(boxnumber[@context][&boxnumber2[@context]]
[&boxnumber

3],[flags], y puede tener cualquiera de los siguientes parmetros como

flags:
s.- reproduce una voz predeterminada que dice Por favor deje su
mensaje despus del tono cuando est listo cuelgue o presione la tecla
numeral.
u.-reproduce una voz predeterminada indicando que la extensin
marcada no se encuentra disponible.
b.- reproduce la voz predeterminada indicando que la extensin marcada
se encuentra ocupada.

Para acceder al contenido del buzn de voz y escuchar los mensajes, se

puede acceder mediante la aplicacin VoicemailMain en el plan de
marcado (13).

2.8 FXS y FXO

FXS y FXO son los nombres de los puertos usados por las lneas
telefnicas analgicas (tambin denominados POTS - Servicio Telefnico
Bsico y Antiguo). FXS es 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. FXO es la 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.
FXO y FXS son siempre pares, es decir, similar a un enchufe
macho/hembra. Sin una centralita, como se muestra en la figura 2.2, el
telfono se conecta directamente al puerto FXS que brinda la empresa
telefnica.

Figura 2.2 FXS/FXO sin centralita

Si tiene centralita, como se muestra en la figura 2.3, debe conectar las

lneas que suministra la empresa telefnica a la centralita y luego los
telfonos a la centralita. Por lo tanto, la centralita debe tener puertos FXO
(para conectarse a los puertos FXS que suministra la empresa telefnica)
y puertos FXS (para conectar los dispositivos de telfono o fax)

Figura 2.3 FXS/FXO con centralita

Pasarela FXO
Para conectar lneas telefnicas analgicas con una centralita IP, se
necesita una pasarela FXO. Ello le permitir conectar el puerto FXS con
el puerto FXO de la pasarela, que luego convierte la lnea telefnica
analgica en una llamada VOIP, vase la figura 2.4 a continuacin.

Figura 2.4 Pasarela FXO

Pasarela FXS

La pasarela FXS se usa para conectar una o ms lneas de una centralita

tradicional con una centralita o suministrador telefnico VOIP. Usted

necesitar una pasarela FXS ya que usted desea conectar los puertos
FXO (que normalmente se conectan a la empresa telefnica) a la Internet
o centralita VOIP, vase la figura 2.5 para comprenderlo mejor.

Figura 2.5 Pasarela FXS

Adaptador FXS, tambin denominado adaptador ATA

El adaptador FXS se usa para conectar un telfono analgico o aparato

de fax a un sistema telefnico VOIP o a un prestador VOIP. Usted lo
necesitar para conectar el puerto FXO del telfono/fax con el adaptador
(14).

4.1 Inicializacin de Asterisk

Figura 4.1 Inicializacin de Asterisk

1. Como se muestra en la figura 4.1, lo primero es inicializar el servidor

Asterisk, en esta imagen se muestra el prompt CLI>.
2. Se procede a registrar los clientes sip e iax mediante los softphone o
el telfono ip. tal y como se observa en la figura 4.2, as aparecen
cuando ya estn registrados en el servidor.

--

1. Los parmetros del archivo .call pueden ser configurados y ajustados

a las necesidades de la empresa, es posible que se desee disminuir
el nmero de intentos del callback o aumentar el tiempo de espera
para su ejecucin a fin de no sobrecargar el

servidor

con la

realizacin de llamadas salientes, se recomienda adaptarlo a sus

necesidades, la programacin del callback se encuentra en el archivo
extensions.conf en la macro internos, que est ubicado en la ruta
/etc/Asterisk.

1. Asegurarse

que

los

scripts

que

se

colocan

en

la

ruta

/var/lib/Asterisk/agi-bin se encuentren con los permisos de

ejecucin

correspondientes, por ejemplo mediante el comando chmod 777

nombre_del_script.

2. Verificar en los softphones que se encuentren habilitados los codecs

de audio gsm, allaw, ullaw, que son los que se suelen usar para las
voces del buzn de voz.

2. Recuerde colocar la librera phpagi versin 2.14 en la ruta

/var/lib/Asterisk/agi-bin,

ya

que

se

la

requiere

en

el

script

scrbasefinal.agi, en este mismo directorio.

3. Asegurarse de usar el puerto correcto de la tarjeta Digium TDM410p

para el cual ha sido configurada la conexin con la red de telefona
pblica,

cuya

configuracin

se

encuentra

en

el

chan_dahdi.conf, que se encuentra en la ruta /etc/Asterisk.

archivo

INSTALACIN DE ASTERISK Y SUS DEPENDENCIAS

Se requiere descargar el paquete estable de Asterisk 1.4, se lo puede

encontrar en el siguiente enlace:
http://downloads.digium.com/pub/Asterisk/Asterisk-1.4-current.tar.gz
1. Se recomienda tener todos los paquetes actualizados:
yum update o yum upgrade y
2. Se necesita tener actualizado y funcionando los paquetes:
gcc: es el compilador de C y todas sus dependencias relacionadas.
openssl: librerias de desarrollo para soporte RSA y MD5.
ncurses: para el CLI y las otras dependencias relacionadas.
Fuentes del kernel de

yum -y install gcc gcc-c++ kernel-devel bison openssl-devel

libtermcap-devel ncurses-devel

3. Para instalar las dependencias y soporte para DB:

yum

-y

install

mysql-server

mysql-devel

unixODBC unixODBC-devel libtool-ltdl

libtool-ltdl-devel

mysql-connector-odbc
4. En el caso de tener problemas de sources for kernel, emita
los siguientes comandos

newt-devel

yum y install kernel-devel

yum y update kernel
uname -r
De ser necesario reinicie verificando la correcta version de Linux!!
5. Descargue los paquetes en /usr/src
wget -c http://downloads.digium.com/pub/Asterisk/Asterisk1.4-current.tar.gz
wget -c
http://downloads.digium.com/pub/Asterisk/Asteris
k- addons-1.4-current.tar.gz
wget -c
http://downloads.digium.com/pub/telephony/dahd
i- tools/dahdi-tools-current.tar.gz
wget -c
http://downloads.digium.com/pub/telephony/dahd
i- linux/dahdi-linux-current.tar.gz
wget -c
http://downloads.digium.com/pub/libpri/libpri-1.4current.tar.gz
6. Siguiendo el LSB (Linux Standard Base) de Asterisk estos paquetes
debern ser descomprimidos en /usr/src/
tar -xvzf Asterisk-1.4-current.tar.gz

 tar -xvzf Asterisk-addons-1.4-current.tar.gz

Descomprima los otros paquetes tambin.
7. Ejecutar el siguiente grupo de comandos:

Comandos para instalacin de Asterisk

4. cd ../Asterisk-1.4.22
make clean
1. cd dahdi-linux-current

./configure

make
make install
make install
make samples
make config
5. cd ../Asterisk-addons-1.4.7
2. cd dahdi-tools-current
make clean
./configure
./configure

make
make install

make install
make config
make samples
make

LISTO !!

make install

Finalmente para comprobar que Asterisk se encuentra instalado se puede

ingresar a su consola, emitiendo el comando Asterisk r y se debera ver el
prompt CLI> .

APNDICE B

INSTALACIN DE MYSQL

A continuacin se detalla el procedimiento para instalar mysql:

1. Verificar e instalar MySQL:

yum install mysql* unixODBC-devel -y

o sino:

yum -y install mysql-server mysql-devel newt-devel unixODBC

unixODBC-devel libtool-ltdl libtool-ltdl-devel mysql-connectorodbc

2. Iniciar el servicio mysql como usuario root:

service mysqld start mysqladmin -u <root> password

<contrasea_de_root>

3. Ingresar al directorio donde se encuentran las fuentes de Asterisk addons e instalar el soporte para mysql:
cd /usr/src/Asterisk-addons-

 ./configure
make menuselect
make
make install

APNDICE C

INSTALACIN DE PHP

Se requiere la instalacin del compilador de php versin 5 para la ejecucin

de los scripts .agi escritos en lenguaje de programacin php. A continuacin
se detalla el procedimiento de instalacin:
1. Para agregar php para trabajar con mysql, ejecute el comando:
yum install php*
2. Para que se pueda ejecutar un script, se debera cambiar los permisos
de ejecucin mediante el comando:
chmod 777 <ruta_absoluta_o_nombre_archivo.php>
3. Para correr un script php en consola se debe ubicar en la ruta donde se
encuentra el archivo o especificar la ruta absoluta en el comando y
ejecutar el comando:
! /usr/bin/php -q <archivo.php>
4. Adicionalmente se debe descargar y colocar la librera phpagi versin
2.14 en la ruta /var/lib/Asterisk/agi-bin, puesto que se la requiere para uno

de los scripts escritos en php, que se emplean en este proyecto.

Para hacer debugging de un script agi en Asterisk ejecute en el CLI>agi
debug.

3.1.1 Servidor
El servidor que ser la PBX Asterisk deber tener instalado los siguientes
elementos:

Tabla II Caractersticas del servidor software

Sistema Operativo
Distribucin
Arquitectura
Software IP PBX

Linux
Centos 5.2
x86
Asterisk 1.4

Para instalar Asterisk en el servidor se requieren instalar algunas

dependencias, los procesos de instalacin se detallan en los apndices
de esta tesis. Despus de instalar todo lo necesario, se puede continuar
con las configuraciones que se explican a continuacin.

3.1.1 Configuracin del archivo sip.conf

Este archivo de configuracin se encuentra en la ruta /etc/Asterisk y sirve

para colocar los usuarios sip a registrar en la PBX Asterisk, asi como
para conectarse a un proveedor sip y establecer todo lo relacionado a
este protocolo. A continuacin la configuracin que se ha implementado
para la realizacin de este proyecto:

sip.conf
[general]
srvlookup=yes
disallow=all
allow=alaw
allow=ulaw
allow=gsm
language=es
callwaiting=no
qualify=yes
calltransfer=no
callforwarding=no
[501]
type=friend
secret=501

qualify=yes
nat=yes
host=dynamic
canreinvite=no
context=internal

[502]
type=friend
secret=502
qualify=yes
nat=yes
host=dynamic
canreinvite=no
context=internal

En esta configuracin se han establecido 2 usuarios sip: 501 y 502.

3.1.2 Configuracin del archivo iax.conf

Este archivo de configuracin se encuentra en la ruta /etc/Asterisk y sirve

para colocar los usuarios iax a registrar en la PBX Asterisk y establecer
todo lo relacionado al protocolo iax. A continuacin la configuracin que

se ha implementado para la realizacin de este proyecto:

iax.conf

[general]
disallow=all
allow=gsm
allow=alaw
allow=ulaw
jitterbuffer=yes
bindport=4569
language=es
callwaiting=no

[503]
type=friend
secret=503
host=dynamic
context=internal
callerid=503
requirecalltoken=no

En esta configuracin se han establecido 1 usuario iax: 503.

3.1.3 Configuracin de los archivos system.conf y chan_dahdi.conf

Estos archivos se usan para la configuracin de los canales dahdi, que

son los que se emplean para el uso de la tarjeta analgica tdm410p de 4
puertos. Para nuestro caso, se usa el puerto

como fxo con

sealizacin fxs. El archivo system.conf se ubica en la ruta /etc/dahdi

y el

archivo

chan_dahdi.conf

se encuentra

en

continuacin la configuracin para los mismos sera as:

chan_dahdi.conf

[channels]
usecallerid=yes
hidecallerid=no
callwaiting=no
threewaycalling=yes
transfer=yes
echocancel=yes
echotraining=yes
inmediate=no
group=1
context=incoming

/etc/Asterisk.

signaling=fxs_ks
channel => 4

system.conf

fxsks=4
echocanceller=mg2,4
loadzone=us
defaultzone=us

Para activar la tarjeta analgica se debe emitir el siguiente comando en

consola de root:
dahdi_genconf

3.1.4 Configuracin del archivo voicemail.conf

Este archivo de configuracin se encuentra en la ruta /etc/Asterisk y sirve

para especificar los nmeros de buzn de voz y a quienes estn
asociados, dando incluso la posibilidad de enviar adjunto a un mensaje
de correo electrnico el archivo de audio grabado, el mismo que se

encuentra en la ruta /var/lib/Asterisk/sounds. Este archivo debe ser

personalizado segn los usuarios de las extensiones

correspondientes

dentro de la PBX. A continuacin la configuracin que se ha

implementado para la realizacin de este proyecto, a manera de ejemplo:

Voicemail.conf
[default]
Language=es
501=>501,Orly Macias,micorreo@gmail.com,,tz=central|attach=yes
502=>502,Jose Cun,micorreo@gmail.com,,tz=central|attach=yes
503=>503,Juan Ramirez,micorreo@gmail.com,,tz=central|attach=yes

3.1.5 Configuracin del archivo extensions.conf

Este archivo de configuracin se encuentra en la ruta /etc/Asterisk y sirve

para especificar el plan de marcado de la PBX Asterisk y en el cual se va
realizar la programacin de la retrollamada.
A continuacin la configuracin que se ha implementado para la
realizacin de este proyecto:

extensions.conf

;Contexto general sirve para establecer los parmetros generales del

;plan de marcado.

[general]

autofallthrough=no
clearglobalvars=no

; Contexto internal sirve para especificar el procedimiento a realizarse

;para comunicarse con alguna de las extensiones en el interior de la
PBX.
[internal]
exten => _XXX,1,Answer()
exten => _XXX,2,Wait(1)

; Invoca al script agi que se encargar de crear una base de datos de

;usuarios sip e iax segn los archivos de configuracin sip.conf e iax.conf
;respectivamente.
exten => _XXX,n,AGI(actualiza_base.agi)

;Invoca al script agi que se encarga de verificar la existencia del nmero

;marcado en la base de datos creada con el script anterior para devolver
;en una variable el valor del canal en el que se encuentra registrado.
exten => _XXX,n,AGI(scrbasefinal.agi,${EXTEN})

;Rutina para limitar llamadas entrantes a 1 usando grupos y categoras.

exten => _XXX,n,Set(GROUP(${EXTEN})=OUTBOUND_GROUP)

exten =>
_XXX,n,Set(GROUP(${CALLERID(num)})=OUTBOUND_GROUP)
exten =>
_XXX,n,GotoIf($[${GROUP_COUNT(OUTBOUND_GROUP@${EXTEN})
} > 1]?busy)

;Bandera o indicador que se guarda en la base de datos AstDB definido

;como cero, su uso se explica ms adelante.
exten => _XXX,n,Set(DB(channels/bandera)=0)

;Marca la extensin segn el canal en el que se encuentra registrado,

;devuelto por el script: scrbasefinal.agi
exten => _XXX,n,Dial(${CHANN}/${EXTEN},30,wm)

; En caso de que el nmero marcado no se encuentre habilitado en la

; PBX se manda al buzn de voz al llamante.
exten => _XXX,n,Voicemail(${EXTEN}@default,u)
exten => _XXX,n,Hangup()

;En caso de que la extensin marcada se encuentre ocupada, se le da la

;opcin al llamante de activar el callback marcando el nmero 6 a fin de
;que se le regrese la llamada en cuanto se encuentre disponible, pero

;sino lo activa se lo enva al buzn de voz indicndole que la extensin

;marcada se encuentra ocupada.
exten => _XXX,n(busy),Playback(rellamada)
exten => _XXX,n,Read(callbusy,,1,,1,5)
exten => _XXX,n,GotoIf($["${callbusy}" = "6"]?callfile)
exten => _XXX,n,VoiceMail(${EXTEN}@default,b)
exten => _XXX,n,Hangup()

;En caso de que se haya escogido la opcin de callback se realiza esta

;rutina para guardar las variables de canal necesarias: canales

de

;origen, destino, nmero del llamante y el nmero marcado en la base de

;datos AstDB.
exten =>
_XXX,n(callfile),Set(DB(channels/src)=${CHANNEL(channeltype)})
exten => _XXX,n,Set(DB(channels/id)=${CALLERID(num)})
exten => _XXX,n,Set(DB(channels/num)=${EXTEN})
exten => _XXX,n,AGI(scrbasefinal.agi,$
{DB(channels/num)}) exten =>
_XXX,n,Set(DB(channels/dst)=${CHANN})
exten =>
_XXX,n,Set(DB(channels/bandera)=1) exten
=> _XXX,n,Playback(colgar)

exten => _XXX,n,Hangup()

; La bandera nos indica que el callback ha sido activado.

exten => h,1,GotoIf($[${DB(channels/bandera)}=1]?h,2:h,3)

; Se invoca al macro que se encargar de la programacin y ejecucin

;del callback, envindole las variables almacenadas en la AStDB.
exten =>
h,2,Macro(internos,${DB(channels/dst)},${DB(channels/id)},${DB(channel
s/num)},${DB(channels/src)})
exten => h,3,Hangup()

;El contexto incoming se usa para especificar el tratamiento de

las

;llamadas entrantes desde fuera de la PBX.

[incoming]
exten => s,1,Answer()
exten => s,2,Background(intro1)
exten => s,2,Playback(bienvenida)
exten => s,3,WaitExten()

;Se incluye el contexto internal para que se ejecute todo lo detallado en

;ese contexto.
include => internal

;Esta macro se encarga de la programacin y ejecucin del callback

;segn las variables enviadas, creando el archivo .call y colocndole en
;el directorio respectivo.
[macro-internos]
exten => s,1,System(echo Channel:${ARG1}/${ARG3}>>
/tmp/callback${ARG3})
exten => s,n,System(echo Callerid:CallBack "<VozToVoice>" >>
/tmp/callback${ARG3})
exten => s,n,System(echo WaitTime:60 >> /tmp/callback${ARG3})
exten => s,n,System(echo Maxretries:10 >> /tmp/callback${ARG3})
exten => s,n,System(echo RetryTime:60 >> /tmp/callback${ARG3})
exten => s,n,System(echo Account: ${ARG2}>> /tmp/callback${ARG3})
exten => s,n,System(echo Application:Macro >> /tmp/callback${ARG3})
exten => s,n,System(echo Data: verify >> /tmp/callback${ARG3})
exten => s,n,GotoIf($[${GROUP_COUNT(OUTBOUND_GROUP@$
{ARG3})} >
1]?busy)
exten => s,n,System(mv /tmp/callback${ARG3}
/var/spool/Asterisk/outgoing)
exten => s,n(busy),Macro(internos,${ARG1},${ARG2},${ARG3},${ARG4})

;Esta macro se encarga de verificar si la extensin para la llamada de

;retorno se encuentra disponible para realizar el marcado respectivo, esta
;macro es invocada por el archivo
.call. [macro-verify]
exten => s,1,Set(GROUP(${DB(channels/id)})=OUTBOUND_GROUP)
exten => s,2,GotoIf($[${GROUP_COUNT(OUTBOUND_GROUP@$
{DB(channels/i d)})} > 1]?busy)
exten => s,3,GotoIf($[${DB(channels/src}=DAHDI]?
s,4:s,5) exten => s,4,Set(DB(channels/src)=DAHDI/4)
exten => s,5,Dial(${DB(channels/src)}/${DB(channels/id)})
exten => s,n(busy),VoiceMail(${DB(channels/id)}@default,b)

Los archivos que se mencionan en la aplicacin Playback fueron

grabados con la aplicacin Record del plan de marcado, son voces
grabadas por nosotros mismos, cuyos mensajes textualmente son los
siguientes:

bienvenida.gsm :Por favor digite el nmero de la extensin.

rellamada.gsm:Lo sentimos, en este momento la extensin se encuentra

ocupada. Si usted desea que le devolvamos la llamada presione la tecla
6.

colgar.gsm:La accin fue programada, ahora puede colgar.

Estos archivos deben estar situados en la ruta /var/lib/Asterisk/sounds,

en forma predeterminada se almacenan all.

3.1.6 Script de creacin y actualizacin de base de datos usuarios

Con este script escrito en php y colocado en la ruta /var/lib/Asterisk/agibin se crea una base de datos con mysql que contiene los usuarios sip e
iax que estn configurados en los archivos correspondientes. Se debe
reemplazar la contrasea de root (labtelecom09) por el propio del
servidor Asterisk.

actualiza_base.agi
#!/usr/bin/php -q
<?php
require '/var/lib/Asterisk/agi-bin/phpagi-2.14/phpagi.php';
$agi=new AGI();
function connect_db()
{
$db_connection = mysql_connect ('localhost', 'root', 'labtelecom09') or die
(mysql_error());
$sql1 = "DROP DATABASE IF EXISTS Asterisk";

mysql_query($sql1);
$sql = "CREATE DATABASE Asterisk";

mysql_query($sql);
$sql2="GRANT INSERT ON Asterisk.* TO Asterisk@localhost
IDENTIFIED BY 'labtelecom09'";
mysql_query($sql2);
$db_select = mysql_select_db('Asterisk') or die (mysql_error());
$sql3="DROP TABLE IF EXISTS `sip`";
mysql_query($sql3);
$sql4= "CREATE TABLE `sip` (`peer` varchar(80) NOT NULL default '')";
mysql_query($sql4);
$sql5="DROP TABLE IF EXISTS `iax`";
mysql_query($sql5);
$sql6="CREATE TABLE `iax` (`peer` varchar(80) NOT NULL default '')";
mysql_query($sql6);
$sql7="DROP TABLE IF EXISTS `dahdi`";
mysql_query($sql7);
$sql8="CREATE TABLE `dahdi` (`peer` varchar(80) NOT NULL default
'')";
mysql_query($sql8);
}
//Programa principal
connect_db();

$fichero = @fopen("/etc/Asterisk/sip.conf","r") or die("No se puede abrir el

archivo");
$query0="DELETE FROM sip";
mysql_query($query0) or die('Error, delete query failed'); while(!
feof($fichero)){
if(strcasecmp(fgetc($fichero),"[")==0){
$temp=fgetc($fichero);
$cadena="";
while(strcasecmp($temp,"]")!=0){
$cadena=$cadena.$temp;
$temp=fgetc($fichero);
}
if(strcasecmp($cadena,"general")!=0){
$query = "INSERT INTO sip VALUES ('$cadena')";
mysql_query($query) or die('Error, insert query failed');
}
}
}
fclose($fichero);
$fichero = @fopen("/etc/Asterisk/iax.conf","r") or die("No se puede abrir el
archivo");

$query0="DELETE FROM iax";

mysql_query($query0) or die('Error, delete query failed'); while(!

feof($fichero)){
if(strcasecmp(fgetc($fichero),"[")==0){
$temp=fgetc($fichero);
$cadena="";
while(strcasecmp($temp,"]")!=0){
$cadena=$cadena.$temp;
$temp=fgetc($fichero);
}//fin de while de concatenacion if(strcasecmp($cadena,"general")!=0)
{$query = "INSERT INTO
iax VALUES ('$cadena')";
mysql_query($query) or die('Error, insert query failed');
}//fin de if de insercin
}//fin de if de [
}//fin de while feof
fclose($fichero);
?>

3.1.7 Script para identificacin del canal destino del nmero marcado

Con este script escrito en php y colocado en la ruta /var/lib/Asterisk/agibin se busca el nmero marcado o extensin para determinar el canal al

que pertenece, es decir si se encuentra registrado como usuario sip o

iax, consultando la base de datos creada anteriormente, de manera que
se pueda establecer el canal de destino para marcar a dicha extensin
en el plan de marcado.

scrbasefinal.agi

#!/usr/bin/php -q
<?php
require '/var/lib/Asterisk/agi-bin/phpagi-2.14/phpagi.php';
$agi=new AGI();
function connect_db()
{
$db_connection = mysql_connect ('localhost', 'root', 'labtelecom09') or die
(mysql_error());
$db_select = mysql_select_db('Asterisk') or die (mysql_error());
}
function esSIP($cli){
$query1 = "SELECT peer FROM sip WHERE peer = '$cli' ";
$query_result1 = @mysql_query($query1);
$row_count = mysql_num_rows($query_result1);

$row1 = @mysql_fetch_array ($query_result1);

return $row_count;

function esIAX($cli){
$query1 = "SELECT peer FROM iax WHERE peer = '$cli' ";
$query_result1 = @mysql_query($query1);
$row_count = mysql_num_rows($query_result1);
$row1 = @mysql_fetch_array ($query_result1);
return $row_count;
}
//programa inicial
$cli1 = $argv[1];
connect_db();
if(esSIP($cli1)) { //registro ya existe en SIP
$temp="SIP";
}else if(esIAX($cli1)) {
$temp="IAX2";
}else {
$temp="";
}

$agi->set_variable("CHANN","1");
$agi->set_variable("CHANN","$temp");
mysql_close();

?>

3.1.8 Configuracin softphone X-Lite

Este softphone al igual que el zoiper tiene soporte para usuarios sip, la diferencia entre
ambos es que el zoiper tambin tiene soporte para usuarios iax. A continuacin se describe
como registrar un usuario sip en este softphone.

Instalacin de Asterisk
Descomprimimos el paquete de asterisk que descargamos en el captulo anterior.
tar -xzvf asterisk-1.8.9.1.tar.gz
cd asterisk-1.8.9.1/
Ejecutamos el comando ./configure con este comando se validarn las libreras y dependencias de nuestro servidor para
que asterisk pueda ser compilado
Ejecutamos make menuselect debe aparecer un mensaje como este:
Nota: Si llega a aparecer el siguiente mensaje Terminal must be at least 80 x 27 prueba ejecutando sobre la
terminal ctrl y el signo al tiempo para reducir el tamao de la fuente y darle espacio para que se pueda mostrar en
men de asterisk.
Aqu vamos a seleccionar los mdulos que cargaremos a Asterisk, por ahora nicamente vamos a ir a Core Sound Packages
y Extra Sound Packages, all habilitamos la opcin CORE-SOUNDS-ES-GSM y EXTRA-SOUNDS-ENGSM respectivamente (para seleccionar se utiliza la barra espaciadora).
Ahora presionamos ESC para salir y aparecer el siguiente mensaje:
Presionamos la tecla S para guardar y salir.

Instalar soporte para MP3

Instalamos subversion
apt-get install subversion
ejecutamos contrib/scripts/get_mp3_source.sh
Ejecutamos los siguientes comandos para compilar asterisk
-> compilamos con make
-> Instalamos programas y mdulos con make install
-> Instalamos los archivos de ejemplo de asterisk con make samples
-> Instalamos los scripts para que asterisk inicie con nuestro servidor tras los reinicios con make config
-> Instalamos logrotate para la rotacin de los logs make install-logrotate

Iniciamos el servicio Asterisk

/etc/init.d/asterisk start
Para verificar el estado del servicio ejecutamos:
/etc/init.d/asterisk status