Note d’information relative à la mise en production de nos nouvelles API de configuration de PJSIP.
Pourquoi de nouvelles APIs
Les anciennes versions de Wazo utilisaient CHAN_SIP, l’ancienne stack SIP utilisée par le projet Asterisk. CHAN_SIP étant dépréciée, nous avons migré vers la nouvelle stack PJSIP. Pour des soucis de migration et d’habitude de configuration, la première version d’API était proche de la configuration de CHAN_SIP.
Mais pour fonctionner correctement avec certains opérateurs, il était nécessaire d'ajouter des informations via la CLI. Notre objectif étant de simplifier la configuration des stacks, une refonte de ces APIs était nécessaire.
Comment s’effectue la mise à jour
Nous avons effectué une refonte complète de nos APIs pilotant la configuration de PJSIP en souhaitant simplifier au maximum les tâches d’administration. Lors de la mise à jour de la stack, la migration de la configuration des endpoints PJSIP (SIP / WebRTC et trunk) sera effectuée automatiquement.
Ensuite, si un fichier /etc/asterisk/pjsip.d/reg.conf
existe, il sera obligatoire d’exécuter un script manuellement en ligne de commande sur la stack après mise à jour. Ce script récupère les paramètres inclus dans le fichier et les ré-incorpore dans la configuration. A votre charge ensuite de supprimer ce fichier qui deviendra par le fait inutile.
Il est souhaitable de tester une migration de trunk en preprod ou de prévoir un retour arrière en cas de soucis (sauvegarde de la VM).
Quels sont les impacts
Ces nouvelles APIs impactent le fonctionnement des applications E-UC apps. Il est donc nécessaire d'effectuer une mise à jour des applications à la version minimale suivante :
- E-UC app web : 1.11.2 (en production)
- E-UC app desktop : 1.11.2 (en production)
- E-UC app mobile : 2.3.2
Important : ces nouvelles versions d’applications restent compatibles avec l’ancienne version d’API, ainsi une mise à jour des stacks n’est pas obligatoire pour faire fonctionner ces versions de nos applications.
Quelles sont les limitations et les points d’attention
Les configurations saisies via la CLI seront ignorées, comme celles indiquées dans un fichier /etc/asterisk/pjsip.d/reg.conf
. Il sera donc obligatoire de les reporter via Portal si le script ne réintègre pas l’ensemble des données malgré toute l’attention que nous y avons apporté.
Besoin d'aide ?
Nous sommes à votre disposition pour toute question mais aussi afin de vous accompagner dans cette mise à jour.
N'hésitez pas à prendre rendez-vous avec notre support technique > Je prends rendez-vous