PDF de programación - Asterisk 1.4 y FreePBX 2.3

Asterisk 1.4 y FreePBX 2.3



Por Julio Gómez López y Francisco Gil Montoya
Universidad de Almería
Diciembre de 2.007



Versión 1.1

Índice

ASTERISK 1.4 Y FREEPBX 2.3

ÍNDICE

ÍNDICE DE FIGURAS

1. PASOS PREVIOS CON DEBIAN ETCH

1.1. DESHABILITAR FIREWALL Y SELINUX
1.2. ACTUALIZACIÓN DEL SISTEMA
1.3.

INSTALACIÓN DE DEPENDENCIAS NECESARIAS PARA COMPILACIÓN

2.

INSTALACIÓN DE ASTERISK

INTRODUCCIÓN
INSTALACIÓN DE DEPENDENCIAS

2.1.
2.2.
2.2.1. ZAPTEL
2.2.2. LIBPRI
2.2.3. ASTERISK
2.2.4. ASTERISK-ADDONS
2.3. CONFIGURACIÓN

3.

INSTALACIÓN DE FREEPBX (AMPORTAL)

INSTALACIÓN Y CONFIGURACIÓN DE MYSQL

INICIO DE SERVICIOS

3.1. DEPENDENCIAS
3.2.
3.2.1.
3.2.2. CREACIÓN Y CONFIGURACIÓN DE LA BASE DE DATOS
3.3.
3.4.
3.5.

INSTALACIÓN Y CONFIGURACIÓN DE APACHE
INSTALACIÓN DE FREEPBX (AMPORTAL)
INICIO DE FREEPBX

4. VARIOS

4.1. PONER CONTRASEÑA DE ACCESO AL SERVIDOR DE APACHE
4.2. CAMBIO DE CONTRASEÑA PARA EL ASTERISK MANAGER
4.3. MANEJO DE FOP



1

II

3

3

3
3
3

4

4
4
4
5
6
7
7

8

8
9
9
9
10
11
12

12

12
13
13

ii

1. Pasos previos con Debian ETCH

1.1. Deshabilitar firewall y selinux

El uso del firewall y SELinux está poco documentado en la red, aunque se ha constatado
que presenta incompatibilidades con FreePBX. Nosotros seguiremos esta directriz durante el
proceso de integración de Asterisk™ y FreePBX.

El componente SELINUX puede deshabilitarte durante el proceso de instalación o bien,

si ya lo tenemos instalado en el sistema, se deberá modificar el fichero /etc/selinux/config


SELINUX=disabled
SELINUXTYPE=targeted


Al objeto de no tener problemas en el proceso de instalación del sistema, vamos a

deshabilitar el cortafuegos iptables ejecutando:


iptables –F


y guardamos la configuración:


iptables-save > /etc/iptables.up.rules



Una vez instalado y configurado Asterisk y FreePBX, volveremos a activar iptables para

proteger correctamente el sistema.
1.2. Actualización del sistema

Antes de iniciar el proceso de instalación actualizamos el sistema


apt-get update
apt-get upgrade



1.3.

Instalación de dependencias necesarias para compilación

A lo largo del proceso de instalación, necesitaremos compilar una serie de paquetes, por
lo que nos los iremos descargando a medida que sean necesarios. Inicialmente, instalaremos los
siguientes:


apt-get install linux-headers-<version>


apt-get install gcc



;sustituir <version> por la
;salida del comando uname -r


;Compilador gcc

3





apt-get install g++

apt-get install make

apt-get install libnewt-dev
apt-get install libncurses5-dev
apt-get install openssl


apt-get install libssl-dev
apt-get install zlib1g-dev



apt-get install bison
apt-get install flex



;Compilador c++
;
;
;Librerias para ncurses
;Librerias para openssl
;
;Librerías para zlib
;Analizador sintáctico
;

2.

Instalación de Asterisk

2.1.

Introducción

Asterisk es una aplicación software libre de una central telefónica (PBX). Como
cualquier PBX, se puede conectar un número determinado de teléfonos para hacer llamadas
entre sí e incluso conectar a un proveedor de VoIP o bien a una RDSI tanto básicos como
primarios.

Asterisk incluye muchas características anteriormente sólo disponibles en caros sistemas
propietarios PBX: buzón de voz, conferencias, IVR, distribución automática de llamadas, y otras
muchas más. Los usuarios pueden crear nuevas funcionalidades escribiendo un dialplan en el
lenguaje de script de Asterisk o añadiendo módulos escritos en lenguaje C o en cualquier otro
lenguaje de programación soportado por Linux.

Para instalar Asterisk vamos a realizar los siguientes pasos:

Descargamos e instalamos dependencias necesarias para compilación.
Descargamos e instalamos los paquetes Zaptel, Asterisk y Libpri.
Descargamos e instalamos el paquete opcional Asterisk-Addons (necesario, entre

otras cosas, para la integración con mysql)

Finalmente configuramos todos los paquetes, incluyendo Asterisk.
Instalación de dependencias

2.2.

A continuación realizamos la instalación de todas las dependencias

2.2.1. Zaptel

El módulo Zaptel tiene sus orígenes en el API desarrollado por Jim Dixon para un
sistema hardware de telefonía abierto. Los primeros drivers Zaptel fueron lanzados para BSD y
para la tarjeta DIY T1, de la serie Tormenta, de Jim Dixon. Posteriormente, Digium prosiguió
con el trabajo de Dixon y mejoró el driver Zaptel usando Linux como plataforma. Digium siguió

