Contexte et solution apportée

...

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

...

...

L'administration des passerelles de live

Image RemovedImage Added

L'administration des directs (au sens sessions BigBlueButton)

...