Manual de Instalación 
 

10-09-2018 
─ 

OMniLeads  
The Open Source Contact Center 
 

www.omnileads.net - omnileads ® 2018 

Manual de instalación OMniLeads - Pag 1  

Índice 
Introducción …………………………………………………………………………………….…………………… 2 
Ansible In One: instalación modelo self-hosted ……………………………………………………… 3 
Ansible in Two: instalación modelo cliente-servidor ………………………………………………. 7 
Configuración de Wombat Dialer para campañas predictivas ………………………………...9 
 
 

   

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 2  

Introducción 
El  presente  documento  constituye  el  manual  oficial  de  instalación  de  la  plataforma 
OMniLeads (desde ahora OML).  
 
OMniLeads puede ser desplegado sobre los siguientes sistemas operativos: 
 
-G​ NU/Linux CentOS 7 en su versión minimal 
-G ​ NU/Linux Debian 9 en su versión netinstall 
 
Los  pasos  que  componen  este  procedimiento  generan  una  instalación  All  In  One  (AIO),  es 
decir con todos los componentes de OML desplegados sobre un host.  
Si  bien  existe  la  posibilidad  de  correr  ciertos  componentes  en  hosts  exclusivos 
(escalabilidad horizontal), no se cubre en este manual. 
 
La  herramienta  seleccionada  tanto  para  instalar  OML  como  para correr las actualizaciones 
es: ​Ansible​.  
 
La instalación puede llevarse a cabo bajo dos escenarios: 
 
1. Ansible  In One: lo que requiere es ejecutar la instalación corriendo Ansible en/desde 
la misma máquina donde se quiere instalar OML. 
 
2. Ansible  In  Two:  lo  que  requiere  es  ejecutar  la  instalación  corriendo  Ansible  en  su 
entorno  de  trabajo  (deployer)  e  indicando  en  el  instalador  la  IP  del  host  donde  se 
desea instalar OML (deployed). 
 
En esta guía desplegamos ambas opciones.  
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 3  

Instalación de OML utilizando Ansible In One 

Pre-requisitos en la máquina a instalar: 

Se deben disponer de 20 GB como mínimo para poder desplegar OML en cualquier equipo. 
Recomendaciones para ambientes de producción: 

Instalación y Configuración básica sobre CentOS 7: 

 
Efectuar la instalación de Centos7 minimum install. Los archivos ISO pueden obtenerse 
fácilmente desde la página oficial del proyecto: https://www.centos.org/download/. 
Es imprescindible tener disponible antes de comenzar: 
1. Un usuario “omnileads “ con contraseña en el servidor y privilegios sudo.  
Para ello realizamos los siguientes pasos:  
 
useradd omnileads -d /opt/omnileads -m -s /bin/bash 
passwd omnileads 
- ​ingresar contraseña al usuario omnileads   
- editar el archivo /etc/sudoers para que agregar el usuario omnileads: 
- agregar la linea: ​ omnileads  ALL=(ALL)  ALL 
2. Asegurarse de tener correctamente configurado la IP del servidor, los DNS y su 
hostname (ver ​este post​ en caso de dudas​) 
3. Realizar un update al server para asegurarnos que tenemos todas las 
actualizaciones del sistema operativo al día:  
yum update 
4. Tener instalada la última versión del kernel del SO. Si es Centos7, el ultimo kernel 
estable a la fecha de realización del presente documento es 
3.10.0-862.9.1.el7.x86_64 
yum install kernel-devel kernel-headers 
5. Instalar el repositorio epel-release 
yum install epel-release 
6. Instalar git y pip para poder clonar el repo e instalar ansible, para Centos7 
yum install python2-pip git 
7. Reboot al server para levantarlo con el último kernel instalado 
reboot 
IMPORTANTE:​ Recuerde setear correctamente la hora local en su sistema operativo. 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 4  

Instalación y Configuración básica sobre Debian9: 

Efectuar la instalación de Debian 9 minimum install.  
 
