La verdad me ha sorprendido mucho encontrarme con este programa porque no tenía la menor idea de su existencia y personalmente me parece muy bueno (además de Open Source).

MonAst es un panel de control para Asterisk que permite monitorear:

• Múltiples servidores Asterisk
• Extensiones SIP, IAX2, DAHDI
• Canales activos y llamadas
• Conferencias (Meetme)
• Llamadas parqueadas
• Colas de espera

En tiempo real permite:

• Originar una llamada
• Transferir las llamadas
• Colgar una llamada
• Parquear una llamada
• Espiar una llamada
• Invitar extensiones o números externos a una conferencia
• Sacar un usuario de una conferencia
• Añadir una extensión como agente a una cola de espera
• Quitar una extensión como agente de una cola de espera
• Poner en pausa un agente de una cola de espera
• Ejecutar comandos de la consola de Asterisk

En este articulo veremos como instalar el programa en una distribución CentOS 6.4. Como no hace falta instalar MonAst en el mismo servidor donde se encuentra Asterisk, se puede utilizar el mismo servidor Web que eventualmente ya se tiene disponible.

Una vez actualizado el sistema y reiniciado el servidor se instala el paquete de Python:

yum install python python-devel

Se instala Zope.Interface (versión 3.6 o superior):

cd /usr/src

wget --no-check-certificate https://pypi.python.org/packages/source/z/zope.interface/zope.interface-...

unzip zope.interface-4.0.5.zip

cd zope.interface-4.0.5

python setup.py install

Se continua con Twisted (versión 10.1 o superiores); primero se instala la dependencia gcc:

yum install gcc

cd /usr/src

wget --no-check-certificate https://pypi.python.org/packages/source/T/Twisted/Twisted-13.0.0.tar.bz2

tar -xf  Twisted-13.0.0.tar.bz2

cd Twisted-13.0.0

python setup.py install

Se sigue con StarPy:

cd /usr/src

wget http://downloads.sourceforge.net/project/starpy/starpy/1.0.0a13/starpy-1...

tar -xf starpy-1.0.0a13.tar.gz

cd starpy-1.0.0a13

python setup.py install

Para terminar, para la parte web, se instalan algunos paquetes PHP, el servidor WEB y el paquete php pear HTTP_Client:

yum install php php-cli php-common php-process php-pdo php-pear httpd

pear install HTTP_Client

Llegados a este punto, se descarga MonAST:

cd /opt

wget http://sourceforge.net/projects/monast/files/Monast%20for%20Asterisk%201...

Se descomprime:

tar -xf monast-3.0b4.tar.gz

Se entra en la carpeta creada:

cd monast-3.0b4

Se ejecuta el archivo de instalación:

./install.sh

Se selecciona la carpeta donde se instalará el programa y la parte web del programa. Como se puede ver en la imagen, el archivo de configuración se instalará en la carpeta /etc y se instalará también el demonio del programa en la carpeta /etc/init.d

Ahora lo único que hace falta es configurar el programa. Se abre el archivo de configuración:

nano /etc/monast.conf

Para empezar se modifica esta línea:

auth_required = false

para que quede:

auth_required = true

De esta forma para acceder a la pagina Web del panel de control, el sistema pedirá de autenticarse con nombre de usuario y contraseña que se definen al final de este archivo:

Se configura el primer servidor Asterisk, modificando este bloque:

[server: Server_1] # Server name can not contains space
hostname = 192.168.0.1
hostport = 5038
username = ami_username
password = ami_password

De forma que quede:

[server: VozToVoice]
hostname = IPAsterisk 
hostport = 5038
username = monast
password = sesamo

• server: nombre que se quiere asignar al servidor
• hostname: IP donde se encuentra Asterisk
• hostport: puerto para conectarse a la AMI de Asterisk
• username: usuario configurado en el manager.conf de Asterisk
• password: contraseña del usuario configurado en el manager.conf de Asterisk

En:

default_context = default

Se pone el nombre del contexto que se ha configurado para las extensiones

En:

transfer_context = default

Se pone el contexto para la transferencia de las llamadas

En:

meetme_context = default
meetme_prefix  = monast-

Se pone el contexto configurado para las conferencias y, si se quiere, un prefijo para la conferencias creadas desde MonAst.

Luego, si se quiere se añade un segundo servidor siguiendo las pautas para la configuración del primero. Al final del archivo se definen los usuarios que tienen acceso a la parte web. Para cada usuario se define nombre, contraseña, los permisos y los servidores a los que puede acceder. Un ejemplo:

[user: admin]
secret  = sesamo
roles   = originate,queue,command,spy
servers = ALL

Los permisos:

• originate: el usuario puede originar, transferir, parquear y colgar las llamadas
• queue: el usuario puede añadir, quitar, meter en pausa los agentes de una cola
• command: el usuario puede ejecutar comandos de la consola de Asterisk
• spy: el usuario puede espiar los canales activos

Se guardan los cambios y se configura el manager.conf de Asterisk:

nano /etc/asterisk/manager.conf

se modifica esta línea:

enabled = no

Para que quede:

enabled = yes

y al final del archivo se añade el usuario configurado en el MonAst:

[monast]
secret=sesamo
writetimeout=100
read=system,call,log,verbose,command,agent,user,config,originate,reporting
write=system,call,log,verbose,command,agent,user,config,originate,reporting

Se guardan los cambios y se reinicia Asterisk.

service asterisk restart

Se inicia el servidor Web:

service httpd start

Se vuelve a la carpeta /opt/monast y se inicia el programa:

./monast.py

Si no aparecen errores significa que el programa se ha conectado correctamente al AMI de Asterisk. Se abre un navegador web y se pone la dirección IP del servidor WEB:

http://IPservidorWeb

Nos autenticamos con nombre de usuario y contraseña definidos en el archivo monast.conf:

Los menú disponibles:

Las extensiones/troncales configuradas con las llamadas activas.

Si se quiere personalizar el output del panel Web, se modifica el archivo:

nano /var/www/html/lib/config.php

Una vez que tenemos certeza que el programa funciona bien, se sale de la consola de MonAst con CTRL-C y se inicia el demonio:

/etc/init.d/monast start

Por ahora es todo.