Inhalt

Einführung

Voraussetzungen

Anforderungen

Verwendete Komponenten

CSCvt73723 - WebRTC-Server, der nach einer großen Anzahl an Sitzungen auf dem Server ausläuft

Wie identifizieren Sie diesen Fehler?

Wie können Sie dieses Problem vermeiden?

Wann soll das behoben werden?

Zugehörige Informationen

Einführung

Dieses Dokument beschreibt die Erkennung und Problemumgehung der Cisco Bug-ID CSCvt73723 rund um WebRTC-Server, die nach einer großen Anzahl an Sitzungen auf dem Server auslaufen. Dies kann dazu führen, dass Benutzer sich nicht mehr bei WebBridge anmelden oder sich als Gast anmelden können.

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

- Cisco Meeting Server (CMS) (CallBridge- und WebBridge-Komponente)

Verwendete Komponenten

Die Informationen in diesem Dokument basieren auf dem Cisco Meeting Server und insbesondere auf der WebBridge 2/CMA WebRTC-Komponente. Dieses Dokument gilt nicht für die neue WebBridge 3/CMS Web-Anwendungskomponente, die in Version 2.9 eingeführt wurde.

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die potenziellen Auswirkungen eines Befehls verstehen.

CSCvt73723 - WebRTC-Server, die nach einer großen Anzahl an Sitzungen, die auf dem Server platziert werden, auslaufen

Wie identifizieren Sie diesen Fehler?

Das Symptom aus der Perspektive eines Endbenutzers besteht darin, dass dieser erst nach Erreichen der Obergrenze an einem Meeting teilnehmen kann. In den Protokollen impliziert das Erkennen der Webbridge-Statistiken (wie in dieser FAQ) 149 erreichen NICHT notwendigerweise, dass alle durchgesickerten Sitzungen sind. Das bedeutet nur, dass die Web-Bridge ihre Grenzen erreicht hat und keine neuen Verbindungen zugelassen sind.

"Webbridge": INFO: [DEBUGGING] Statistiken 149, c:3477, d:3170

Die Berechnung, wie viele dieser Sitzungen durchgesickert sind, ist etwas komplizierter und kann durchgeführt werden, wenn Sie NICHT den CMA-Desktop-Client oder iOS-Client verwenden. Ab Version 2.8 meldet die Call Bridge alle 5 Minuten die Anzahl der CMA-Sitzungen (CMA WebRTC + CMA-Desktop-Client + CMA iOS-Client). Beachten Sie, dass dies als "CMA" gemeldet wird: "X/Y", wobei X die aktuelle Anzahl der aktiven CMA-Sitzungen und Y der Spitzenwert in den letzten 5 Minuten ist.

