Guide d'installation de la passerelle WebRTC

language Cet article a été traduit automatiquement. Consulter la version de référence en anglais.

Cet article décrit les étapes d'installation de base pour déployer une passerelle WebRTC. Notez que vous devrez vous référer aux documents de communication technique OmniPCX Enterprise ou OXO Connect pour la configuration nécessaire à effectuer côté PBX.

Exigences

Les utilisateurs Rainbow doivent disposer d'une licence Business ou Enterprise et d'une licence Enterprise obligatoire lorsqu'ils sont connectés à un PBX tiers.
Le PBX OmniPCX Enterprise doit :

fonctionner avec la version SW OmniPCX Enterprise à partir de R12.1 MD2(M2.300.21.a)& OmniPCX Enterprise R12.2(M3.402.13.f).
bénéficier de licences REX par utilisateur Rainbow ciblé
être connecté à Rainbow pour les services de téléphonie.

Une machine virtuelle doit être configurée pour accueillir la passerelle Rainbow WebRTC. Le logiciel de la VM est fourni par l'ALE et nécessite un VMWARE 6.0 ou plus récent ou sur Hyper-V G1 ou G2 ou sur Nutanix. La VM doit répondre aux exigences minimales suivantes, qui peuvent encore changer :

vCPU : 2
Réservation de CPU en MHz : 4800
vRAM : 2GB
vDISK : 4 Go
vNIC : 1 Go

IMPORTANT: Pour les systèmes avec plus de 500 utilisateurs, nous recommandons d'avoir 4 Go de RAM.

Les besoins d'OXO Connect PBX :
- fonctionner avec la dernière version du logiciel OXO Connect(R4.0/536.001 ; R5.2/064.001 ; R6.1/023.001 ou supérieure)
- exécuter R4.0/536.001 ; R5.2/064.001 ; R6.1/023.001 ou supérieur pour utiliser un Front End OCE comme passerelle WebRTC
- disposer d'un terminal AnyDevice par utilisateur Rainbow ciblé
- être connecté à Rainbow pour les services de téléphonie
- de disposer de Chaînes d'information VoIP pour le trunk SIP
Pour OXO Connect, vous pouvez également héberger la passerelle Rainbow WebRTC sur un PC autonome. Lisez le guide d'installation dédié pour plus de détails. Ou sur un OCE WebRTC Front End (OCE FE) qui est un matériel OCE exécutant uniquement le composant WebRTC Gateway. Lisez l'article dédié à la configuration d'un OCE FE via Rainbow.

Vous trouverez des détails sur l'offre Rainbow connectée à un OmniPCX Enterprise ou OXO Connect/OXO Connect Evolution dans la présentation suivante de Technical Business Engine.

Besoins d'un PBX tiers :
- fonctionner avec la dernière version de Rainbow CTI & Media bridge
- être connecté à Rainbow pour les services de téléphonie par le CTI & Media bridge
- disposer d'un trunk SIP connecté au pont CTI & Media.
- Voir la section Pont CTI & Media pour les autres exigences et les PBX pris en charge.

Installation de la passerelle WebRTC OVF/ISO

Téléchargement du logiciel

Le logiciel de la passerelle WebRTC est soumis aux lois sur le contrôle des exportations et vous devez remplir un formulaire web pour demander l'accès au logiciel (les instructions détaillées se trouvent sur le portail Business de l'ALE). Aujourd'hui, le logiciel est disponible sous OXE R12.1 et plus et OXO Connect (OCO & OCE) R4.x et plus.

Installation du logiciel

Déployez d'abord le fichier OVF dans votre vCenter et démarrez la machine virtuelle (VM) ou, si vous êtes connecté à un OXO Connect, installez le fichier ISO sur un PC autonome(guide d'installation).

Configuration du clavier

L'OVF et l'ISO ont été créés avec un clavier QWERTY, vous pouvez avoir besoin de le changer :

Connectez-vous avec les informations d'identification suivantes :
User=kb
Password=kb

L'assistant de changement de clavier sera automatiquement démarré, il suffit de suivre les instructions à l'écran pour changer votre clavier.

Vous pouvez également accéder au même menu en utilisant les commandes suivantes :

# dpkg-reconfigure keyboard-configuration
# service keyboard-setup restart

Configuration de la passerelle WebRTC

Pour configurer la passerelle WebRTC, vous devez vous connecter à la console avec les informations d'identification suivantes :

User=rainbow
Password=Rainbow123

Veillez à modifier le mot de passe de connexion par défaut de Rainbow. Utilisez la commande passwd pour le changer.

Pour les commandes root, vous devez utiliser "sudo"

Configuration de la passerelle WebRTC

Lorsque l'on est authentifié avec le compte Rainbow, la configuration se fait à l'aide des commandes mpnetwork [options...] et mpconfig [options...]

mphelp //affiche la liste des commandes mpXXXXX//

mpstart|mpstop|mprestart //démarre, arrête ou redémarre la passerelle//

mpcheck //vérifie la connectivité de la passerelle WebRTC au Rainbow Cloud//

Note : vous pouvez trouver les commandes mpnetwork et mpconfig dans l'historique de la passerelle WebRTC, que vous pouvez consulter en utilisant la touche flèche vers le haut, tout ce que vous avez à faire est d'entrer les valeurs correctes.

Première installation

Vous devez tout d'abord configurer les paramètres du réseau puis ceux de la passerelle WebRTC.

