Dans le cadre de la documentation associée à ce produit, nous nous efforçons d’utiliser un langage exempt de préjugés. Dans cet ensemble de documents, le langage exempt de discrimination renvoie à une langue qui exclut la discrimination en fonction de l’âge, des handicaps, du genre, de l’appartenance raciale de l’identité ethnique, de l’orientation sexuelle, de la situation socio-économique et de l’intersectionnalité. Des exceptions peuvent s’appliquer dans les documents si le langage est codé en dur dans les interfaces utilisateurs du produit logiciel, si le langage utilisé est basé sur la documentation RFP ou si le langage utilisé provient d’un produit tiers référencé. Découvrez comment Cisco utilise le langage inclusif.
Cisco a traduit ce document en traduction automatisée vérifiée par une personne dans le cadre d’un service mondial permettant à nos utilisateurs d’obtenir le contenu d’assistance dans leur propre langue. Il convient cependant de noter que même la meilleure traduction automatisée ne sera pas aussi précise que celle fournie par un traducteur professionnel.
Ce document décrit la détection et le contournement de l'ID de bogue Cisco CSCvt73723 autour du serveur WebRTC fuyant des sessions après une grande quantité de sessions placées sur le serveur. Cela peut éventuellement empêcher les utilisateurs de se connecter ou de se joindre en tant qu'invité sur le WebBridge.
Cisco vous recommande de prendre connaissance des rubriques suivantes :
Les informations contenues dans ce document sont basées sur Cisco Meeting Server et en particulier sur le composant WebBridge 2 / CMA WebRTC. Ce document ne s'applique pas au nouveau composant d'application Web Web Web Web WebBridge 3 / CMS introduit dans la version 2.9.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Le symptôme d'un point de vue utilisateur final est qu'une fois qu'ils ont atteint la limite maximale et qu'aucun autre utilisateur ne peut se joindre à une téléconférence. Dans les journaux, la détection des statistiques de webbridge (selon cette FAQ) touche 149 ne PAS nécessairement impliquer que ce sont toutes des sessions fuitées. Cela signifie simplement que le pont Web a atteint sa limite et qu'aucune nouvelle connexion n'est autorisée.
« webbridge » : INFORMATIONS : [DÉBOGAGE] Statistiques 149, c:3477, d:3170
Calculer combien de ces sessions sont fuitées est un peu plus compliqué et peut être fait si vous n'utilisez PAS le client de bureau CMA ou iOS. À partir de la version 2.8, le pont d'appel indique toutes les 5 minutes le nombre de sessions CMA (CMA WebRTC + client de bureau CMA + client CMA iOS). Notez que ceci est indiqué sous le nom de « CMA » : « X/Y » où X représente le nombre actuel de sessions CMA actives et Y le pic des 5 dernières minutes.
INFORMATIONS : STATS : {« callLegsPS » : 1, « callLegs » : « 20/24 », « CMA » : « 14/17 », « sip » : {« std » : « 0/1 », « homologue » : « 6/6 »}}
Ce n'est pas parce qu'un pont d'appel signale 14 sessions en cours que le pont Web colocalisé signale également 14 sessions. Ce mappage est 1:1 sur un seul serveur combiné, mais dans un déploiement en cluster, une session Web Bridge peut instancier un appel sur un autre pont d'appel (en particulier lorsque l'équilibrage de charge est activé - ce qui est par défaut le cas pour CMA).
Par conséquent, afin de calculer le nombre total de sessions fuitées dans un déploiement, vous avez besoin des sessions actives combinées de TOUTES les statistiques du pont Web et comparez-les aux statistiques combinées du pont d'appel CMA qui sont signalées.
En fonction de la fréquence à laquelle votre déploiement survient dans cette situation (une fois tous les deux jours ou une fois toutes les deux semaines), vous devez être invité à redémarrer leur ou leurs ponts Web qui effacent les sessions fuitées et réinitialisent le nombre de sessions actives à 0. Naturellement cela peut être ennuyeux si cela devient une corvée quotidienne, d'où la raison pour laquelle cette tâche peut être facilitée avec un script disponible selon le bloc de code.
################################################################
#### Cisco Meeting Server ####
#### Webbridge restart ####
#### Workaround for CSCvt73723 ####
#### feedback: willwoo@cisco.com ####
################################################################
#--------------------------------------------------------------
# ---------- DISCLAIMER ----------
#--------------------------------------------------------------
# Please note this script is NOT maintained or supported by Cisco.
# This is to be run at entirely your own risk.
# This script is not intended for redistribution
# Tested with python 3.7.4
#--------------------------------------------------------------
#--------------------------------------------------------------
# ---------- Libraries to import ----------
#--------------------------------------------------------------
import paramiko
import time
import datetime
#--------------------------------------------------------------
#--------------------------------------------------------------
# ---------- Deployment parameters to change ----------
#--------------------------------------------------------------
# WB Inventory - just extend or modify the below to match your deployment requirements.
# Enter the MMP IP of the server (can differ from interface webbridge service is running)
webbridges ={1:"127.0.0.1",2:"127.0.0.1",3:"127.0.0.1",4:"127.0.0.1"}
mmp_username = "admin" # MMP username
mmp_password = "password" # MMP password
#--------------------------------------------------------------
def mmp_webbridge_restart(mmp_address,uname,pword):
conn = paramiko.SSHClient()
conn.set_missing_host_key_policy(paramiko.AutoAddPolicy())
try:
conn.connect(mmp_address, 22, uname, pword)
stdin, stdout, stderr = conn.exec_command('webbridge restart')
time.sleep(1)
conn.close()
print_log_message('Webbridge on server: ' + mmp_address + ' restarted successfully')
except Exception as error:
print_log_message('Failed to restart webbridge on server ' + mmp_address + '. Error:')
print_log_message(str(error))
pass
def print_log_message(message):
time_stamp = datetime.datetime.now(datetime.timezone.utc)
time_stamp = str(time_stamp)
file = open('webbridge_restart_logs.txt', 'a')
file.write(time_stamp + " " + message + "\n")
file.close()
if __name__ == '__main__':
for wb in webbridges:
mmp_webbridge_restart(webbridges[wb], mmp_username, mmp_password)
################################################################
Le script nécessite quelques modifications mineures (les informations d'identification à la ligne 29-30 et les adresses IP des ponts Web dans le déploiement à la ligne 27) et doit SEULEMENT être exécuté lorsqu'il n'y a aucune charge prévue ou pendant une fenêtre de maintenance. Le script ne vérifie pas les sessions actives et exécute simplement la commande 'webbridge restart' sur tous les serveurs répertoriés qui met fin à toute session WebRTC active.
Pour automatiser ce script, vous pouvez configurer une tâche cron ou sur un PC Windows 10 avec le Planificateur de tâches. En supposant que le PC Win 10 a Python 3.4+ installé, ils peuvent suivre les étapes suivantes :
1. Ouvrir le planificateur de tâches
2. Sélectionnez Créer une tâche de base...
2.1 Entrez un nom/une description pour cette tâche
2.2 Sélectionnez la fréquence et l'heure d'exécution de cette tâche (recommandé uniquement en dehors des heures de pointe, ici pour chaque samedi à 2h du matin)
2.3 Action à effectuer, sélectionnez : 'Démarrer un programme'
2.4 Action :
* Programme / Script : C:\<chemin vers python.exe>
(si vous ne connaissez pas le chemin vers python.exe, vous pouvez le trouver en allant à cmd et en tapant : python -c « import sys; print(sys.exécutable)")
* Ajouter des arguments (facultatif) : webbridge_restart.py (ou nom du script python)
* Démarrer en (facultatif) : C:\<chemin vers webbridge_restart.py>
Notez que l'ordinateur qui exécute la tâche cron doit pouvoir accéder au MMP des serveurs CMS configurés. Après l'exécution du script, il crée un fichier webbridge_restart_logs.txt qui contient des détails sur les redémarrages des différents ponts Web ainsi que sur toute défaillance potentielle. Un exemple est illustré avec une connexion réussie à 10.48.79.194 et une connexion échouée à 127.0.0.1 (comme étant l'adresse de bouclage du PC en fait).
2020-06-08 14:53:18.149915+00:00 Webbridge on server: 10.48.79.194 restarted successfully 2020-06-08 14:53:19.165543+00:00 Failed to restart webbridge on server 127.0.0.1. Error: 2020-06-08 14:53:19.165543+00:00 [Errno None] Unable to connect to port 22 on 127.0.0.1
Comment tester que le script fonctionne correctement ?
Si Python a installé le PC à partir duquel vous avez commencé à exécuter le script, vous pouvez commencer par l'exécuter manuellement avec les étapes suivantes :
Ce bogue n'est pas nouveau et il n'y a pas de plan pour le résoudre sur le Web Bridge 2 / CMA WebRTC. La nouvelle application Web Bridge 3 / CMS (disponible à partir de la version 2.9) n'est pas affectée par ce bogue car il a été complètement repensé. Les clients qui sont fortement touchés par cette situation doivent envisager de passer à la nouvelle application Web CMS (bien que cela ne soit pas encore la parité des fonctionnalités avec Web Bridge 2 dans la version 2.9. Consultez les notes de version de l'application web CMS 2.9 et cms pour plus de détails.)