INFO: STATT: {"callLegsPS": 1, "CallLegs": "20/24", "CMA": "14/17", "SIP": {"std": "0/1", "Peer": "6/6"}

Nur weil eine Anrufbrücke 14 aktuelle Sitzungen meldet, bedeutet dies nicht, dass die am gleichen Standort befindliche Web Bridge ebenfalls 14 Sitzungen meldet. Diese Zuordnung ist 1:1 auf einem einzelnen kombinierten Server, aber in einer geclusterten Bereitstellung kann eine Web-Bridge-Sitzung einen Anruf auf einer anderen Call Bridge instanziieren (insbesondere, wenn Load Balancing aktiviert ist, was standardmäßig für CMA gilt).

Um die Gesamtzahl der geleasten Sitzungen in einer Bereitstellung berechnen zu können, benötigen Sie daher die kombinierten aktiven Sitzungen ALLER Web Bridge-Statistiken, und vergleichen Sie diese mit den kombinierten CMA Call Bridge-Statistiken, die gemeldet werden.

Wie können Sie dieses Problem vermeiden?

Je nachdem, wie oft Ihre Bereitstellung in diese Situation gelangt (einmal alle paar Tage oder einmal alle zwei Wochen), müssen Sie angewiesen werden, die Web Bridge(s) neu zu starten, die geleaster Sitzungen löscht und die Anzahl der aktiven Sitzungen auf 0 zurücksetzt. Dies kann verständlicherweise mühsam sein, wenn dies zu einer täglichen Aufgabe wird, weshalb diese Aufgabe mit einem Skript erleichtert werden kann, das laut Codeblock verfügbar ist.

################################################################

#### 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)

################################################################

Das Skript erfordert einige kleine Änderungen (die Anmeldeinformationen für Zeile 29-30 und die IP-Adressen der Web Bridges in der Bereitstellung in Zeile 27) und darf NUR ausgeführt werden, wenn keine erwartete Last oder während eines Wartungsfensters zu erwarten ist. Das Skript führt keine Prüfung auf aktive Sitzungen durch und führt auf allen aufgeführten Servern, die aktive WebRTC-Sitzungen beenden, lediglich den Befehl "webbridge restart" aus.

Um dieses Skript zu automatisieren, kann es durch Einrichten eines Cron-Auftrags oder auf einem Windows 10-PC mit Taskplaner ausgeführt werden. Wenn auf dem Win 10-PC Python 3.4+ installiert ist, können Sie die folgenden Schritte ausführen:

1. Taskplaner öffnen

2. Wählen Sie "Einfache Aufgabe erstellen.." aus.

2.1 Geben Sie einen Namen/eine Beschreibung für diese Aufgabe ein.

2.2 Wählen Sie die Häufigkeit und die Uhrzeit aus, die Sie für diese Aufgabe verwenden möchten (nur zu Zeiten außerhalb der Spitzenzeiten, hier für jeden Samstag um 2 Uhr angezeigt).

2.3 Aktion auszuführen: 'Programm starten'

2.4 Aktion:

* Programm/Skript:  C:\<Pfad zu python.exe>

(Wenn Sie den Pfad zu python.exe nicht kennen, finden Sie ihn unter cmd und tippen: python -c "import sys"; print(sys.Executable)")

* Argumente hinzufügen (optional): webbridge_restart.py (oder Name des Python-Skripts)

* Beginn in (optional): C:\<Pfad zu webbridge_restart.py>

Beachten Sie, dass Computer, auf dem der Cron-Auftrag ausgeführt wird, auf den MMP der konfigurierten CMS-Server zugreifen können müssen. Nachdem das Skript ausgeführt wurde, wird eine Datei webbridge_restart_logs.txt erstellt, die Details zum Neustart der verschiedenen WebBridges sowie mögliche Fehler enthält. Ein Beispiel ist die erfolgreiche Verbindung mit 10.48.79.194 und einer, die bei 127.0.0.1 fehlschlägt (als Loopback-Adresse des PCs).

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

Wie testen Sie, ob das Skript funktioniert?

Wenn Sie Python auf dem PC installiert haben, von dem aus Sie das Skript ausführen möchten, können Sie es zunächst manuell ausführen, indem Sie die folgenden Schritte ausführen:

1. Öffnen Sie cmd, und navigieren Sie mit dem Befehl 'cd' zum Speicherort des Skripts.

2. Führen Sie die python-Datei mit dem Befehl 'python webbridge_restart.py' aus.

3. Falls Sie einen Fehler sehen, der anzeigt, dass das 'paramiko' Modul nicht installiert ist, müssen Sie einige zusätzliche Bibliothek mit dem Befehl 'pip install paramiko' installieren.

4. Nach Abschluss können Sie das Skript erneut mit 'python webbridge_restart.py' ausführen (HINWEIS: Dadurch wird die Webbridge neu gestartet, und die aktuellen WebRTC-Verbindungen werden getrennt.)

Wenn es erfolgreich ausgeführt wurde, können Sie das Ergebnis in der Datei webbridge_restart_logs.txt überprüfen.

Wann soll das behoben werden?

Dies ist kein neuer Fehler und es ist nicht geplant, diesen Fehler auf der Web Bridge 2/CMA WebRTC zu beheben. Die neue Web Bridge 3 / CMS Web-App (ab 2.9 verfügbar) ist von diesem Fehler nicht betroffen, da sie komplett neu gestaltet wurde. Kunden, die davon stark betroffen sind, müssen die Umstellung auf die neue CMS-Webanwendung in Betracht ziehen (allerdings beachten Sie, dass diese Funktion in der Version 2.9 noch nicht mit Web Bridge 2 identisch ist). Ausführliche Informationen hierzu finden Sie in den Versionshinweisen für die CMS 2.9- und CMS-Webanwendung.)

Zugehörige Informationen

- Anmerkungen zu Mängeln: https://bst.cloudapps.cisco.com/bugsearch/bug/CSCvt73723

- Versionshinweise: https://www.cisco.com/c/en/us/support/conferencing/meeting-server/products-release-notes-list.html

- Häufig gestellte Fragen

- https://meeting-infohub.cisco.com/faq/content/43/450/en/how-do-you-check-the-number-of-active-sessions-on-a-web-bridge.html