4

mejorando el driver Zaptel para otros diseños hardware de telefonía, que han acabado en la
integración de diversas tarjetas PCI con el sistema Asterisk.

De esta forma, Zaptel ha quedado como el driver utilizado por Asterisk (bajo Linux) para

integrar el hardware de telefonía.

Si se dispone de hardware de telefonía, la instalación del paquete Zaptel será necesaria
para poder utilizar el mismo. Si no se dispone de dicho hardware, será conveniente también,
para poder utilizar los servicios dependientes de fuentes de tiempo, como el servicio de
conferencia, etc.

Descargamos Zaptel ejecutando el comando


wget http://downloads.digium.com/pub/zaptel/zaptel-1.4-current.tar.gz


lo descomprimimos


tar zxvf zaptel-1.4-current.tar.gz
cd zaptel-1.4.7.1
en


la



;al descomprimir se deberá ingresar
;el directorio correspondiente según
;versión disponible en ese momento

y finalmente lo instalamos ejecutando


./configure
make
make install


Si tenemos algún tipo de hardware instalado ejecutamos


make config



Mediante este comando generaremos unos scripts de inicialización.

2.2.2. Libpri

Libpri es una implementación en lenguaje C, de la especificación ISDN para primarios.
Está basada a su vez en la especificación SR-NWT-002343 de Bellcore. Se utilizarán si
disponemos de hardware telefónico digital ISDN.

Descargamos Libpri,


wget http://downloads.digium.com/pub/libpri/libpri-1.4-current.tar.gz


lo descormprimimos,

5


tar xvfz libpri-1.4-current.tar.gz
cd libpri-1.4.3



y lo instalamos:


make
make install


2.2.3. Asterisk

Descargamos Asterisk


wget
current.tar.gz

http://downloads.digium.com/pub/asterisk/asterisk-1.4-


lo descomprimimos

tar xvfz asterisk-1.4-current.tar.gz
cd asterisk-1.4.16



y ejecutamos


./configure


Para personalizar los componentes que se van a instalar ejecutamos


make menuselect



y finalmente ejecutamos


make
make install


Una vez instalado el sistema podemos ejecutar make samples para generar los ficheros

de configuración del sistema (por ejemplo, sip.conf, iax.conf, etc).


make samples



Y de forma opcional, si queremos generar documentación adicional sobre Asterisk,

ejecutamos

6


make progdocs



2.2.4. Asterisk-Addons

Descargamos Asterisk-Addons


wget http://downloads.digium.com/pub/asterisk/asterisk-addons-1.4-
current.tar.gz


Descomprimimos Asterisk-Addons

tar zxvf asterisk-addons-1.4-current.tar.gz
cd asterisk-addons-1.4.5



En el caso de que no se vaya a utilizar el paquete FreeBPX, omitir el siguiente paso


perl
D_GNU_SOURCE\nCFLAGS+=-DMYSQL_LOGUNIQUEID/' Makefile


-i.bak

-p

-e

's/CFLAGS.*D_GNU_SOURCE/CFLAGS+=-

Para que no se produzcan errores con el cliente de mysql, es necesario instalar el

siguiente paquete,


apt-get install libmysqlclient15-dev
de



;necesario para la integración
;los cdr’s en mysql



Y finalmente para instalar el paquete ejecutamos:

./configure
make
make install


2.3. Configuración

En la bibliografía suele ser frecuente modificar la carpeta de trabajo de Asterisk, pasando

de /var/run a /var/run/asterisk

Si se opta por esta estrategia, se ha debido ejecutar el comando make samples. En este

caso, se debe realizar lo siguiente


mkdir /var/run/asterisk


7

y además, se debe modificar el fichero /etc/asterisk/asterisk.conf


astrundir => /var/run/asterisk


Además, para mejorar el funcionamiento del sistema es recomendable que la carpeta
/var/run/asterisk pertenezca al usuario asterisk. Creamos el grupo asterisk y el usuario
asociado al servicio asterisk:


groupadd asterisk
useradd -c "asterisk PBX" -d /var/lib/asterisk -g asterisk asterisk



Es posible que el sistema nos informe (mediante algún warning) de que la carpeta

/var/lib/asterisk ya existe.

Si desea comprobar que el usuario se ha creado correctamente, se puede ver el contenido

del fichero /etc/passwd ejecutando el comando less /etc/passwd

Finalmente, asignamos los permisos correspondientes a la carpeta /var/run/asterisk:


chown asterisk /var/run/asterisk ;cambia el usuario
;propietario de la carpeta
chgrp asterisk /var/run/asterisk
chmod 770 /var/run/asterisk
;grupo tienen los permisos


;cambia el grupo propietario
;establece que el usuario y



3.

Instalación de FreePBX (Amportal)

El paquete FreePBX (http://www.freepbx.org) es un interfaz web, realizado en lenguaje

php que interactúa con Asterisk para su configuración.

Para su instalación, descargamos el paquete:


wget
2.3.1.tar.gz

http://easynews.dl.sourceforge.net/sourceforge/amportal/freepbx-

y lo descomprimimos


tar zxvf freepbx-2.3.1.tar.gz


3.1. Dependencias

;en nuestro caso, versión 2.3.1



Deberemos descargar e instalar los siguientes paquetes, según se especifica en el

documento de inst