Par défaut, la passerelle Rainbow WebRTC démarre en utilisant une configuration réseau basée sur DHCP (DHCP ne doit être utilisé qu'avec OXO Connect Zero Touch).

Connectez-vous avec le compte Rainbow pour effectuer la configuration.

Étape 1 - Configuration du réseau

Consultez d'abord la configuration requise pour le réseau Rainbow.

La première fois, vous devez exécuter la commande mpnetwork avec les options obligatoires IP, NETMASK, GATEWAY et DNS comme affiché ci-dessous :

mpnetwork --IP="10.2.3.4" --NETMASK="255.255.255.0" --GATEWAY="10.2.3.254" --DNS="10.2.3.253"

Vous pouvez également exécuter pour cette première étape la commande mpnetwork avec toutes les options en ajoutant NTP et 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"

En option, vous pouvez ajouter les options suivantes

--HOSTDOMAIN="mycompany.com"
--PROXY="http://user:pass@10.2.3.252:8000/"
ou
--PROXY="http://10.2.3.252:8000/"

Si vous devez mettre à jour la configuration, chaque commande peut être exécutée séparément

mpnetwork --IP="10.2.3.4" // votre nouvelle adresse IP de la VM //
mpnetwork --NETMASK="255.255.255.0"
mpnetwork --GATEWAY="10.2.3.254" // votre passerelle //
mpnetwork --DNS="10.2.3.253" // votre DNS //
Pour 2 DNS, utilisez la commande suivante mpnetwork --DNS="10.2.3.253", "10.2.3.252"
mpnetwork --NTP="10.2.3.253"
mpnetwork --HOSTNAME="rainbow-mpgw"
mpnetwork --IP=dhcp // si vous voulez passer la configuration IP en mode DHCP (uniquement avec OXO Connect Zero Touch) //

vous pouvez également utiliser

mpnetwork --FQDN="rainbow-mpgw.mycompany.com"

Un résumé des modifications s'affiche et il vous est demandé de confirmer pour appliquer ces modifications, puis la passerelle WebRTC redémarre automatiquement.

Étape 2 - Configurer la passerelle WebRTC :

La première fois, vous devez exécuter la commande avec les options obligatoires PBX_DOMAIN et PBXID comme affiché ci-dessous :

mpconfig --PBX_DOMAIN="10.2.3.5" --PBXID="PBXa1b1-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-c1d1"

PBX_DOMAIN= est votre adresse ip OXE/OXO
PBXID= est votre pbxid OXE/OXO dans Rainbow

L'option TURN de la passerelle WebRTC par défaut est GEOIP

La passerelle WebRTC reprend une liste de tous les serveurs TURN disponibles ainsi qu'un TTL (time to live) depuis le backend après chaque redémarrage. Les 2 premiers serveurs TURN de la liste seront utilisés par la passerelle WebRTC. Avant l'expiration du TTL (actuellement 8 heures), la passerelle WebRTC reprend une nouvelle liste depuis le backend.

- Dans le cas d'une mise à jour d'une version où TURN était défini sur 1 serveur TURN spécifique, nous vous recommandons de lancer la commande suivante :
mpconfig --TURN_SERVER=GEOIP

Un résumé des changements est affiché et il vous est demandé de confirmer pour appliquer ces changements, puis la passerelle WebRTC redémarre automatiquement.

En option, vous pouvez utiliser des FQDN au lieu d'adresses IP

mpconfig --RAINBOW_DOMAIN="domaine.yy.zz"
mpconfig --RAINBOW_HOST="hôte.uu.vv"

Note :
- PBX_DOMAIN peut être un FQDN (dans ce cas, le DNS utilisé par la passerelle WebRTC doit résoudre ce FQDN)
- En cas de redondance spatiale à partir des serveurs OXE Call, le PBX_DOMAIN doit contenir le nom du nœud configuré dans netadmin, section 17. Configuration du nœud". Ce FQDN doit être résolu par le DNS via une délégation DNS au système OXE.

Étape 3 - Vérifier la configuration

Une fois que le serveur a redémarré, vous pouvez exécuter la commande mpcheck pour vérifier la connectivité avec le Cloud Rainbow.

Fichiers de configuration

Une fois que le serveur a redémarré, vous pouvez exécuter la commande mpshow pour vérifier la configuration.

Modifier les paramètres du réseau en DHCP (Uniquement avec OXO Connect Zero Touch)

Exécutez la commande :

mpnetwork --IP=dhcp

En option, vous pouvez ajouter un proxy

mpnetwork --PROXY="user:pass@10.1.2.252:8000/"

Après la modification, redémarrez le serveur avec la commande sudo reboot.

Configuration du PBX

Configuration OminiPCX Enterprise :

Veuillez consulter le document TC2462.

OXO Connect / OXO Connect Evolution

Veuillez consulter TC2479.

Configuration Rainbow :

Configuration de l'équipement

Pour l'OmniPCX Enterprise ou l'OXO Connect connecté à la passerelle WebRTC, vous devrez sélectionner l'option "Activer la passerelle WebRTC"

Configuration des utilisateurs

Chaque utilisateur doit bénéficier d'une licence Business ou Enterprise.

Et le compte Rainbow doit être associé à son téléphone PBX

Dépannage

Quelques rappels concernant la récupération des logs :

Le moyen le plus simple pour l'utilisateur final de récupérer les logs du client Rainbow est d'utiliser la fonction Signaler un problème.
Pour les authentifiants du client Rainbow, consultez l'article dédié.
En plus des logs du client Rainbow, pour le client web, le log du navigateur peut être très utile.
Pour les logs de la passerelle WebRTC (mpcollect --all) et les traces SIP (mpndump on), consultez l'article dédié.

La base de connaissances vous permet-elle de trouver ce que vous cherchez ?

Merci pour votre avis

Associé à

Exigences