Este artículo describe los pasos básicos de instalación para desplegar una pasarela WebRTC. Tenga en cuenta que deberá consultar los documentos de comunicación técnica de OmniPCX Enterprise u OXO Connect para conocer la configuración necesaria que debe realizarse en el lado PBX.
Requisitos
- Los usuarios de Rainbow necesitan que se les conceda una licencia Business o Enterprise y una licencia Enterprise obligatoria cuando estén conectados a una PBX de terceros.
- La centralita OmniPCX Enterprise necesita:
- funcionar con la versión de SW OmniPCX Enterprise a partir de R12.1 MD2(M2.300.21.a) y OmniPCX Enterprise R12.2(M3.402.13.f).
- a conceder con licencias REX por usuario Rainbow objetivo
- estar conectado a Rainbow para los servicios de telefonía
- Debe configurarse una Máquina Virtual para albergar el Gateway Rainbow WebRTC. El software de la VM es suministrado por ALE y requiere un VMWARE 6.0 o posterior o en Hyper-V G1 o G2 o en Nutanix. La VM tiene que cumplir los siguientes requisitos mínimos que aún pueden cambiar:
- vCPU: 2
- Reserva de CPU en MHz: 4800
- vRAM: 2 GB
- vDISK: 4 GB
- vNIC: 1 GB
- OXO Connect PBX necesita
- para funcionar con la última versión de SW de OXO Connect(R4.0/536.001 ; R5.2/064.001 ; R6.1/023.001 o superior)
- funcionar con R4.0/536.001 ; R5.2/064.001 ; R6.1/023.001 o superior utilizar un Front End OCE como pasarela WebRTC
- que se le conceda un Terminal AnyDevice por usuario Rainbow objetivo
- estar conectado a Rainbow para los Servicios de Telefonía
- disponer de Canales de información VoIP para el troncal SIP
- En el caso del OXO Connect, también puede alojar la pasarela Rainbow WebRTC en un PC independiente. Lea la guía de instalación dedicada para más detalles. O en un OCE WebRTC Front End (OCE FE) que es un hardware OCE que ejecuta únicamente el componente WebRTC Gateway. Lea el artículo dedicado para la configuración del OCE FE a través de Rainbow.
Encontrará más detalles sobre la oferta Rainbow conectada a un OmniPCX Enterprise u OXO Connect/OXO Connect Evolution en la siguiente presentación técnica de Business Engine.
- PBX de terceros necesita
- funcionar con la última versión de Rainbow CTI & Media bridge
- estar conectada a Rainbow para los servicios de telefonía mediante el puente CTI & Media
- tener una troncal SIP conectada con el puente CTI & Media
- Consulte la sección Puente CTI & Medios para conocer otros requisitos y las centralitas compatibles
Instalación OVF/ISO de la pasarela WebRTC
Descarga del software
Instalación
Primero despliegue el archivo OVF en su vCenter e inicie la máquina virtual (VM) o si está conectado a un OXO Connect instale el archivo ISO en un PC independiente(guía de instalación).
Configuración del teclado
El OVF y el ISO se han creado con un teclado QWERTY, puede que necesite cambiarlo:
Inicie sesión con las siguientes credenciales:
User=kb
Password=kb
El asistente para cambiar el teclado se iniciará automáticamente, sólo tiene que seguir las instrucciones que aparecen en pantalla para cambiar su teclado.
También puede acceder al mismo menu utilizando los siguientes comandos:
# dpkg-reconfigure keyboard-configuration
# service keyboard-setup restart
Configuración
Para configurar la pasarela WebRTC tendrá que iniciar sesión con las siguientes credenciales en la consola:
User=rainbow
Password=Rainbow123
Para los comandos root debe utilizar "sudo".
Configuración de la pasarela WebRTC
Al iniciar sesión con la cuenta Rainbow, la configuración se realiza mediante los comandos mpnetwork [opciones...] y mpconfig [opciones...].
mphelp //muestra la lista de comandos mpXXXXX//
mpstart|mpstop|mprestart //inicia, detiene o reinicia la puerta de enlace//
mpcheck //comprueba la conectividad de la pasarela WebRTC con Rainbow Cloud//
Primera Instalación
Primero debe configurar los ajustes de red y después los ajustes de la pasarela WebRTC.
Por defecto, la puerta de enlace Rainbow WebRTC se inicia utilizando una configuración de red basada en DHCP (DHCP sólo debe utilizarse con el OXO Connect Zero Touch).
Inicie sesión con la cuenta Rainbow para realizar la configuración.
Paso 1 - Configuración de la red
Consulte primero ¿Cuáles son los requisitos de la red Rainbow?
La 1ª vez tiene que ejecutar el comando mpnetwork con las opciones obligatorias IP, NETMASK, GATEWAY y DNS como se muestra a continuación:
mpnetwork --IP="10.2.3.4" --NETMASK="255.255.255.0" --GATEWAY="10.2.3.254" --DNS="10.2.3.253"
También puede ejecutar para este 1er paso el comando mpnetwork con todas las opciones añadiendo NTP y HOSTNAME
mpnetwork --IP="10.2.3.4" --NETMASK="255.255.255.0" --GATEWAY="10.2.3.254" --DNS="10.2.3.253" --NTP="10.2.3.253" --HOSTNAME="rainbow-mpgw"
opcionalmente puede añadir las siguientes opciones
--HOSTDOMAIN="miempresa.com"
--PROXY="http://user:pass@10.2.3.252:8000/"
o
--PROXY="http://10.2.3.252:8000/"
En caso de que necesite actualizar la configuración, cada comando puede ejecutarse por separado
mpnetwork --IP="10.2.3.4" // su nueva dirección ip de la VM //
mpnetwork --NETMASK="255.255.255.0"
mpnetwork --GATEWAY="10.2.3.254" // su puerta de enlace //
mpnetwork --DNS="10.2.3.253" // su DNS //
Para 2 DNS utilice el siguiente comando mpnetwork --DNS="10.2.3.253", "10.2.3.252"
mpnetwork --NTP="10.2.3.253"
mpnetwork --HOSTNAME="rainbow-mpgw"
mpnetwork --IP=dhcp // si desea cambiar la configuración IP al modo DHCP (sólo con OXO Connect Zero Touch) //
también puede utilizar
mpnetwork --FQDN="rainbow-mpgw.miempresa.com"
Paso 2 - Configure la pasarela WebRTC:
La 1ª vez tiene que ejecutar el comando con las opciones obligatorias DOMINIO_PABX y PBXID como se muestra a continuación:
mpconfig --PBX_DOMAIN="10.2.3.5" --PBXID="PBXa1b1-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-c1d1"
PBX_DOMAIN= es su dirección ip de OXE/OXO
PBXID= es su pbxid de OXE/OXO en Rainbow
La pasarela WebRTC recupera una lista de todos los servidores TURN disponibles y también un TTL (time to live) del backend después de cada reinicio. Los 2 primeros servidores TURN de la lista serán utilizados por la pasarela WebRTC. Antes de que expire el TTL (actualmente 8 horas) la pasarela WebRTC recupera una nueva lista del backend.
- En caso de actualización desde una versión en la que TURN estaba configurado para 1 servidor TURN específico recomendamos ejecutar el siguiente comando:
mpconfig --TURN_SERVER=GEOIP
opcional puede utilizar FQDN en lugar de direcciones IP
mpconfig --RAINBOW_DOMAIN="dominio.yy.zz"
mpconfig --RAINBOW_HOST="host.uu.vv"
- PBX_DOMAIN puede ser un FQDN (en este caso el DNS utilizado por la pasarela WebRTC debe resolver este FQDN)
- En caso de redundancia espacial desde servidores de llamadas OXE, el PBX_DOMAIN debe contener el nombre de nodo configurado en netadmin, sección 17. 'Configuración del nodo'. Este FQDN debe ser resuelto por el DNS a través de una delegación DNS al sistema OXE.
Paso 3 - Comprobar la configuración
Una vez reiniciado el servidor, puede ejecutar el comando mpcheck para comprobar la conectividad con Rainbow Cloud.
Archivos de configuración
Una vez que el servidor se haya reiniciado puede ejecutar el comando mpshow la configuración.
Cambiar la configuración de red a DHCP (Sólo con OXO Connect Zero Touch)
ejecute el comando
mpnetwork --IP=dhcp
opcionalmente puede añadir un proxy
mpnetwork --PROXY="user:pass@10.1.2.252:8000/"
Después de la modificación reinicie el servidor con el comando sudo reboot
Configuración de la PBX
Configuración de OminiPCX Enterprise:
Consulte el TC2462.
OXO Connect / OXO Connect Evolution
Consulte el TC2479.
Configuración Rainbow:
Configuración del equipo
Para el OmniPCX Enterprise u OXO Connect conectado a la pasarela WebRTC tendrá que seleccionar la opción "Activar la pasarela WebRTC".
Configuración de usuarios
A cada usuario se le debe conceder una licencia Business o Enterprise
Y la cuenta Rainbow debe estar asociada a su teléfono PBX
Solución de problemas
Algunos recordatorios sobre la recuperación de registros :
- La forma más sencilla para el usuario final de recuperar los registros del cliente Rainbow es utilizar la función Informar de un problema.
- Para los registros del cliente Rainbow consulte el artículo dedicado.
- Además de los registros del cliente Rainbow, para el cliente web el registro del navegador puede ser muy útil.
- Para los registros de la pasarela WebRTC (mpcollect --all) y los rastros SIP (mpndump on) consulte el artículo dedicado.