Contexte et solution apportée

...

• Édition d'un webinaire, par le présentateur (notion de premier modérateur dans BigBlueButton)

Image RemovedImage Added

• Les explications sur le mode webinaire, accessible aux usagers

...

• L'interface BigBlueButton, avec le compte streaming connecté

• La page des évènements en direct

...

• Le direct pour les auditeurs, avec le chat intégré (si activé par le présentateur)

• Les informations et actions réalisables sur un webinaire en cours

...

• BigBlueButton, que cela soit une infrastructure locale ou plutôt celle de l'ESR
  
  
• SIPMediaGW, le projet de connecteur de salles visioconférence par RENATER
  https://www.renater.fr/connecteur-de-salles-la-solution-dinteroperabilite-entre-les-differents-systemes-de-visioconference/
• Pod, en ce qui concerne l’interface usager et la jonction avec BigBlueButton. 

Au final, techniquement, voici ce que cela donne :

Image Added

Copie d'écran d'une présentation réalisée par Nicolas Can et Loïc Bonavent lors des Journées Esup-Pod#3 : "10 ans déjà" à l'Université d'Avignon, en mars 2024.

SIPMediaGW par RENATER

Présentation

SIPMediaGW est un connecteur de salles visioconférence, une solution d’interopérabilité entre les différents systèmes de visioconférence par RENATER.

cf. En cours de définition. cf. https://www.renater.fr/connecteur-de-salles-la-solution-dinteroperabilite-entre-les-differents-systemes-de-visioconference/

Le but de ce projet est de mettre à disposition une brique fonctionnelle compatible avec les standards du protocole WebRTC permettant l’accès depuis un équipement de salle de visioconférence (Cisco, Polycom…) à des instances BigBlueButton / Jitsi-Meet.

RENATER a ajouté, dans les versions récentes de SIPMediaGW, une autre fonctionnalité permettant de réaliser une publication RTMP de la session, ce qui permet de réellement transformer une réunion en webinaire.

C'est cette fonctionnalité de publication RTMP du SIPMediaGW que nous utilisons dans le ce contexte de mode webinaire, avec diffusion en direct sur Pod.

Installation

Pour ma part, voici comment j'ai installé SIPMediaGW sur une machine virtuelle à l'université de Montpellier.

La machine virtuelle

Je suis parti d'une VM tournant sous ubuntu/focal64, avec 8 vCPU / 6 Go RAM.

Installation et configuration

Le site de référence : https://github.com/Renater/SIPMediaGW

Pré-requis

# Création d'un user : vagrant
adduser vagrant
usermod -aG wheel vagrant
# Installation de git
sudo apt-get install git

Installation effective

# Récupération de la dernière version de SIPMediaGW depuis Git, dans le répertoire applicatif /sipmediagw
cd /
sudo git clone https://github.com/Renater/SIPMediaGW.git sipmediagw
chown vagrant:vagrant /sipmediagw/ -R
cd /sipmediagw/deploy/
# Penser à mettre l'adresse IP publique de votre serveur
HOST_IP=1.2.3.4 ./provision.sh

Veuillez remplacer 1.2.3.4 par l'adresse IP publique de votre serveur.

Configuration

# Editer le fichier/sipmediagw/.env avec ses valeurs
MAIN_APP=streaming
BROWSE_FILE="bigbluebutton.py"

Par défaut, le jeton de sécurité est initialisé à 1234.

Pour modifier ce comportement, il est nécessaire de modifier le fichier /sipmediagw/HTTPLauncher.py :

# Editer le fichier /sipmediagw/HTTPLauncher.py
allowedToken = '1234'

Redémarrage du service

# Redémarrer le service
sudo systemctl restart sipmediagw

Vérification et exploitation

En réalisant ces étapes, différents services seront installés, à savoir :

• coturn
• kamailio
• homer
• sipmediagw

Pour de la publication RTMP, à priori, seul le service sipmediagw est nécessaire (à faire confirmer).

Voici quelques commandes utiles à l'exploitation de l'application SIPMediaGW:

Commandes	Commentaires
sudo systemctl restart sipmediagw	Redémarrage du service sipmediagw
sudo systemctl status sipmediagw	Vérifie l'état du service sipmediagw. Remarque : au 1° démarrage, l'erreur suivante est normale: {'res':'error','type':'The gateway failed to launch'}
sudo docker ps	Permet de voir les containers qui tournent, en particulier renater/sipmediagw:1.5.5 lors d'un webinaire
sudo docker logs container_id	Permet de voir les logs de sipmediagw lors d'un webinaire container_id correspond à l'id du container renater/sipmediagw:1.5.5

