====== Big Blue Button ======

| Verantwortung  | Malte                           |
| Container      | keine, dedizierter Root-Server  |
| W. Ports       | keine, dedizierter Root-Server  |
| OS             | Ubuntu 20.04.6 LTS              |
| Server         | [[infrastruktur:server:skaro]]  |
| Zustand        | Produktiv                       |

{{tag>infrasystem container ldapconnected skaro productive malte}}

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.

[[infrastruktur:container:bbb:datenschutz|Alle für den Datenschutz relevanten Konfigurationen stehen hier.]]

[[hackspace:infrastruktur:bbb|Die allgemeine Nutzungshinweise finden sich hier.]]



=====Services=====
^ Serviceübersicht        ^ Version                            ^
| BigBlueButton           | BigBlueButton Server 2.7.1 (425)  |
| Greenlight              | release-3.0.7.1                   |
| BigBlueButton Exporter  | 0.6.1 ???                              |

BigBlueButton ist eine Sammlung sehr vieler verschiedener Dienste. Die Versionsnummer von BigBlueButton beschreibt eine aufeinander abgestimmte Sammlung von Diensten.


===== BBB installieren und aktualisieren =====

<code>
wget -qO- https://raw.githubusercontent.com/bigbluebutton/bbb-install/v2.7.x-release/bbb-install.sh | bash -s -- -v focal-270 -s plaudern.chaotikum.org -e infrastruktur@chaotikum.org -g -w
</code>

===== BBB neustarten =====

Nach Änderungen an der Config muss BBB neugestartet werden:

<code>
bbb-conf --restart
</code>

Greenlight wird im Ordner ''/root/greenlight-v3'' neugestartet mit

<code>
docker-compose down
docker-compose up -d
</code>

===== BBB-Version auslesen =====

<code>
bbb-conf --version
</code>
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
<code>
bbb-conf --check
</code>


===== Authentifizierung =====

Es gibt keine LDAP-Unterstützung in Greenlight 3 mehr. Deswegen machen wir jetzt Open ID Connect.

Nachteil: Wir können aktuell noch nicht dafür sorgen, dass nur freigegebene User sich anmelden können. Deswegen können das jetzt erstmal alle. Das ist so mittelgut, aber bei BBB auch nicht sehr schlimm.

Open ID Connect in Greenlight-Konfiguration ''%%/root/greenlight-v3/.env%%'' aktivieren:

<code>
### EXTERNAL AUTHENTICATION METHODS

OPENID_CONNECT_CLIENT_ID=greenlight
OPENID_CONNECT_CLIENT_SECRET=SECRET
OPENID_CONNECT_ISSUER=https://me.chaotikum.org/auth/realms/Chaotikum
OPENID_CONNECT_REDIRECT=https://plaudern.chaotikum.org
</code>
===== Mail-Benachrichtigungen =====

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

<code>
### SMTP CONFIGURATION
# Emails are required for the basic features of Greenlight to function.
# Please refer to your SMTP provider to get the values for the variables below
SMTP_SENDER_EMAIL=bigbluebutton@chaotikum.org
SMTP_SENDER_NAME=BigBlueButon Greenlight
SMTP_SERVER=mail.chaotikum.net
SMTP_PORT=587
SMTP_DOMAIN=chaotikum.org
SMTP_USERNAME=bigbluebutton@chaotikum.org
SMTP_PASSWORD=uPixoB2TOTVWFWD5l4zL76onwPyV9HtitnX
SMTP_AUTH=plain
SMTP_STARTTLS_AUTO=true
SMTP_STARTTLS=false
SMTP_TLS=false
SMTP_SSL_VERIFY=true
</code>





===== 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/hackspace:infrastruktur:bbb" target="_blank"><u>BigBlueButton des Chaotikums</u></a>
</code>

===== Aufzeichnungen deaktivieren =====

In der ''%%/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties%%'':

  * ''%%disableRecordingDefault=true%%''
  * ''%%autoStartRecording=false%%''
  * ''%%allowStartStopRecording=false%%''
  * ''%%breakoutRoomsRecord=false%%''




===== BigBlueButton Exporter =====

