bbb-hilfe.de

Deutsche Hilfeseite

Fehler 2001: Medienserver ist offline

Home  /  Docs  /  Fehler 2001: Medienserver ist offline
bbbserver.de ausprobieren
Print

Fehler 2001 (MEDIA_SERVER_OFFLINE) tritt auf, wenn sich der Signalisierungsdienst von BigBlueButton zwar erfolgreich mit Ihrem Browser verbunden hat, der eigentliche Medienserver im Hintergrund jedoch nicht erreichbar ist. Webcam-Übertragungen und Bildschirmfreigaben können in diesem Zustand nicht gestartet werden.

Wie äußert sich der Fehler?

Teilnehmer sehen eine Fehlermeldung, wenn sie versuchen, ihre Kamera oder ihren Bildschirm freizugeben. Der Fehler erscheint sowohl bei der Webcam-Aktivierung als auch bei der Bildschirmfreigabe. Im Gegensatz zu Fehler 2000, bei dem der SFU-Dienst selbst nicht erreichbar ist, läuft bei Fehler 2001 der Signalisierungsdienst (bbb-webrtc-sfu) – er findet lediglich keinen funktionsfähigen Medienserver mehr vor.

Mögliche Ursachen

  • Medienserver abgestürzt: Der Kurento Media Server (BBB bis 2.4) oder ein mediasoup-Worker-Prozess (BBB 2.5+) ist nicht mehr aktiv.
  • Speichermangel (OOM): Der Linux-Kernel hat den Kurento-Prozess beendet, weil dem Server der Arbeitsspeicher ausgegangen ist.
  • Falsche Kurento-URL: In der SFU-Konfiguration (default.yml) ist die URL zum Medienserver leer oder fehlerhaft eingetragen.
  • ICE-TCP aktiviert: In bestimmten Netzwerkumgebungen führt die Einstellung iceTcp=1 zu Abstürzen des Kurento-Servers.
  • Dateideskriptor-Limit überschritten: Nach vielen Stunden Betrieb kann Kurento das Standard-Limit von 1024 offenen Dateien überschreiten und abstürzen.
  • Fehlerhafter Cron-Job: Das Skript /etc/cron.hourly/bbb-restart-kms kann in älteren BBB-Versionen den Medienserver während laufender Konferenzen neu starten.
  • Systemd-Startreihenfolge: Nach einem Serverneustart startet BBB, bevor Kurento vollständig betriebsbereit ist.

Lösungen

Für Teilnehmer

  1. Seite neu laden: Laden Sie die Konferenzseite vollständig neu (F5 oder Strg+R). Manchmal erholt sich die Verbindung dadurch.
  2. Kurz warten und erneut versuchen: Falls der Administrator den Medienserver gerade neu startet, kann die Kamera nach einer Minute wieder funktionieren.
  3. Administrator informieren: Da der Fehler serverseitig verursacht wird, können Teilnehmer das Problem nicht selbst beheben. Melden Sie den Fehler dem Konferenz-Moderator oder dem Systemadministrator.

Für Administratoren

  1. Sofortmaßnahme – Medienserver neu starten: Starten Sie den Kurento Media Server und den SFU-Dienst neu oder führen Sie einen vollständigen BBB-Neustart durch.
  2. Status prüfen: Kontrollieren Sie, ob der Medienserver läuft und auf Port 8888 lauscht.
  3. OOM-Kills im Systemlog suchen: Prüfen Sie, ob der Linux-Kernel den Kurento-Prozess wegen Speichermangels beendet hat. Falls ja: Arbeitsspeicher des Servers aufstocken oder die Anzahl gleichzeitiger Konferenzen begrenzen.
  4. ICE-TCP deaktivieren: Setzen Sie in /etc/kurento/modules/kurento/WebRtcEndpoint.conf.ini den Wert iceTcp=0 und starten Sie anschließend Kurento und den SFU-Dienst neu.
  5. Dateideskriptor-Limit erhöhen: Tragen Sie in /etc/default/kurento-media-server höhere Limits ein (DAEMON_MAX_FILES=65536, DAEMON_MAX_THREADS=4096) und starten Sie Kurento neu.
  6. Fehlerhaften Cron-Job deaktivieren: Prüfen Sie /etc/cron.hourly/bbb-restart-kms und deaktivieren Sie das Skript bei Bedarf (sudo chmod -x /etc/cron.hourly/bbb-restart-kms).
  7. bbb-webrtc-sfu aktualisieren (BBB 2.3/2.4): In Versionen vor 2.3.2 bleibt der Medienserver nach einem Neustart manchmal als nicht erreichbar markiert, obwohl er wieder läuft. Ein Update auf die aktuelle Version behebt dieses Problem.

Diagnosebefehle (Kurzübersicht)

# Sofort-Neustart
sudo systemctl restart kurento-media-server
sudo systemctl restart bbb-webrtc-sfu
# Oder vollständiger BBB-Neustart:
sudo bbb-conf --restart

# Status und Port prüfen
sudo systemctl status kurento-media-server.service
netstat -tlnp | grep 8888

# OOM-Kills suchen
sudo dmesg | grep -iE "oom|killed|kurento" | tail -30

# Kurento-Fehlerprotokoll
cat /var/log/kurento-media-server/errors.log

Versionshinweise

Ab BBB 2.5 wird mediasoup anstelle von Kurento als Standard-Medienserver für WebRTC eingesetzt. Fehler 2001 kann in diesem Fall auf eine fehlerhafte announcedIp-Konfiguration oder auf ausgefallene mediasoup-Worker-Prozesse hindeuten. Kurento wird in BBB 2.5+ weiterhin für Aufnahmen verwendet. Ab BBB 2.7 steht mit bbb-webrtc-recorder ein experimenteller, Pion-basierter Aufnahmedienst als Kurento-Ersatz zur Verfügung.

Mobiler Hinweis auf bbbserver.de