Configuration et actions complémentaires dans Pod

...

...

################
# Utilisation du mode Webinaire pour le module des réunions
USE_MEETING_WEBINAR = True
# URL du serveur SIPMediaGW qui gère les webinaires (Ex: https://sipmediagw.univ.fr)
MEETING_WEBINAR_SIPMEDIAGW_URL = "https://sipmediagw.univ.fr"
# Jeton bearer du serveur SIPMediaGW qui gère les webinaires
MEETING_WEBINAR_SIPMEDIAGW_TOKEN = "token"
# Options possibles pour un webinaire
MEETING_WEBINAR_FIELDS = (
        "is_webinar",
        "enable_chat",
)
# Groupes d’accès ou affiliations des personnes autorisées à créer un webinaire
MEETING_WEBINAR_AFFILIATION = ["faculty", "employee", "staff"]
# Groupe des admins des webinaires
MEETING_WEBINAR_GROUP_ADMIN = "webinar admin"
################

...

Pour utiliser cette fonctionnalité, il est nécessaire de définir les informations liées à la publication RTMP et , au streaming HLS et au serveur SIPMediaGW.

Pour ce faire, il est nécessaire d'accéder au module d'Administration de Pod et de définir ses informations via le nouvel accès "Passerelles de live".

Ce nouveau système de passerelle de live fait la jointure entre une adresse RTMP et , un diffuseur de Pod, déjà existants dans Pod , - pour ceux qui utilisent des directs - et un serveur SIPMediaGW.

Ces informations sont accessible dans la partie Administration / Sessions / Passerelles de live

Image RemovedImage Added

Pour ajouter une passerelle de live, il suffit de :

• saisir l'adresse URL du flux RTMP, sous la forme rtmp://live.univ.fr/live/nom
  
  
• sélectionner un diffuseur Pod, qui pointe vers un flux HLS. Il est possible de choisir les paramètres de ce diffuseur.
  
  
• saisir l'adresse URL d'un serveur SIPMediaGW (cf. installation d'un serveur SIPMediaGW ci-dessus).
  
  
• saisir le jeton Bearer du serveur SIPMediaGW utilisé.

Fonctionnement global

Le principe de ce mode webinaire est d'être le plus simple et le plus intuitif possible pour l'usager :

...

Lorsque le présentateur démarre le webinaire :

• la réunion BigBlueButton est lancée.
  
  
• une requête, de démarrage, sera réalisée sur le serveur configuré SIPMediaGW qui va alors se connecter à Pod avec un utilisateur "streaming" sur la réunion définie comme webinaire.
  
  

• l'utilisateur streaming récupère le flux vidéo/audio et renvoie ce flux sur le serveur RTMP d'une passerelle de live disponible.
  
  
• les auditeurs peuvent alors assister au webinaire sur l'interface des directs; selon la configuration, le décalage doit être de l'ordre de 10s.
  Si le présentateur a coché l'option permettant d'activer le chat, les auditeurs connectés auront la possibilité d'envoyer un message directement via l'interface des directs dans Pod.
  Ce message sera envoyé à la session BigBlueButton du présentateur.

Pendant le webinaire, le présentateur peut utiliser l'ensemble des options et actions sur le webinaire, à savoir :

• modifier les paramètres de date et de durée,
• modifier le paramètre d'activation du chat,
• redémarrer seulement le direct
• arrêter seulement le direct,
• terminer immédiatement le webinaire (réunion et direct),
• terminer la réunion dans BigBlueButton, ce qui aura pour effet d'arrêter le direct en moins de 2 minutes.

Exploitation

L'interface d'administration

2 nouvelles interfaces sont maintenant disponibles dans l'administration, à savoir :

L'administration des passerelles de live

Image Added

L'administration des directs (au sens sessions BigBlueButton)

Image Added

Il y a aussi le module de gestion des directs, en particulier pour les évènements :

Image Added

Les fichiers de logs

Selon votre configuration (cf. fichier pod_uwsgi.ini), il vous est possible de retrouver les logs de ce mode webinaire dans le fichier de logs applicatif de Pod.

Par exemple, il peut s'agir de /home/pod/django_projects/podv3/uwsgi/uwsgi-pod.log ou /var/log/syslog

Il suffit de rechercher les lignes contenant le mot-clé webinar.

Voici un exemple de ligne en lien avec les webinaires :

[29/Mar/2024 14:50:11] INFO [webinar - webinar.py:225] start_rtmp_gateway for meeting 13 “Webinaire du 29 mars 2024”: {"res": "ok", "app": "streaming", "uri": ""} (EXCEPTION: None)