Es imprescindible tener disponible antes de comenzar: 
1. Un usuario “omnileads “ con su contraseña en el servidor y privilegios de sudo.  
Para ello realizamos los siguientes pasos:  
useradd omnileads -d /opt/omnileads -m -s /bin/bash  
passwd omnileads 
- Instalar la utilidad sudo:  
apt-get install sudo 
- editar el archivo /etc/sudoers para que agregar el usuario omnileads: 
- agregar la linea: ​ omnileads  ALL=(ALL)  ALL 
 
2. Asegurarse de tener correctamente configurado la IP del servidor, los DNS y su 
hostname 
 
3. Realizar un update al server:  
apt-get update -y && apt-get upgrade -y 
 
4. Realizar un reboot del equipo 
reboot 
5. Tener instalado los headers de la última versión del kernel del SO. 
apt-get install -y linux-headers-$(uname -r) -y 
6. Instalar git y pip para poder clonar el repo e instalar ansible 
apt-get install python-pip git -y 
 
 
 
 
 
 
 
 
 
 
 
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 5  

Clonado del repositorio Omnileads 

 
Una  vez  listo  el  trabajo  preliminar  sobre  el  Host  (sistema  operativo  seleccionado),  se 
prosigue con la instalación. 
 
Con el usuario ​omnileads​, posicionarse sobre el directorio: /var/tmp: 
 
su - omnileads 
cd /var/tmp 
 
Y una vez allí, se ejecutan los siguientes comandos para clonar el repositorio. 
 
git clone https://gitlab.com/omnileads/ominicontacto.git 
cd ominicontacto 
git fetch 
git checkout master 
 

Ejecución del instalador 

La  instalación  de  OML  se  realiza  mediante el script ​deploy.sh​, ubicado dentro de la carpeta 
ansible en el repositorio.  
cd /var/tmp/ominicontacto/deploy/ansible/ 
 
Dicho script cuenta con un pequeño manual de ayuda al que se puede acceder ejecutando 
el comando: 
 
./deploy.sh -h  
 
Antes  de  ejecutar  el  comando  de  instalación  es  muy  importante  que  se  lean 
detenidamente  las  definiciones  que  deben  ser  realizadas  por  el  usuario  durante  y 
después de correr el script. 
 
Para realizar una instalación por defecto, correr el comando de la siguiente manera: 
./deploy.sh -r ​$release​ -i -t all 
 
Donde $release es la versión que se desea instalar (por ejemplo master, develop, etc.) 
Asumiendo que se va a instalar la última versión estable: 
./deploy.sh -r master -i -t all 
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 6  

A  continuación,  mientras  se  ejecutan  las  órdenes  del  script,  se  solicitará  que  el  usuario 
complete una serie de parámetros de manera interactiva: 
 
- sudo password: s​ e debe ingresar​ ​la contraseña del ​usuario omnileads. 
-  contraseña  de  superuser  de  Omnileads:  es  la  contraseña  del  usuario  “admin”  del 
sistema. El valor por default es toor123. 
-  formato  de  grabaciones:  ​es  el  formato  que  OML  utilizará  para  almacenar  las 
grabaciones.  El  valor  por  default  es  mp3.  Presionar  enter  para  dejar  este  valor por default 
o bien tipear el formato deseado (Importante: la aplicación soporta sólo los formatos wav o 
mp3). 
 
NOTA:  si  se  ingresa  mal  la  contraseña  o  si  no  pasa  las  validaciones  correspondientes 
(números y letras o caracteres especiales) es necesario volver a correr el script. 
NOTA  2:  ​el  script  pregunta  si  se  desea  levantar  asterisk  con  container.  Al  darle  en  sí, hace 
que  asterisk  sea  levantado  usando  Docker.  Recomendamos  ​NO  Dockerizar  asterisk  para 
entornos de producción pues todavía este desarrollo se encuentra en fase de testing.  

Figura 1: Ejemplo de interfaz solicitando parámetros de instalación 

 
 
El  tiempo  de  instalación dependerá mayormente de la velocidad de conexión a internet del 
host  OML,  ya  que  se  deben  descargar,  instalar  y  configurar  varios  paquetes 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 7  