[[https://bigbluebutton-exporter.greenstatic.dev/installation/bigbluebutton_exporter/|Anleitung]]

Wir verwenden die Docker Installation.

Datei ''/home/linadmin/bbb-exporter/docker-compose.yaml'' und ''/home/linadmin/bbb-exporter/secrets.env'' nach Anleitung.

Datei ''/etc/bigbluebutton/nginx/monitoring.nginx'':
<code>
location /metrics/ {
    proxy_pass http://127.0.0.1:9688/;
    include proxy_params;
}
</code>

Läuft unter https://plaudern.chaotikum.org/metrics/

===== prometheus-node-exporter =====

Die Version aus Paketquellen
<code>
apt install prometheus-node-exporter
</code>
ist leider viel zu alt. Deswegen müssen wir selber installieren. Dazu
<code>
wget https://github.com/prometheus/node_exporter/releases/download/v1.1.2/node_exporter-1.1.2.linux-amd64.tar.gz
tar xvf node_exporter-1.1.2.linux-amd64.tar.gz
mv node_exporter-1.1.2.linux-amd64/node_exporter /usr/local/bin/node_exporter
</code>

User anlegen:
<code>
useradd -rs /bin/false node_exporter
</code>

Datei ''/lib/systemd/system/node_exporter.service'':
<code>
[Unit]
Description=Node Exporter
After=network.target

[Service]
User=node_exporter
Group=node_exporter
Type=simple
ExecStart=/usr/local/bin/node_exporter

[Install]
WantedBy=multi-user.target
</code>

<code>
systemctl enable node_exporter
systemctl start node_exporter
</code>

Port 9100 in Firewall öffnen:
<code>
ufw allow 9100/tcp
</code>

Läuft nur über IPv6 unter http://plaudern.chaotikum.org:9100/metrics

===== Default-Präsentation anpassen =====

Wir haben eine eigene Default-Präsentation unter
<code>
/var/www/bigbluebutton-default/chaotikum.pdf
</code>
Damit diese verwendet wird, muss in der Datei
<code>
/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties
</code>
folgende Zeile angepasst werden:
<code>
# Default Uploaded presentation file
beans.presentationService.defaultUploadedPresentation=${bigbluebutton.web.serverURL}/chaotikum.pdf
</code>

[[https://docs.bigbluebutton.org/admin/customize.html#change-the-default-presentation|Anleitung: Change the default presentation]]


===== Webcam-Hintergrund-Bilder anpassen =====

Wir haben eigene Hintergrundbilder unter
<code>
/usr/share/meteor/bundle/programs/web.browser/app/resources/images/virtual-backgrounds
</code>
Damit diese verwendet werden, muss in der Datei
<code>
/usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml
</code>
folgende Information angepasst werden:
<code>
public:
  virtualBackgrounds:
    enabled: true
    storedOnBBB: true
    showThumbnails: true
    imagesPath: /resources/images/virtual-backgrounds/
    thumbnailsPath: /resources/images/virtual-backgrounds/thumbnails/
    fileNames:
      - sofaecke.jpg
      - werkstatt.jpg
      - chaotikum-logo.jpg
      - chaotikum.jpg
      - home.jpg
      - coffeeshop.jpg
      - board.jpg
</code>

[[https://docs.bigbluebutton.org/admin/customize.html#use-custom-images-for-virtual-background|Anleitung: Use custom images for virtual background]]

Die Beschreibungen der Hintergründe könnte man in den Dateien
<code>
/usr/share/meteor/bundle/programs/web.browser/app/locales/en.json
/usr/share/meteor/bundle/programs/web.browser/app/locales/de.json
</code>
anpassen. Dafür muss man aber die SHA1 der angepasste Dateien neu generieren. Siehe [[https://github.com/bigbluebutton/bigbluebutton/issues/12937|GitHub Issue #12937]]
===== Mehr Breakout-Räume erlauben =====

Man könnte das
<code>
breakoutRoomLimit
</code>
in der Datei
<code>
/usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml 
</code>
von 16 erhöhen:
<code>
    breakoutRoomLimit: 16
</code>

===== bbbstatus (NICHT INSTALLIERT) =====

<code>
pip3 install uwsgi requests flask flask-caching flask-cors
git clone https://git.chaotikum.org/chaotikum/bbbstatus.git
</code>

Datei ''%%/home/linadmin/bbbstatus/config.py%%'':
<code>
url = 'https://plaudern.chaotikum.org/bigbluebutton/api/'
action = 'getMeetingInfo'
meetingID = 'sb5cz439t1u5cxgflyehsqszzvv23arldqe7qxsz'
secret = 'SECRET_SECRET_SECRET'
</code>

Secret übernehmen aus ''%%bbb-conf --secret%%''

Datei ''%%/etc/bigbluebutton/nginx/bbbstatus.nginx%%'':
<code>
location /status {
    proxy_pass http://127.0.0.1:9009/status;
    include proxy_params;
}
</code>

Datei ''%%/lib/systemd/system/bbbstatus.service%%'':
<code>
[Unit]
Description=uWSGI BBB Status
After=syslog.target

[Service]
ExecStart=/usr/local/bin/uwsgi --socket localhost:9009 --protocol=http --chdir /home/linadmin/bbbstatus -w status

# Requires systemd version 211 or newer
RuntimeDirectory=uwsgi
Restart=always
KillSignal=SIGQUIT
Type=notify
StandardError=syslog
NotifyAccess=all

[Install]
WantedBy=multi-user.target
</code>

<code>
systemctl enable bbbstatus
systemctl start bbbstatus
</code>

Läuft unter https://plaudern.chaotikum.org/status

===== Wartung =====

{{topic>:infrastruktur:wartung?wartungsfenster +bbb &nodate&nouser&desc&table}}