Table des matières
BigBlueButton - Installation et Configuration
Au moment d'écrire ce tutoriel, nous installons BBB 2.6.x sur la distribution recommandées : Ubuntu 20.04 LTS.
Notez que BigBlueButton est le serveur mais l'interface visible dans votre navigateur est un composant séparé, installé automatiquement, appelé Greenlight.
Installation
Après avoir installé une version de base d'Ubuntu 20.04 LTS, il suffit de suivre la documentation officielle : il suffit d'executer une seule ligne de commande et tout est prêt !
Configuration de BigBlueButton
Conservation des enregistrements
Pour changer la durée de conservation, créer / modifier le fichier /etc/default/bigbluebutton-cron-config :
#!/bin/bash # Keep records 1 month history=30 unrecorded_days=30 published_days=30 log_history=30
Permettre de télécharger les enregistrements
On va ajouter à BBB la possibilité de créer un fichier .webm par salle enregistrée.
On suit la Doc officielle, ce qui donne :
Install du paquet bbb-playback-video :
apt install bbb-playback-video
Modification du fichier /usr/local/bigbluebutton/core/scripts/bigbluebutton.yml :
# On remplace : steps: archive: 'sanity' sanity: 'captions' captions: 'process:presentation' 'process:presentation': 'publish:presentation' # Par : steps: archive: 'sanity' sanity: 'captions' captions: - 'process:presentation' - 'process:video' 'process:presentation': 'publish:presentation' 'process:video': 'publish:video'
Après sauvegarde du fichier, on redémarre le processus chargé de la création des vidéos :
systemctl restart bbb-rap-resque-worker.service
Fichier PDF par défaut
Remettre le fichier de présentation par default dans /var/www/bigbluebutton-default/assets/default/.
Supprimer les messages audio gênants
Pour supprimer les messages en anglais “you are now unmuted” et consors, modifier le fichier /opt/freeswitch/etc/freeswitch/autoload_configs/conference.conf.xml en commentant les lignes :
<param name="muted-sound" value="conference/conf-muted.wav"/> <param name="unmuted-sound" value="conference/conf-unmuted.wav"/> <param name="alone-sound" value="conference/conf-alone.wav"/>
Penser à redémarrer BBB.
Serveur TURN/STUN
A partir de BBB 2.6, un serveur coturn pour TURN est inclus et préconfiguré, plus besoin d'en installer un séparemment.
Attention : il faut modifier le fichier /etc/hosts pour ajouter le nom de domaine de BBB aux IP v4 et v6. Par exemple :
65.126.87.141 bbb.mondomaine.org
Configuration de Greenlight
Ouvrir le fichier /root/greenlight-v3/.env pour y changer les paramètres d'envoi de mail via SMTP authentifié. Toute la partie comprenant SMTP_SENDER_EMAIL, SMTP_SENDER_NAME…
Mise à jour
BigBlueButton
Il suffit de réexecuter le script d'install.
Greenlight
Suivre la procédure officielle.
Commandes pratiques
Vérifier l'install :
bbb-conf --check # et aussi : bbb-conf --status
Redémarrer BBB :
bbb-conf restart
Migration depuis BBB 2.4.x
On a dû migrer notre ancienne installation en 2.4 vers la 2.6. Heureusement, tout est prévu.
Pour ça on a suivi la méthode officielle.
Cela transfert les utilisateurs, les rôles, les salles et les paramètres. Il ne reste que les enregistrements à migrer manuellement.
A la fin du transfert des fichiers au bon endroit, il faut resynchroniser les enregistrements avec les salles pour que les utilisateurs retrouvent leurs petits. On execute la commande :
docker exec -it greenlight-v3 bundle exec rake server_recordings_sync
Monitoring via Netdata
Il faut d'abord autoriser le 19999 dans le firewall (celui sur lequel netdata est visible) :
ufw allow 15999
Puis on suit la doc officielle, qui propose d'executer une simple commande.
On peut configurer Netdata pour écouter sur un autre port, par exemple 14444 au lieu de 19999. Aller dans /etc/netdata et modifier la config en executant :
./edit-config netdata.conf
Changer le port par defaut en ajoutant :
[web] default port = 14444
Penser à ajouter la règle dans ufw :
ufw allow 14444