====== 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 [[https://bigbluebutton.org/|BigBlueButton]] est le serveur mais l'interface visible dans votre navigateur est un composant séparé, installé automatiquement, appelé [[https://docs.bigbluebutton.org/greenlight/v3/install|Greenlight]].
===== Installation =====

Après avoir installé une version de base d'Ubuntu 20.04 LTS, il suffit de suivre [[https://docs.bigbluebutton.org/administration/install/|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** :

<code bash>
#!/bin/bash

# Keep records 1 month
history=30
unrecorded_days=30
published_days=30
log_history=30
</code>

==== 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 [[https://docs.bigbluebutton.org/administration/customize/#install-additional-recording-processing-formats|Doc officielle]], ce qui donne :

Install du paquet **bbb-playback-video** :

<code bash>
apt install bbb-playback-video
</code>

Modification du fichier **/usr/local/bigbluebutton/core/scripts/bigbluebutton.yml** :

<code bash>
# 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'
</code>

Après sauvegarde du fichier, on redémarre le processus chargé de la création des vidéos :

<code bash>
systemctl restart bbb-rap-resque-worker.service
</code>

==== Fichier PDF par défaut ====

Remettre le {{::default.pdf|fichier de présentation par default}} dans **/var/www/bigbluebutton-default/assets/**.

==== 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 :

<code bash>
<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"/>
</code>

Penser à redémarrer BBB.

==== Serveur TURN/STUN ====

A partir de BBB 2.6, un serveur coturn pour TURN [[https://docs.bigbluebutton.org/administration/turn-server/|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 :

<code bash>
65.126.87.141  bbb.mondomaine.org
</code>
===== 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...

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 :

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

Un **docker restart** ou ** docker-compose restart** ne prend plus en compte les changements du **.env** depuis la version 3.0.6...
===== Mise à jour =====

Il suffit de [[https://github.com/bigbluebutton/bbb-install/blob/v2.7.x-release/bbb-install.sh|réexecuter le script d'install]].


===== Commandes pratiques =====

Vérifier des choses :

<code bash>
# 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-
</code>

Redémarrer BBB :

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

===== 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 [[https://docs.bigbluebutton.org/greenlight/v3/migration/|la méthode officielle]].

Cela transfert les utilisateurs, les rôles, les salles et les paramètres. Il ne reste que les enregistrements à [[https://docs.bigbluebutton.org/administration/customize/#transfer-published-recordings-from-another-server|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 :

<code bash>
docker exec -it greenlight-v3 bundle exec rake server_recordings_sync
</code>

===== Monitoring via Netdata =====

Il faut d'abord autoriser le 19999 dans le firewall (celui sur lequel netdata est visible) :

<code bash>
ufw allow 15999
</code>

Puis on suit [[https://learn.netdata.cloud/docs/installation/installation-methods/one-line-installer-kickstart.sh|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 :

<code bash>
./edit-config netdata.conf
</code>

Changer le port par defaut en ajoutant :

<code bash>
[web]
    default port = 14444
</code>

Penser à ajouter la règle dans ufw :

<code bash>
ufw allow 14444
</code>