Der Fehler 2002 bedeutet, dass der Medienserver von BigBlueButton zwar ordnungsgemäß läuft, aber im Moment keine neuen Ressourcen mehr bereitstellen kann – er ist ausgelastet. Betroffen sind in der Regel das Teilen von Webcams oder die Bildschirmübertragung, nicht jedoch das reine Audio.

Wie äußert sich der Fehler?

Wenn Sie versuchen, Ihre Kamera zu aktivieren oder Ihren Bildschirm zu teilen, schlägt der Aufbau der Verbindung fehl. BigBlueButton zeigt eine Fehlermeldung mit dem Code 2002 an. Andere Teilnehmer in derselben Konferenz können möglicherweise ebenfalls keine neuen Video- oder Screensharing-Sitzungen starten. Audio-Verbindungen sind in der Regel nicht betroffen, da diese über einen eigenen Kanal laufen.

Mögliche Ursachen

• Zu viele gleichzeitige Videositzungen: Der Server verarbeitet bereits so viele Webcam- und Screensharing-Verbindungen, dass keine weiteren angenommen werden können.
• Medienprozesse nicht optimal konfiguriert: Auf Servern ab BBB 2.5 übernimmt der Mediendienst mediasoup die Verarbeitung. Sind die internen Arbeitsprozesse nicht vollständig auf die verfügbaren CPU-Kerne verteilt, kann die Kapazität schneller erschöpft sein als nötig.
• Hoher gleichzeitiger Konferenzbetrieb: Laufen sehr viele Meetings parallel auf demselben Server, konkurrieren alle um dieselben Ressourcen – RAM, CPU und Netzwerkkapazität.
• Systemressourcen erschöpft: Der Server-Arbeitsspeicher oder die CPU-Auslastung hat eine kritische Schwelle erreicht, sodass keine neuen Medienpipelines mehr geöffnet werden können.
• Abgestürzter Medienprozess: Ein interner Arbeitsprozess des Mediendienstes ist ausgefallen und wurde noch nicht neu gestartet, was die verfügbare Kapazität reduziert.

Lösungen

Für Teilnehmer

1. Kurz warten und erneut versuchen: Wenn andere Teilnehmer ihre Kamera gerade ein- oder ausschalten, kann es zu kurzzeitigen Engpässen kommen. Warten Sie 30–60 Sekunden und starten Sie den Versuch erneut.
2. Seite neu laden: Laden Sie die Konferenzseite vollständig neu (F5 bzw. Cmd+R). Damit werden bestehende Verbindungen zurückgesetzt.
3. Anderen Browser ausprobieren: Testen Sie Firefox oder Google Chrome, falls Sie bisher einen anderen Browser verwendet haben.
4. Moderator informieren: Bitten Sie den Moderator, bei Bedarf einzelne Webcams zu deaktivieren oder die Kamerafreigabe über die Sperreinstellungen vorübergehend einzuschränken, um Kapazität freizugeben.
5. Bildschirmübertragung vs. Webcam: Falls Sie primär Ihren Bildschirm teilen wollten, deaktivieren Sie zunächst Ihre Webcam (falls aktiv) und versuchen Sie es dann erneut – die benötigten Ressourcen unterscheiden sich leicht.

Für Administratoren

1. Aktuelle Auslastung prüfen: Verschaffen Sie sich zunächst einen Überblick über den Systemzustand.

top -b -n1 | head -20
free -h
ps aux | grep mediasoup

1. mediasoup-Worker auf alle CPU-Kerne verteilen (BBB 2.5+): Standardmäßig werden nicht immer alle verfügbaren Kerne genutzt. Passen Sie die Konfiguration an und starten Sie den Dienst neu.

mkdir -p /etc/bigbluebutton/bbb-webrtc-sfu
yq e -i '.mediasoup.workers = "cores"' \
    /etc/bigbluebutton/bbb-webrtc-sfu/production.yml
sudo systemctl restart bbb-webrtc-sfu

1. Dedizierte Worker pro Medientyp konfigurieren (BBB 2.5+): Wenn Audio, Webcam und Bildschirmübertragung um dieselben Arbeitsprozesse konkurrieren, kann eine Aufteilung die Stabilität deutlich verbessern. Tragen Sie folgende Konfiguration in /etc/bigbluebutton/bbb-webrtc-sfu/production.yml ein und starten Sie BBB dann neu.

mediasoup:
  workers: cores
  dedicatedMediaTypeWorkers:
    audio: auto
    main: auto      # Webcam
    content: auto   # Bildschirmübertragung

sudo bbb-conf --restart

1. Für BBB bis Version 2.4 (Kurento): Erhöhen Sie die Ressourcenlimits des Kurento-Medienservers.

sudo nano /etc/default/kurento-media-server
# Folgende Werte setzen:
# DAEMON_MAX_FILES=65536
# DAEMON_MAX_THREADS=8192
sudo systemctl restart kurento-media-server

1. Moderator-Maßnahmen aktivieren: Über die Sperreinstellungen können Moderatoren die Kamerafreigabe für Teilnehmer einschränken, bis Kapazität wieder verfügbar ist.
2. Für Produktivumgebungen – Skalierung prüfen: Wenn Fehler 2002 regelmäßig auftritt, ist ein einzelner BBB-Server an seiner Kapazitätsgrenze angelangt. Ein Load-Balancer wie Scalelite verteilt Meetings auf mehrere Knoten und schafft dauerhaft Abhilfe.

Weitere Informationen

Fehler 2002 ist eng verwandt mit Fehler 2001 (Mediendienst nicht erreichbar) und Fehler 2003 (Mediendienst reagiert nicht). Während 2001 und 2003 auf einen ausgefallenen Dienst hinweisen, bedeutet 2002 ausdrücklich, dass der Dienst läuft, aber überlastet ist. Ab BBB 2.5 mit mediasoup wird dieser Fehler präziser gemeldet als in älteren Versionen mit Kurento, wo Überlastung häufiger zu einem kompletten Absturz (Fehler 2001) führte.