correspondientes  a  los  diferentes  softwares  que  integran  la  aplicación.  Dicho  proceso 
puede demorar varios minutos. 
 
Al  finalizar,  proceda  con  un  reboot  en  el  server  (deployed)  y  luego  podrá  ir  a  la  sección 
“Primer Acceso a Omnileads” para efectuar los últimos pasos de post-instalación. 
sudo reboot  
IMPORTANTE:  en  caso  de  que  el  proceso  de  instalación  de  OML  se  interrumpa  (por  fallas 
de internet, fallas locales del servidor ajenas al software, etc.), debe ejecutar nuevamente el 
script de instalación. 

Ansible In Two 

Pre-requisitos en el server a deployar (deployed) 

 
Debe tener instalada una distribución de CentOS 7 o Debian 9.  
 
CentOS 
 
Un usuario “omnileads “ con contraseña en el servidor y privilegios sudo.  
Para ello realizamos los siguientes pasos:  
 
useradd omnileads -d /opt/omnileads -m -s /bin/bash 
passwd omnileads 
- ​ingresar contraseña al usuario omnileads   
- editar el archivo /etc/sudoers para que agregar el usuario omnileads: 
- agregar la linea: ​ omnileads  ALL=(ALL)  ALL 
 
Configurar hostname. 
 
Debian  
 
Un usuario “omnileads “ con su contraseña en el servidor y privilegios de sudo.  
Para ello realizamos los siguientes pasos:  
useradd omnileads -d /opt/omnileads -m -s /bin/bash  
passwd omnileads 
- Instalar la utilidad sudo:  
apt-get install sudo 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 8  

- editar el archivo /etc/sudoers para que agregar el usuario omnileads: 

- agregar la linea: ​ omnileads  ALL=(ALL)  ALL 
 
Configurar hostaname. 
 
Luego  de  realizar  los  pasos  en  el  host  a  deployar  desde  el  deployer,  se  avanza  con  el 
clonado  del  repositorio  en  la  máquina  deployer  y  posterior  ejecución  de  la  instalación 
sobre el server (deployed). 

Procedimiento en la máquina deployer. 

 
El método de instalación deployer-deployed está homologado utilizando Debian 9 y 
Ubuntu 18.04 cómo Ansible deployer. 
 
En nuestra máquina deployer, se debe instalar, pip, git y ansible. 
 
apt-get install python-pip git -y 
 
Clonado de repositorio 
 
Procedemos entonces con los siguientes comandos: 
git clone https://gitlab.com/omnileads/ominicontacto.git 
cd ominicontacto 
git fetch 
git checkout develop 
 
Ejecución del instalador 
Para  comenzar  la  instalación  hay  que  ejecutar  el  script  ansibleintwo.sh  que  se  encuentra 
dentro  de  la  carpeta  ansible  en  el  repositorio. Ejecutarlo con el usuario con el que se clonó 
el repositorio. A continuación se explican las opciones que tiene el script: 
cd deploy/ansible 
./ansibleintwo.sh 
Este script setea la configuración de ansible para pasar a un esquema deployer - deployed. 
A continuación, se solicitará que el usuario complete una serie de parámetros a ingresar 
de manera interactiva. Los mismos son: 
 
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 9  

 
Figura 2: instalación OML Método Deployer-Deployed 
 
 
-IP: e
​ s la IP de la máquina a deployar 
-Rama a deployar: ​ingresa la rama a deployar para pasarle al deploy.sh 
- Tag de ansible: ​ingresa el tag de ansible para pasarle al deploy.sh (tags comunes: all y 
postinstall) 
 
Luego comienza la ejecución del deploy.sh, descrito en el item Ansible In One 
 
Al  finalizar,  proceda  con  un  reboot  en  el  server  (deplyed)  y  luego  podrá  ir  a  la  sección 
“Primer Acceso a Omnileads” para efectuar los últimos pasos de post-instalación. 
 

