Benutzer-Werkzeuge

Webseiten-Werkzeuge


ag:infrastruktur:chaotikum:bbb

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

Link zu der Vergleichsansicht

Nächste Überarbeitung
Vorherige Überarbeitung
Letzte ÜberarbeitungBeide Seiten, nächste Überarbeitung
ag:infrastruktur:chaotikum:bbb [27.09.2020 09:10] – angelegt Lukas Rugeag:infrastruktur:chaotikum:bbb [03.01.2021 07:17] Lukas Ruge
Zeile 1: Zeile 1:
-====== Big Blue Button (technische Doku) ======+====== Big Blue Button (Technische Doku) ======
  
   * Verantwortung: Malte   * Verantwortung: Malte
-  * Umgebung: ? +  * Umgebung: [[infrastruktur:skaro]] 
-  * Laufende version: ? +  * Laufende version: BigBlueButton Server 2.2.31 (2307) 
-  * OS: ?+  * OS: Ubuntu 16.04.7 LTS
   * Zustand: Läuft   * Zustand: Läuft
  
-Hier findet sich die technische Dokumentation des Chaotikum Big Blue Buttons. Die Nutzerdoku findet sich [[:hackerspace:infrastruktur:bbb|hier]].+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. 
 + 
 +[[:hackerspace:infrastruktur:bbb:datenschutz|Alle für den Datenschutz relevanten Konfigurationen stehen hier.]] 
 + 
 +[[:hackerspace:infrastruktur:bbb|Die allgemeine Nutzerdoku findet sich hier.]] 
 + 
 + 
 +==== BBB-Version auslesen ==== 
 + 
 +''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 ==== 
 + 
 +LDAP-Authentifizierung in Greenlight-Konfiguration ''%%/root/greenlight/.env%%'' aktivieren: 
 + 
 +<code> 
 +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) 
 +</code> 
 + 
 +In der gleichen Konfigurationsdatei wird die Registrierung von Accounts über Greenlight deaktiviert: 
 + 
 +<code> 
 +ALLOW_GREENLIGHT_ACCOUNTS=false 
 +</code> 
 + 
 +Damit wird allerdings gleichzeitig die Registrierung von Accounts als auch der Login von Nicht-LDAP-Accounts deaktiviert. Das ist langfristig genau, was wir wollen, aber kurzfristig nicht optimal. 
 +==== Mail-Benachrichtigungen ==== 
 + 
 +E-Mail-Benachrichtigung in Greenlight-Konfiguration ''%%/root/greenlight/.env%%'' aktivieren: 
 + 
 +<code> 
 +ALLOW_MAIL_NOTIFICATIONS=true 
 +</code> 
 +SMTP-Server in Greenlight-Konfiguration ''%%/root/greenlight/.env%%'' einrichten: 
 + 
 +<code> 
 +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 
 +</code> 
 +Konfiguration testen im Verzeichnis ''%%/root/greenlight%%'': 
 + 
 +<code> 
 +docker run --rm --env-file .env bigbluebutton/greenlight:v2 bundle exec rake conf:check 
 +</code> 
 +Greenlight neustarten im Verzeichnis ''%%/root/greenlight%%'': 
 + 
 +<code> 
 +docker-compose down 
 +docker-compose up -d 
 +</code> 
 +==== HTTPS-Weiterleitung ==== 
 + 
 +Am Anfang von ''%%/etc/nginx/sites-available/bigbluebutton%%'' einen weiteren Server für HTTPS ergänzen: 
 + 
 +<code> 
 +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; 
 +
 +</code> 
 +Im folgenden Server ''%%listen 80;%%'' und ''%%listen [::]:80;%%'' auskommentieren. 
 + 
 +Außerdem kann ''%%/etc/nginx/sites-available/default%%'' gelöscht werden. 
 + 
 +==== Töne statt Ansagen für Mute / Unmute ==== 
 + 
 +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: 
 + 
 +<code> 
 +<!-- 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 --> 
 +</code> 
 +==== Präsentation am Anfang verbergen ==== 
 + 
 +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. 
 + 
 +==== Schlechtere Qualität der Webcams ==== 
 + 
 +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: 
 + 
 +<code> 
 +    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 
 +</code> 
 +Hier kann man einfach den default von ''%%medium%%'' auf ''%%low%%'' verschieben. 
 + 
 +Die [[https://docs.bigbluebutton.org/2.2/customize.html#reduce-bandwidth-from-webcams|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. 
 + 
 +==== Begrüßungstext ==== 
 + 
 +Anpassung des Begrüßungstexts im Chat in der Datei ''/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties'' folgende Konfigurationen anpassen: 
 + 
 +<code> 
 +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> 
 +</code> 
 + 
 +==== Server neustarten ==== 
 + 
 +Nach Änderungen an der Config muss der Server neugestartet werden: 
 + 
 +<code> 
 +bbb-conf --restart 
 +</code> 
 + 
 +Greenlight wird im Ordner ''/root/greenlight'' neugestartet mit 
 + 
 +<code> 
 +docker-compose down 
 +docker-compose up -d 
 +</code> 
 + 
 +{{tag>infrasystem ldapconnected}}