Outils pour utilisateurs

Outils du site


bigbluebutton_container_lxc

BigBlueButton - Installation et Configuration

BigBlueButton (BBB) sur un serveur dédié

Install de BigBlueButton

Voir la doc d'install officielle de BigBlueButton. Au moment d'écrire ces lignes, on est à la version 2.4.

L'installation passe par l'execution d'un script bbb-install.sh qui sera téléchargé par la commande officielle de la doc.

Une fois l'installation réalisée, il faut configurer le hostname, notamment pour que le test d'écho ne reste pas bloqué. On utilise la commande bbb-conf qui est l'outil de configuration de BBB. Voir la doc de bbb-conf.

bbb-conf --setip bbb.futuretic.fr

Potentielles erreurs au test d'echo : ticket 1, ticket 2.

Mise à jour de BigBlueButton

D'après la doc d'install, il suffit de relancer le script bbb-install.sh en le retéléchargeant. La commande pour la version 2.4 de BBB est (remplacer le nom de domaine et le mail) :

wget -qO- https://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- -v bionic-240 -s bbb.example.com -e notice@example.com  -a -w

Install de Greenlight

Greenlight est une interface graphique qui permet de gérer et utiliser le serveur BigBlueButton.

Suivre la procédure d'install.

Mise à jour de Greenlight

D'après la doc, il faut aller dans le dossier d'installation de Greenlight, puis executer :

docker-compose pull
docker-compose down
docker-compose up -d

Vérifier aussi si le fichier .env a changé en le comparant à sa dernière version.

Réglages et erreurs potentielles

Réglages complémentaires

Changement du PDF d'accueil par défaut

Il convient de remplacer le fichier default.pdf dans le répertoire /var/www/bigbluebutton-default/ par le votre

cp default.pdf /var/www/bigbluebutton-default/default.pdf

Celui de futuretic est ici.

Éliminer les messages audio "you are now unmuted"

Ajouter un numéro SIP pour accéder aux salons

Suivre cette documentation - marche avec SIP OVH à 0,99 € HT / mois

Ajouter un serveur TURN/STUN pour que BBB soit accesible sur des réseaux fermés

Glitch audio sur partage d'écran

Réduire le débit pour le partage d'écran comme indiqué dans le post du Tetalab (tias_content et as_content initalement à respectivement 1500000 et 1500).

Attention, ce fichier est écrasé lors de mises à jour.

nano /usr/local/bigbluebutton/bbb-webrtc-sfu/config/default.yml
  H264:
    profile_level_id: "42e01f"
    packetization_mode: "1"
    level_asymmetry_allowed: "1"
    tias_main: "300000"
    as_main: "300"
    tias_content: "300000"
    as_content: "300"
...
  VP8:
    tias_main: "300000"
    as_main: "300"
    tias_content: "300000"
    as_content: "300"

Pour éviter les glitchs audio en cas de partage d'écran sur une connexion +/- bas débit : voir ce ticket qui explique comment réduire le débit max alloué au partage d'écran.

Traduire le message d'accueil

Modifier le fichier suivant, Attention, ce fichier est écrasé lors de mises à jour.

nano /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties

Enregistrements

La documentation pour les enregistrements

Quelques commandes utiles pour lister les enregistrements et les reconstituer

bbb-record --list

Rebuild

bbb-record --rebuild 6e35e3b2778883f5db637d7a5dba0a427f692e91-1379965122603

Rebuildall

bbb-record --rebuildall

Debug

bbb-record --debug

Monitor

bbb-record --watch 

Effacements automatiques au bout de 150 jours à faire dans :

nano /etc/cron.daily/bigbluebutton

Possibilité aussi de modifier la conservation des logs, de l'historique… :

history=150
unrecorded_days=150
published_days=150
log_history=150

Ajouter un script + docker pour transformer les enregistrements de session en fichiers .mp4 téléchargeables

