BigBlueButton-Installation (Entwurf)
Version 2.3 unter Ubuntu 18.04 LTS (Bionical Beaver)
Ausgangslage
- Installiert werden soll das Open Source Video-Konferenz System Big Blue Button.
- Da es sich um eine private Testinstanz handelt, werden die empfohlenen Systemvoraussetzungen weit unterschritten.
- Als Basis-Server dient eine unter ProxMox Virtualization Environment 6.2 virtualisierter Host mit folgenden Spezifikationen:
Serverspezifikationen
Architektur | x64 |
Prozessor | 1 Socket 2 Kerne Hardware: 2 x Intel(R) Pentium(R) CPU G3220 @ 3.00GHz (1 Socket) |
Hauptspeicher | 4GB RAM Hardware: 12 GB DDR3 1333MHz |
|
|
Betriebssystem |
Ubuntu 18.04.5 LTS (Bionic Beaver) Achtung: Informationen zum 11.09.2020 Ubuntu 18.04.x LTS (Bionic) wird nur in einem Devel-Release unterstützt. Ubuntu 20.04.1 LTS (Focal) wird noch nicht unterstützt. |
Text erst unterhalb des Inhaltsverzeichnisses fortsetzen
|
ProxMox-Konfiguration
Virtuelle Maschine erstellen
Virtuelle Maschine konfigurieren
Virtuelle Maschine anpassen
Zusätzliche Festplatten einbinden
Ubuntu-Installation
Snapshot erstellen
Virtuelle Maschine starten
Ubuntu Installation
Setup: Big Blue Button
- Login per Putty
- Benutzer: administrator
- sudo -i
- "dauerhaft" als root arbeiten
Vorbereitungen
Anmerkungen
- Pre-installation checks durchführen
- Wurde die VM exakt nach den Vorgaben erstellt, ist dieser Schritt unnötig.
Überprüfung der Sprache der "Locales"
Befehl |
cat /etc/default/locale
|
Ausgabe |
LANG="en_US.UTF-8"
|
Fehlerbehebung |
Fehler 1: Die Sprache entspricht nicht en_US.UTF-8 ("US-Englisch, UTF-8). apt-get install language-pack-en update-locale LANG=en_US.UTF-8 #Logout aus dem root-Kontext Exit #Logout aus dem Benutzer-Kontext Exit
|
Fehler 2: Der Eintrag "LC_ALL=en_US.UTF-8" ist zu sehen. nano /etc/default/locale
#Logout aus dem root-Kontext Exit #Logout aus dem Benutzer-Kontext Exit
|
Überprüfung der korrekt referenzierten Systemsprache
Befehl |
systemctl show-environment
|
Ausgabe |
LANG=en_US.UTF-8 PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
|
Fehlerbehebung |
Fehler: Die Systemsprache entspricht nicht en_US.UTF-8 ("US-Englisch, UTF-8). systemctl set-environment LANG=en_US.UTF-8
|
Überprüfung des freien RAMs
Befehl |
free -h
|
Ausgabe |
total used free shared buff/cache available Mem: 3.8Gi 143Mi 3.2Gi 0.0Ki 505Mi 3.5Gi Swap: 5.8Gi 0B 5.8Gi
Anmerkung: Empfohlen für einen produktiven Server sind mindestens 32GB an RAM. |
Fehlerbehebung |
Fehler: Das System verfügt über zu wenig RAM. Der Hauptspeicher sollte über die ProxMox-WebGUI erweitert werden. |
Überprüfung der Ubuntu-Version
Befehl |
cat /etc/lsb-release
|
Ausgabe |
DISTRIB_ID=Ubuntu DISTRIB_RELEASE=18.04 DISTRIB_CODENAME=focal DISTRIB_DESCRIPTION="Ubuntu 18.04.5 LTS"
Anmerkung: Empfohlen ist mindestens die Version Ubuntu 16.04.x LTS. |
Fehlerbehebung |
Fehler: Wenn es hier zu einem Fehler kommt, ist etwas Grundlegendes schief gelaufen. Es empfiehlt sich eine komplette Neuinstallation. |
Befehl |
uname -m
|
Ausgabe |
x86_64 Anmerkung: Zwingend erforderlich ist die 64-bit-Version. |
Fehlerbehebung |
Fehler: Wenn es hier zu einem Fehler kommt, ist etwas Grundlegendes schief gelaufen. Es empfiehlt sich eine komplette Neuinstallation. |
Überprüfung der IPv6-Kompatibilität
Befehl |
ip addr | grep inet6
|
Ausgabe |
inet6 ::1/128 scope host ... Anmerkung: Es wird dringend empfohlen, die IPv6-Unterstützung zu aktivieren. |
Fehlerbehebung |
Fehler: Die IPv6-Unterstützung wurde deaktiviert. Die Konfiguration von FreeSWITCH muss entsprechend angepasst werden. An dieser Stelle wird nicht genauer darauf eingegangen. |
Überprüfung des Linux-Kernels
Befehl |
uname -r
|
Ausgabe |
4.15.0-117-generic
...
Anmerkung: In der Anleitung wird der Kernel 4.x genannt. |
Fehlerbehebung |
Fehler: Wenn es hier zu einem Fehler kommt, ist etwas Grundlegendes schief gelaufen. Es empfiehlt sich eine komplette Neuinstallation. |
Überprüfung des CPU-Anzahl
Befehl |
cat /proc/cpuinfo | awk '/^processor/{print $3}' | wc -l
|
Ausgabe |
2
Anmerkung: Empfohlen für einen produktiven Server sind mindestens 4 CPUs. |
Fehlerbehebung |
Fehler: Wenn es hier zu einem Fehler kommt, ist etwas Grundlegendes schief gelaufen. Es empfiehlt sich eine komplette Neuinstallation. |
Überprüfung der Update-Quellen für "multiverse"
Befehl |
grep "multiverse" /etc/apt/sources.list
|
Ausgabe |
... deb http://de.archive.ubuntu.com/ubuntu bionic multiverse ... deb http://de.archive.ubuntu.com/ubuntu bionic-updates multiverse ... deb http://de.archive.ubuntu.com/ubuntu bionic-backports main restricted universe multiverse ... deb http://de.archive.ubuntu.com/ubuntu bionic-security multiverse Anmerkung: Abhängig vom Ubuntu-Release kann sich "bionic" (18.04) unterscheiden, z.B. "xenial" (16.04) |
Fehlerbehebung |
Fehler: Die Quellen sind nicht angegeben. In diesem Fall sind die fehlenden Quellen z.B. über nano oder dem folgenden Befehl der sources.list hinzuzufügen. echo "deb http://archive.ubuntu.com/ubuntu/ bionic multiverse" | sudo tee -a /etc/apt/sources.list
|
Die Installation
Anmerkungen
- Es werden drei Anwendungen von BigBlueButton benötigt:
- ffmpeg (Um Aufnahmen erstellen zu können)
- yq (um YAML-Dateien verarbeiten zu können)
- libreoffice (für Konversationen)
- Um die aktuellste Version verfügbar zu machen bzw. überhaupt eine Version verfügbar zu machen, müssen entsprechende Repositories hinzugefügt werden.
- Für Ubuntu 20.04.1 LTS stehen (Stand 10.09.2020) keine entsprechenden Quellen zur Verfügung.
Repositories für ffmpeg, yq und libreoffice hinzufügen
Befehl 1 |
add-apt-repository ppa:bigbluebutton/support -y
|
Interaktion |
nicht erforderlich
|
Fehlerbehebung |
Fehler 1: Es erscheint die Meldung, dass das Repository für die nächsten x Stunden nicht validiert werden kann. Ausgabe: E: Release file for http://de.archive.ubuntu.com/ubuntu/dists/bionic-updates/InRelease is not valid yet (invalid for another 7h 38min 44s). Updates for this repository will not be applied. E: Release file for http://de.archive.ubuntu.com/ubuntu/dists/bionic-backports/InRelease is not valid yet (invalid for another 7h 40min 14s). Updates for this repository will not be applied. E: Release file for http://de.archive.ubuntu.com/ubuntu/dists/bionic-security/InRelease is not valid yet (invalid for another 7h 37min 22s). Updates for this repository will not be applied. Lösung: Zeit und/oder Datum der VM sind fehlerhaft und müssen abgeglichen werden. systemctl restart systemd-timesyncd.service
|
Fehler 2: Stehen die Repositories (z.B. aufgrund einer zu neuen Ubuntu-Version) nicht zur Verfügung, erscheinen ähnliche Fehlermeldungen. Ausgabe: E: The repository 'http://ppa.launchpad.net/bigbluebutton/support/ubuntu focal Release' does not have a Release file. N: Updating from such a repository can't be done securely, and is therefore disabled by default. N: See apt-secure(8) manpage for repository creation and user configuration details.
Lösung: |
Befehl 2 |
add-apt-repository ppa:rmescandon/yq -y
|
Interaktion |
nicht erforderlich
|
Fehlerbehebung |
Fehler: Ausgabe:
Fehlerbehebung:
|
Befehl 3 |
add-apt-repository ppa:libreoffice/ppa
|
Interaktion |
To return to the LibreOffice version from the main archive, use ppa-purge. see: http://www.webupd8.org/2009/12/remove-ppa-repositories-via-command.html for details More info: https://launchpad.net/~libreoffice/+archive/ubuntu/ppa Press [ENTER] to continue or Ctrl-c to cancel adding it. Den Disclaimer mit [ENTER] bestätigen. |
Fehlerbehebung |
Fehler: Ausgabe:
Fehlerbehebung:
|
Aktualisierung von System und Anwendungen
Befehl |
apt-get update apt-get dist-upgrade
|
Interaktion |
Need to get 799 kB of archives. After this operation, 45.1 kB of additional disk space will be used. Do you want to continue? [Y/n]
Abfrage mit [y] bzw [Y] bestätigen An der folgenden Stelle benötigt der Vorgang mitunter mehrere Minuten in einer VM. I: The initramfs will attempt to resume from /dev/sdc1 I: (UUID=5cd9ade9-adbb-402d-817a-800d41674c84) I: Set the RESUME variable to override this.
|
Fehlerbehebung |
Fehler: Ausgabe:
Fehlerbehebung:
|
MongoDB installieren
Befehl |
wget -qO - https://www.mongodb.org/static/pgp/server-3.4.asc | apt-key add - echo "deb [ arch=amd64,arm64 ] http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | tee /etc/apt/sources.list.d/mongodb-org-3.4.list apt-get update apt-get install -y mongodb-org curl
Anmerkung |
Interaktion |
nicht erforderlich
|
Fehlerbehebung |
Fehler: Ausgabe:
Fehlerbehebung:
|
Java 8 installieren und zum Standard machen (für den reinen Betrieb erforderlich?)
Befehl | Anmerkung BigBlueButton (sowohl in Version 2.2 als auch in Version 2.3) benötigt die Java 8 Zusätzlich muss diese Version zum Standard gemacht werden. apt install openjdk-8-jdk
|
Interaktion |
Need to get 82.9 MB of archives. After this operation, 560 MB of additional disk space will be used. Do you want to continue? [Y/n]
Die Abfrage mit [y] bestätigen |
Fehlerbehebung |
Fehler: Ausgabe:
Fehlerbehebung:
|
NodeJS installieren
Befehl |
curl -sL https://deb.nodesource.com/setup_8.x| sudo -E bash - apt-get install -y nodejs
|
Interaktion |
Anmerkung: Während der Installation wird darauf verwiesen, dass NodeJS 8.x nicht länger Aktualisiert wird. Dennoch verweisen die Entwickler von BibBlueButton z.B. hier darauf hin, dass die (Stand 11.09.2020) aktuelle Version 2.2 von BigBlueButton NodeJS 8.x benötigt. Selbst die erwartete Version 2.3 wird nicht NodeJS 14.x, sondern NodeJS 12.x verwenden. Besonderheit bei der Installation von NodeJS 8.x root@bbb:~# curl -sL https://deb.nodesource.com/setup_8.x| sudo -E bash - ================================================================================ ================================================================================ DEPRECATION WARNING Node.js 8.x LTS Carbon is no longer actively supported! You will not receive security or critical stability updates for this version. You should migrate to a supported version of Node.js as soon as possible. Use the installation script that corresponds to the version of Node.js you wish to install. e.g. * https://deb.nodesource.com/setup_10.x — Node.js 10 LTS "Dubnium" * https://deb.nodesource.com/setup_12.x — Node.js 12 LTS "Erbium" (recommended) Please see https://github.com/nodejs/Release for details about which version may be appropriate for you. The NodeSource Node.js distributions repository contains information both about supported versions of Node.js and supported Linux distributions. To learn more about usage, see the repository: https://github.com/nodesource/distributions ================================================================================ ================================================================================ Continuing in 20 seconds ...
|
Fehlerbehebung |
Fehler: Ausgabe:
Fehlerbehebung:
|
BigBlueButton installieren
Befehl | Anmerkung Die Version 2.3 ist seit Juni in einer Beta-Version bzw. in einem Entwicklungsrelease hier verfügbar. Es gilt noch immer die Empfehlung, die Version 2.2 unter Ubuntu 16.04 einzusetzen. Eine Final der Version 2.3 wird noch im Jahr 2020 erwartet Stand (11.09.2020) Installation 2.2 unter Ubuntu 16.04 LTS wget https://ubuntu.bigbluebutton.org/repo/bigbluebutton.asc -O- | apt-key add - # Deinstallation eines vorhandenen bbb-clients (nur bei Update erforderlich) # bbb-conf --stop # apt-get purge -y bbb-client echo "deb https://ubuntu.bigbluebutton.org/xenial-22/ bigbluebutton-xenial main" | tee /etc/apt/sources.list.d/bigbluebutton.list Installation 2.3dev unter Ubuntu 18.04 LTS wget -qO- https://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- -v bionic-230-dev -s bbb.gate.apamo.eu -e bbb@apamo.eu -a -w
|
Interaktion |
nicht erforderlich
|
Fehlerbehebung |
Fehler: Ausgabe:
Fehlerbehebung:
|