• Verantwortung: Malte
• Umgebung: skaro
• Laufende version: BigBlueButton Server 2.2.28 (2210)
• OS: Ubuntu 16.04.7 LTS
• Zustand: Läuft

Hier findet sich die technische Dokumentation des Chaotikum Big Blue Buttons. Diese Dokumentation beinhaltet alle Konfigurationen, die nicht direkt mit dem Datenschutz in Verbindung stehen.

Alle für den Datenschutz relevanten Konfigurationen stehen hier.

Die allgemeine Nutzerdoku findet sich hier.

bbb-conf –version gibt sehr viele verschiedenen Versionen von allem möglichen aus, aber nicht die Gesamt-Version von BBB. Die kriegt man am Anfang als Ausgabe von bbb-conf –check.

LDAP-Authentifizierung in Greenlight-Konfiguration /root/greenlight/.env aktivieren:

LDAP_SERVER=ldap.chaotikum.net
LDAP_PORT=636
LDAP_METHOD=ssl
LDAP_UID=uid
LDAP_BASE=dc=chaotikum,dc=org
LDAP_AUTH=simple
LDAP_BIND_DN=uid=bigbluebutton,ou=users,ou=internal,dc=chaotikum,dc=org
LDAP_PASSWORD=PASSWORD
LDAP_ATTRIBUTE_MAPPING=uid=dn;name=displayName;email=mail;nickname=uid;image=jpegPhoto
LDAP_FILTER=(memberOf=cn=freigeschaltet,ou=groups,ou=internal,dc=chaotikum,dc=org)

E-Mail-Benachrichtigung in Greenlight-Konfiguration /root/greenlight/.env aktivieren:

ALLOW_MAIL_NOTIFICATIONS=true

SMTP-Server in Greenlight-Konfiguration /root/greenlight/.env einrichten:

SMTP_SERVER=mail.chaotikum.net
SMTP_PORT=587
SMTP_DOMAIN=chaotikum.org
SMTP_USERNAME=bigbluebutton@chaotikum.org
SMTP_PASSWORD=PASSWORD
SMTP_AUTH=plain
SMTP_STARTTLS_AUTO=true

Konfiguration testen im Verzeichnis /root/greenlight:

docker run --rm --env-file .env bigbluebutton/greenlight:v2 bundle exec rake conf:check

Greenlight neustarten im Verzeichnis /root/greenlight:

docker-compose down
docker-compose up -d

Am Anfang von /etc/nginx/sites-available/bigbluebutton einen weiteren Server für HTTPS ergänzen:

server {
  listen *:80;
  listen [::]:80;
  server_name plaudern.chaotikum.org;
  server_tokens off; ## Don't show the nginx version number, a security best practice

  location / {
    return 301 https://plaudern.chaotikum.org:443$request_uri;
  }

  error_log /var/log/nginx/bigbluebutton.error.log;
  access_log /dev/null;
}

Im folgenden Server listen 80; und listen [::]:80; auskommentieren.

Außerdem kann /etc/nginx/sites-available/default gelöscht werden.

Die Ansagen You are now muted. und You are now unmuted sind zu lang und nerven, wenn man sich mal schnell muten will.

In der Konfiguration /opt/freeswitch/etc/freeswitch/autoload_configs/conference.conf.xml die Parameter muted-sound und unmuted-sound in allen Profilen anpassen:

<!-- File to play to acknowledge muted -->
<param name="muted-sound" value="tone_stream://%(100,0,500)"/> <!-- was conference/conf-muted.wav -->
<!-- File to play to acknowledge unmuted -->
<param name="unmuted-sound" value="tone_stream://%(100,0,700)"/> <!-- was conference/conf-unmuted.wav -->

In /usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml wird der Client konfiguriert. Alle Optionen befinden sich unter dem Wurzelnknoten public. Dort im Knoten layout die Option autoSwapLayout auf true setzen, damit die Präsentation initial ausgeblendet wird. Sie kann dann von allen Teilnehmern individuell eingeblendet werden.

Im Knoten presentation die Option restoreOnUpdate auf true setzen, damit bei allen die Präsentation automatisch eingblendet wird, sobald jemand etwas mit der Präsentation tut.

Um die Bandbreite zu verringern, die Qualität der Webcams reduzieren.

In /usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml wird der Client konfiguriert. Alle Optionen befinden sich unter dem Wurzelnknoten public.

Im Knoten kurento werden die Profile konfiguriert. Nach der Installation gab es folgende relevante Profile:

    cameraProfiles:
    - id: low
      name: Low quality
      default: false
      bitrate: 100
    - id: medium
      name: Medium quality
      default: true
      bitrate: 200
    - id: high
      name: High quality
      default: false
      bitrate: 500
    - id: hd
      name: High definition
      default: false
      bitrate: 800

Hier kann man einfach den default von medium auf low verschieben.

Die Doku sagt

The settings for bitrate are in kbits/sec (i.e. 100 kbits/sec). The lowest setting allowed for WebRTC is 30 Kbits/sec.

Anpassung des Begrüßungstexts im Chat in der Datei /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties folgende Konfigurationen anpassen:

defaultWelcomeMessage=Willkommen im Raum <b>%%CONFNAME%%</b>
defaultWelcomeMessageFooter=auf dem <a href="https://wiki.chaotikum.org/bbb" target="_blank"><u>BigBlueButton des Chaotikums</u></a>

Nach Änderungen an der Config muss der Server neugestartet werden:

bbb-conf --restart

Greenlight wird im Ordner /root/greenlight neugestartet mit

docker-compose down
docker-compose up -d