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.

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 !

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

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

Remettre le fichier de présentation par default dans /var/www/bigbluebutton-default/assets/.

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.

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

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…

Possible aussi de forcer la langue, histoire de changer de celle des Monthy Python en modifiant la variable DEFAULT_LOCALE=fr

Une fois modifié le fichier .env, penser à redémarrer de zéro le container de Greenlight en allant dans son dossier /root/greenlight-v3 puis en executant :

docker-compose down && docker-compose up -d

Un docker restart ou docker-compose restart ne prend plus en compte les changements du .env depuis la version 3.0.6…

Il suffit de réexecuter le script d'install.

Vérifier des choses :

# Pour vérifier les erreurs
bbb-conf --check
 
# Pour vérifier le status des différents service de BBB
bbb-conf --status
 
# Pour voir la version de chaque service de BBB
dpkg -l | grep bbb-

Redémarrer BBB :

bbb-conf restart

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

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