Installer la surcouche Greenlight
Qu'est ce que Greenlight ?⚓
Greenlight est une surcouche logicielle qui va permettre de gérer différents modes d'authentification pour le serveur BBB et proposer une interface d'utilisation du serveur.
Pourquoi installer Greenlight ? Pour l'instant, seuls les utilisateurs Sambaedu ayant un compte sur le réseau pédagogique peuvent utiliser le serveur. Dans le cadre d'un conseil de classe, conseil pédagogique, conseil d'administration et autres réunions, tous les acteurs n'ont pas de compte.
Greenlight va posséder sa propre interface de gestion accessible online, et va permettre de créer des utilisateurs qui pourront créer/partager des salons avec des liens publiques (protegés par mdp et/ou validation du propriétaire du salon)
Installation de Greenlight⚓
Greenlight va être installée dans un conteneur docker
Si docker n'est pas installé, il faudra le faire en faisant
apt install docker-io
On vérifiera que docker est bien installé en faisant
docker -v
La documentation officielle est disponible ici : https://docs.bigbluebutton.org/greenlight/gl-install.html
Celle-ci est en anglais et parait compliquée, mais est finalement simple à suivre puisqu'il suffit de faire des copiers/coller en root des différentes parties. (bien lire les items ATTENTION avant de commencer).
Attentionroot⚓
Il est obligatoire pour l'installation de greelight d'être en utilisateur root (et non avec des sudo).
Pour cela, on pourra faire sudo su
AttentionEmplacement de Greenlight⚓
Normalement, si on a bien fait l'installation en root, l'emplacement du conteneur est dans /root/
On trouvera donc les fichiers dans /root/greenlight/
AttentionBug présent dans la version du fichier docker-compose.yml⚓
Après avoir entré la ligne
docker run --rm bigbluebutton/greenlight:v2 cat ./docker-compose.yml > docker-compose.yml
Il est obligatoire de modifier la version du fichier ou la commande suivante ne marchera pas.
Pour cela, on édite le fichier
nano docker-compose.yml
Ensuite on remplace au début du fichier la version présente par celle-ci.
version: '2.0'
Normalement l'interface Greenlight sera accessible à l'adresse externe bbb du serveur suivie de /b
par exemple https://bbb.UAI.sambaedu.org/b/
Création d'un compte administrateur⚓
On effectue en root :
docker exec greenlight-v2 bundle exec rake admin:create["name","email","password","user"]
La connexion se fera avec l'adresse mail entrée comme identifiant, puis mdp.
Configuration de l'envoi de mail⚓
Pour ajouter des utilisateurs, on pourra envoyer "une invitation" aux utilisateurs choisis. Il est donc indispensable d'avoir configuré le fichier docker-compose.yml pour que greenlight puisse envoyer des mails. Cela peut se faire après l'installation de greenlight, il suffira juste de relancer le conteneur docker.
Pour cela, on édite le fichier .env situé dans /root/greenlight
On descend et on va dé-commenter la ligne
ALLOW_MAIL_NOTIFICATIONS=true
puis on suivra l'exemple donné en indiquant évidemment les bons paramètres.
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_DOMAIN=gmail.com
SMTP_USERNAME=<youremail@gmail.com>
SMTP_PASSWORD=<yourpassword>
SMTP_AUTH=plain
SMTP_STARTTLS_AUTO=true
SMTP_SENDER=<youremail@gmail.com>
On redémarre le conteneur docker et le serveur web (juste pour être sur que tout marche)
docker-compose down
docker-compose up -d
service nginx restart