Outils pour utilisateurs

Outils du site


admin:services:visio.chapril.org

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
admin:services:visio.chapril.org [2020/05/22 23:31] – [Coturn] cpmadmin:services:visio.chapril.org [2022/12/21 09:05] (Version actuelle) – [Rapports d'activité] davidd09
Ligne 76: Ligne 76:
 Installer certains paquets : Installer certains paquets :
 <code> <code>
-apt-get install gnupg2 apt-transport-https+apt-get install gnupg2
 </code> </code>
  
Ligne 189: Ligne 189:
 org.jitsi.videobridge.xmpp.user.shard.MUC_NICKNAME=XXXXXX-XXXXXX-XXXXXXX-XXXXXXXXX org.jitsi.videobridge.xmpp.user.shard.MUC_NICKNAME=XXXXXX-XXXXXX-XXXXXXX-XXXXXXXXX
 </code> </code>
 +
 +==== Limiter la mémoire de Videobridge ====
 +Par défaut, la valeur maximale de mémoire allouable est 3072 Mo, ce qui peut paraître beaucoup.
 +
 +À modifier dans le fichier ''/usr/share/jitsi-videobridge/lib/videobridge.rc''
 +<code>
 +VIDEOBRIDGE_MAX_MEMORY=2048m
 +</code>
 +
 +===== Activation des statistiques =====
 +
 +Éditer le fichier ''/etc/jitsi/videobridge/config'' :
 +<code>
 +JVB_OPTS="--apis=rest, "
 +</code>
 +
 +Redémarrer :
 +<code>
 +systemctl restart nginx.service  jicofo.service  jitsi-videobridge2.service
 +</code>
 +
 +Tester :
 +<code>
 +=(^-^)=root@allo:~# curl http://localhost:8080/about/version
 +{"name":"JVB","version":"2.1.376-g9f12bfe2","os":"Linux"}
 +
 +=(^-^)=root@allo:~# curl http://localhost:8080/colibri/conferences
 +[]
 +
 +=(^-^)=root@allo:~# curl  http://localhost:8080/colibri/stats 
 +{"inactive_endpoints":0,"inactive_conferences":0,"total_ice_succeeded_relayed"
 +
 +=(^-^)=root@allo:~# curl  http://localhost:8080/colibri/stats 2> /dev/null | jshon -e participants -u 
 +9
 +</code>
 +
 +Documentation :
 +  * https://github.com/jitsi/jitsi-videobridge/blob/master/doc/rest.md
 +  * https://github.com/jitsi/jitsi-videobridge/blob/master/doc/statistics.md#implementation
 +  * https://github.com/jitsi/jitsi-videobridge/blob/master/doc/rest-colibri.md
 +
 +
 ===== Personnalisation ====== ===== Personnalisation ======
  
Ligne 198: Ligne 240:
 <code> <code>
 mkdir /var/www/visio.chapril.org/ mkdir /var/www/visio.chapril.org/
 +</code>
 +
 +Copier le fichier de configuration de l'interface dans l'espace de fichiers personnalisés :
 +<code>
 +cd /var/www/visio.chapril.org/
 +cp /usr/share/jitsi-meet/interface_config.js .
 +</code>
 +
 +Ajouter dans ''/etc/nginx/sites-enabled/visio.chapril.org'' (avant les autres ''location'') :
 +<code>
 +   location = /interface_config.js {
 +       alias /var/www/visio.chapril.org/interface_config.js;
 +   }
 +</code>
 +
 +Activer la nouvelle configuration :
 +<code>
 +nginx -t && nginx -s reload
 </code> </code>
  
 ==== Favicon Chapril ==== ==== Favicon Chapril ====
 +
 +Le fichier : {{:admin:services:favicon-visiochaprilorg.ico}}
  
 Placer le fichier favicon dans l'espace qui va bien : Placer le fichier favicon dans l'espace qui va bien :
Ligne 207: Ligne 269:
 mkdir images mkdir images
 cd images cd images
-wget https://www.chapril.org/sites/v2.chapril.org/squelettes/css/favicon.ico+wget https://admin.chapril.org/lib/exe/detail.php?id=admin%3Aservices%3Avisio.chapril.org&media=admin:services:favicon-visiochaprilorg.ico 
 +mv favicon-visiochaprilorg.ico favicon.ico
 </code> </code>
  
Ligne 245: Ligne 308:
 </code> </code>
  
 +Modifier le fichier ''/var/www/visio.chapril.org/interface_config.js'' :
 +<code>
 +<     JITSI_WATERMARK_LINK: 'https://jitsi.org',
 +---
 +>     JITSI_WATERMARK_LINK: 'https://www.chapril.org/',
 +</code>
 ==== Parties tiers ==== ==== Parties tiers ====
  
Ligne 253: Ligne 322:
  
  
-==== Français en langue ====+==== Titres et onglet ==== 
 + 
 +Modifier le fichier ''/var/www/visio.chapril.org/interface_config.js''
 +<code> 
 +<     APP_NAME: 'Jitsi Meet', 
 +<     NATIVE_APP_NAME: 'Jitsi Meet', 
 +<     PROVIDER_NAME: 'Jitsi', 
 +--- 
 +>     APP_NAME: 'Visio.chapril.org', 
 +>     NATIVE_APP_NAME: 'Visio.chapril.org', 
 +>     PROVIDER_NAME: 'Chapril', 
 +</code> 
 + 
 +==== Interface en français ====
  
 Réglages pour imposer le français comme langue d'interface (permet de ne pas multiplier les traductions des personnalisations) : Réglages pour imposer le français comme langue d'interface (permet de ne pas multiplier les traductions des personnalisations) :
  
-Dans le fichier ''/usr/share/jitsi-meet/interface_config.js'' :+Dans le fichier ''/var/www/visio.chapril.org/interface_config.js'' :
 <code> <code>
 LANG_DETECTION: false, // Allow i18n to detect the system language   LANG_DETECTION: false, // Allow i18n to detect the system language  
Ligne 267: Ligne 349:
 </code> </code>
  
 +Dans le fichier ''/var/www/visio.chapril.org/interface_config.js'', personnaliser les champs suivants :
 +<code>
 +<     DEFAULT_REMOTE_DISPLAY_NAME: 'Fellow Jitster',
 +<     DEFAULT_LOCAL_DISPLAY_NAME: 'me',
 +---
 +>     DEFAULT_REMOTE_DISPLAY_NAME: 'autre',
 +>     DEFAULT_LOCAL_DISPLAY_NAME: 'moi',
 +</code>
 +==== Textes page d'accueil ====
 +
 +Copier le fichier français d'internalisation dans l'espace de fichiers personnalisés :
 +<code>
 +cd /var/www/visio.chapril.org/
 +mkdir lang
 +cd lang
 +cp /usr/share/jitsi-meet/lang/main-fr.json .
 +</code>
 +
 +Ajouter dans ''/etc/nginx/sites-enabled/visio.chapril.org'' (avant les autres ''location'') :
 +<code>
 +   location = /lang/main-fr.json {
 +       alias /var/www/visio.chapril.org/lang/main-fr.json;
 +   }
 +</code>
 +
 +Activer la nouvelle configuration :
 +<code>
 +nginx -t && nginx -s reload
 +</code>
 +
 +Modifier les entrées ''headerTitle'' et ''headerSubtitle'' comme suit :
 +<code>
 +<         "headerTitle": "Visio.chapril.org",
 +<         "headerSubtitle": "Visio.chapril.org est un service libre de visioconférence. Rien à installer, tout se passe dans votre navigateur. Pas de réglage à faire, le son est parfait par défaut.\nAnonyme, pas de besoin de compte. Chiffré, votre intimité numérique est préservée. Ouvert à tout le monde, invitez qui vous voulez, quand vous voulez. Recommandation : 5 personnes maximum par salon et éviter les connexions Internet faibles.",
 +---
 +>         "headerTitle": "Jitsi Meet",
 +>         "headerSubtitle": "Conférences sécurisées et de haute qualité",
 +</code>
 ==== Désactivation de la caméra par défaut ==== ==== Désactivation de la caméra par défaut ====
  
Ligne 285: Ligne 405:
 Dans ''/etc/jitsi/meet/visio.chapril.org-config.js'' : Dans ''/etc/jitsi/meet/visio.chapril.org-config.js'' :
 <code> <code>
 +     // Sets the preferred resolution (height) for local video. Defaults to 720.
 +-    // resolution: 720,
 ++    resolution: 360,
 +
 +
 -    // constraints: { -    // constraints: {
 -    //     video: { -    //     video: {
Ligne 307: Ligne 432:
 </code> </code>
  
-===== Gestion des erreurs =====+==== Retrait pub privateur ==== 
 +Dans le fichier ''/var/www/visio.chapril.org/interface_config.js''
 +<code> 
 +<     OPTIMAL_BROWSERS: [ 'chrome', 'chromium', 'firefox', 'nwjs', 'electron', 'safari' ], 
 +--- 
 +>     OPTIMAL_BROWSERS: [ 'chromium', 'firefox', 'nwjs', 'electron' ], 
 +</code> 
 + 
 + 
 +==== Retirer des entrées inutiles du menu ==== 
 + 
 +Actuellement, une fois dans un salon Jitsi, dans le menu sont proposées les entrées : 
 + 
 +  * Démarrer la diffusion en direct ; 
 +  * Commencer l'enregistrement ; 
 +  * Partager une vidéo YouTube. 
 + 
 +Sauf que quand on clique dessus, ça ne fonctionne pas. 
 + 
 +Alors, en fait, ces fonctionnalités ne sont pas souhaitables dans le cadre du Chapril : 
 + 
 +  * techniquement, elles nécessitent l'installation de services supplémentaires (Jibri) potentiellement complexes et très consommateurs de ressources ; 
 +  * certaines font la promotion de plateforme non libres… 
 +  * trop avancées pour le Chapril qui a pour but de faire découvrir des services libres et d'être utile. 
 + 
 +Si un utilisateur réclame ces fonctionnalités, 
 +il faut l'inviter à aller vers un autre hébergeur ou de s'héberger lui-même. 
 + 
 +Pour retirer ces entrées, éditer le fichier ''root@allo:/var/www/visio.chapril.org/interface_config.js'' 
 +et dans la variable ''TOOLBAR_BUTTONS'', retirer les valeurs ''sharedvideo'',''livestreaming'', ''recording'', puis redémarrer. 
 + 
 +Avant : {{:admin:services:jitsi-menu-avant.png?nolink|}} 
 +Après : {{:admin:services:jitsi-menu-apres.png?nolink|}} 
 + 
 +Ce sujet a fait l'objet du [[https://agir.april.org/issues/4887|ticket 4887]]. 
 +===== Patch needrestart ====== 
 + 
 +Needrestart est perturbé par Videobridge qu'il ne cesse de signaler comme étant à redémarré. 
 + 
 +Une issue est ouverte sur le projet officiel : https://github.com/jitsi/jitsi-videobridge/issues/1166 
 + 
 +En attendant, application d'une astuce trouvée sur https://unix.stackexchange.com/questions/574325/jitsi-videobridge-service-daemons-using-outdated-libraries. 
 +Dans /etc/needrestart/needrestart.conf : 
 +<code> 
 +$nrconf{blacklist_mappings} = [ 
 +[…] 
 +    # Videobridge bug (agir #5168). 
 +    qr(^/tmp/jna-), 
 +    qr(^/usr/share/jitsi-videobridge/.cache/JNA/temp/jna), 
 +    qr(^/tmp/nativeutils), 
 +</code> 
 + 
 +Et maintenant needrestart est ok. 
 + 
 +====== Supervision ====== 
 + 
 +===== Contrôle de l'expiration du certificat SSL ===== 
 +La sonde est située dans <code>/srv/visio.chapril.org/tools/monitoring/check_visio_certificate.sh</code> 
 + 
 +avec un lien vers 
 +<code>/usr/local/lib/nagios/plugins/check_visio_certificate</code> 
 + 
 +C'est une encapsulation de la sonde "standard" '**check_http**' avec des paramètres fixes et d'autres modifiables 
 +<code> 
 +./check_visio_certificate.sh -h 
 +check_visio_certificate 
 + 
 +SYNTAXE 
 + 
 +check_visio_certificate -t <seuils> -i <IP du frontal/bastion> 
 + 
 +EXEMPLE 
 + 
 +./check_visio_certificate -t 30,14 -i 192.168.1.1 
 +</code> 
 + 
 +Le premier seuil (30 dans l'exemple), donne le nombre de jours avant de générer un "**warning**" d'expiration. 
 + 
 +Le deuxième seuil (14 dans l'exemple), donne le nombre de jours avant de générer un "**critical**" d'expiration. 
 + 
 +===== Contrôle du process videobridge ===== 
 + 
 +La sonde est située dans <code>/srv/visio.chapril.org/tools/monitoring/check_jitsi_videobridge</code> 
 + 
 +avec un lien vers 
 +<code>/usr/local/lib/nagios/plugins/check_jitsi_videobridge</code> 
 + 
 + 
 +C'est une encapsulation de la sonde "standard" check_procs avec l'argument '-a' forcé à "jitsi-videobridge" 
 + 
 +===== Contrôle du process jicofo ===== 
 + 
 +La sonde est située dans <code>/srv/visio.chapril.org/tools/monitoring/check_jitsi_jicofo</code> 
 + 
 +avec un lien vers 
 +<code>/usr/local/lib/nagios/plugins/check_jitsi_jicofo</code> 
 + 
 + 
 +C'est une encapsulation de la sonde "standard" check_procs avec l'argument '-a' forcé à "jicofo" 
 + 
 +====== Rapports d'activité ====== 
 +Des rapports d'activité sont générés à plusieurs niveaux (granularité, dates,...) 
 + 
 +Un rapport d'activité est produit avec le script "standard" **rapport_activite.sh** 
 + 
 +Il est situé dans  
 +<code> 
 +/srv/visio.chapril.org/tools/rapport_activite/rapport_activite.sh 
 +</code> 
 + 
 +Ce script génère des éléments statistiques par analyse des fichiers de LOGs du serveur 
 + 
 +Un complèment à ces informations a été ajouté en utilisant les statistiques internes à jitsi : **Colibri** 
 + 
 +Le script est situé dans  
 +<code> 
 +/srv/visio.chapril.org/tools/statistiques/parseStats.py 
 +</code> 
 + 
 +Il exploite un autre script qui génère des statistique directement depuis le serveur de visio 
 +<code> 
 +/srv/visio.chapril.org/tools/statistiques/getStats.py 
 +</code> 
 +Les données statistiques sont récoltées et stockées dans une base de données sqlite dans 
 +<code> 
 +/srv/visio.chapril.org/statistiques/stats_sqlite.db 
 +</code> 
 + 
 +Elles sont ensuuite consolidés par le script **parseStats.py** avant d'être envoyé dans le rapport d'activité. 
 + 
 +Ces deux scripts sont appelés par un fichier //cron//  
 + 
 +<code> 
 +/etc/cron.d/visiochaprilorg-rapportactivite 
 +</code> 
 + 
 + 
 +permettant d'ajouter leur résultat directement dans un ticket //redmine// dédié à cette récolte : [[https://agir.april.org/issues/4368]] 
 + 
 + 
 + 
 +====== Gestion des erreurs ======
  
 ===== Coturn ===== ===== Coturn =====
  
 Attention, démarrer le service coturn provoque une erreur dans la connexion au videobridge. Attention, démarrer le service coturn provoque une erreur dans la connexion au videobridge.
-====== Raw ======+====== Trace d'installation de PolluX ======
  
  
Ligne 1466: Ligne 1732:
 </code> </code>
  
 +====== Voir aussi ======
  
 +  * https://wiki.hadoly.fr/documentation_technique:jitsi
  
admin/services/visio.chapril.org.1590190273.txt.gz · Dernière modification : 2020/05/22 23:31 de cpm