Primer acceso a OMniLeads 

 
Para acceder al sistema OMniLeads debe ingresar a: 
 
https://​direccion_ip_oml 
 
Al  encontrarnos  con  la  pantalla  de  login,  simplemente  se  debe  ingresar el usuario admin y 
la clave generada durante la instalación, como se expone en las figura X y Z. 
 
 
 
 
 
 
 
 
 
 
 
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 10  

 
Figura 3: pantalla de login OML 
 

 
 
Figura 4: Primer acceso a OML 
 
 
 
 
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 11  

Configuración Wombat Dialer 

 
Antes  que  nada  se  notifica  que  si  la  instancia  de  OML  desplegada  en  los pasos anteriores, 
NO  contemplan  el  uso  de  campañas  con  discado  saliente  predictivo,  este  paso  puede  ser 
omitido. 
 
El  core-dialer  de  OML  es  un una herramienta basada en licencias e incorporada de manera 
opcional.  Este  dialer  se  llama  Wombat  Dialer  (propiedad  de  Loway  -  loway.com) y como se 
mencionó,  es  el  componente  encargado  de  discar  registros  de  manera 
progresiva/predictiva.  
 
Si  se  desean  correr  campañas  predictivas,  se  debe  generar  la  siguiente  configuración 
básica de Wombat Dialer . Esto se consigue ingresando a la dirección IP del host OML. 
 
http://direccion_ip_oml_host:8080/wombat 
 
Al  ingresar  se  despliega  una  pantalla  como  la  siguiente,  donde  deberá  presionar  los 
botones indicado en la imagen. 
 
Se  debe  proceder  con  la  creación  de  la  base  de  datos  para  Wombat  Dialer.  Hacer  click  en 
botón remarcado en la figura 4. 
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 12  

 
 
Figura 5:​ Crear base de datos Wombat Dialer

 
Luego es el momento de ingresar la clave del usuario root de MySQL y hacer click en botón 
remarcado en la figura 6. 
 
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 13  

Figura 6: Crear base de datos Wombat Dialer

Una  vez  creada  la  base  de  datos  MySQL  que  utiliza  Wombat  Dialer,  se  procede  con  el 
primer login. 

Figura 7: Crear base de datos Wombat Dialer 

A  continuación  se  debe  realizar  un login en la interfaz de administración de Wombat Dialer 

para avanzar con la configuración de parámetros necesarios para la interacción con OML.  
 
Usuario: demoadmin  
Pass: demo 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 14  

Figura 8: Login en Wombat Dialer 

 
Para  ello  simplemente  se  debe  seguir  paso  a  paso,  la  configuración  expuesta  en  las 
siguientes figuras: 8, 9, 10 y 11. 

Figura 9: Configuración de base WD 

En este paso debeŕa ingresar la contraseña AMI ingresada en la instalación. El usuario es:
omnileadsami​ y en caso de de haber dejada la contraseña por defecto (​5_MeO_DMT)​ .

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 15  

Figura 10: Configuración de base WD - Asterisk server 

 
En el siguiente punto, se configura una Troncal utilizando un “Nombre de la troncal” 
arbitrario, pero con la cadena de llamado marcada en la figura. ​Local/${num}@from-oml/n 
 

Figura 11: Configuración de base WD - Troncal 

Finalmente debemos observar que nuestra configuración luzca como la figura 12.

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 16  

Figura 12: Configuración de base WD - Resultado final 

 
Por último, recuerde dar “play” al servicio de dialer, tal como lo indica la siguiente figura: 
 

 
Figura 13: Iniciar el Marcador. 
 

www.omnileads.net - OMniLeads ® 2018 

 
Manual de instalación OMniLeads - Pag 17  

Finalmente la plataforma se encuentra habilitada para gestionar llamadas predictivas. La 

instalación por defecto cuenta con una licencia de Wombat Dialer demo de un canal 
Recuerde acceder a la página del fabricante y comprar canales de discador dependiendo 
de sus necesidades (https://www.wombatdialer.com/purchase.jsp). 

www.omnileads.net - OMniLeads ® 2018