Pour ajouter un bouton de téléchargement dans la présentation quand celle-ci est disponible au format .mp4 après rendu. Dépôt Github.

Troubleshooting

Voir la documentation à ce sujet.

bbb-conf --check
bbb-conf --restart

avec notamment pour monitoring en temps réel avec bbb-conf :

bbb-conf --watch

HTTPS happyness

Si la commande bbb-conf --check donne :

# Error: Could not connect to the configured hostname/IP address
#    http://bbb.futuretic.fr/

Alors

nano /etc/bigbluebutton/bbb-web.properties

Changer la référence à http://bbb.futuretic.fr/ en https://bbb.futuretic.fr/

Si problème avec pad, voir :

nano /usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml

Etherpad en carafe

Possibilité de passer en log DEBUG dans

nano /usr/share/etherpad-lite/settings.json
systemctl restart etherpad.service

Ensuite pour suivre en temps réel

journalctl -feu  etherpad.service

Pour une erreur du type :

[DEBUG] ueberDB - GET    - globalAuthor:a.7L65vwABuovcYjni - null - from database
[ERROR] console - TypeError: Cannot set property 'timestamp' of null

il faut faire un nettoyage de la bdd de l'etherpad qui est en fait une bdd redis avec un plug nodejs qui s'appelle UderDB, pour ce nettoyage voir cette réf.

systemctl stop etherpad.service
  redis-cli keys pad:* | xargs redis-cli del
  redis-cli keys sessionstorage:* | xargs redis-cli del
  redis-cli keys globalAuthor:* | xargs redis-cli del
  redis-cli keys token2author:* | xargs redis-cli del
  redis-cli keys pad2readonly:* | xargs redis-cli del
  redis-cli keys readonly2pad:* | xargs redis-cli del
systemctl start etherpad.service

Plus sauvage :

  redis-cli flushall 

Le test d'écho ne marche pas quand on entre dans une salle : erreur 1006

Dans la console du navigateur vous voyez :

ERROR: clientLogger: Audio error - errorCode=1006 bigbluebutton

Cela peut provenir de plusieurs causes, tout d'abord tenter :

bbb-conf --setip bbb.futuretic.fr

Pour le coup, ça provenait plus d'une config de la passerelle SIP à passer en https :

nano /etc/bigbluebutton/nginx/sip.nginx

Remplacer http par https et changer le port :

# proxy_pass http://135.181.143.55:5066;
proxy_pass https://135.181.143.55:7443;

Redémarrer

bbb-conf --restart

Voir ce ticket pour la référence.

Erreur : udp_send_buffer_errors

Voir cet article.

Connaitre la valeur des buffers UDP :

sysctl net.core.wmem_default net.core.wmem_max

Redhat recommande de les augmenter à 262144.

Il suffit d'ajouter à la fin du fichier /etc/sysctl.conf :

net.core.wmem_default=262144
net.core.wmem_max=262144

Puis de reload les paramètres de sysctl :

sysctl -p

Stress test

Pour tester la solidité du serveur : voir cet outil.

Installation d'un serveur de stream avec le module RTMP de nginx

BigBlueButton dans un container LXC : Failed !

On n'a pas réussi, mais voici ce qu'on a tenté en se référant à cet article sur l'install de BBB dans un container LXC.

Configurations spéciales à prendre en compte

Réglage sur le host

Pour proxy Apache, activer les modules nécessaires :

a2enmod proxy_http
a2enmod proxy

Réglage dans le container

Régler le démarrage de Redis-server : ajouter une option dans le fichier

nano /etc/systemd/system/redis.service
PrivateDevices=no
systemctl daemon-reload
systemctl start redis

Ressources complémentaires

Commandes utiles

Redémarrer BBB :

bbb-conf --restart
 

Checker la santé de BBB :

bbb-conf --check
bigbluebutton_container_lxc.txt · Dernière modification : 2022/05/19 14:51 de Labomedia