Différences

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

--- admin:services:visio.chapril.org [2020/05/22 21:23] – [Partis tiers] cpm
+++ admin:services:visio.chapril.org [2024/04/02 20:40] (Version actuelle) – [Textes page d'accueil] davidd09
@@ Ligne 76: / Ligne 76: @@
 Installer certains paquets :
 <code>
-apt-get install gnupg2 apt-transport-https
+apt-get install gnupg2
 </code>
@@ Ligne 189: / Ligne 189: @@
 org.jitsi.videobridge.xmpp.user.shard.MUC_NICKNAME=XXXXXX-XXXXXX-XXXXXXX-XXXXXXXXX
 </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
+</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 ======
@@ Ligne 198: / Ligne 240: @@
 <code>
 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>
 ==== Favicon Chapril ====
+Le fichier : {{:admin:services:favicon-visiochaprilorg.ico}}
 Placer le fichier favicon dans l'espace qui va bien :
@@ Ligne 207: / Ligne 269: @@
 mkdir 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>
@@ Ligne 245: / Ligne 308: @@
 </code>
-==== Partis tiers ====
+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 ====
 Dans le fichier ''/etc/jitsi/meet/visio.chapril.org-config.js'' :
@@ Ligne 251: / Ligne 320: @@
     disableThirdPartyRequests: true,
 </code>
-==== Page d'accueil =====
-À faire.
-==== Paramétrage de la langue ====
-Dans le fichier ''/usr/share/jitsi-meet/interface_config.js'' :
+==== Titres et onglet ====
+Modifier le fichier ''/var/www/visio.chapril.org/interface_config.js'' :
 <code>
-LANG_DETECTION: true, // Allow i18n to detect the system language
+<     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>
-Donc la langue est déduite de celle du navigateur. Cela parait un bon réglage.
+==== Interface en français ====
-==== Activation du micro et caméra par défaut ====
+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>
+LANG_DETECTION: false, // Allow i18n to detect the system language
+</code>
+Dans le fichier ''/etc/jitsi/meet/visio.chapril.org-config.js'' :
+<code>
+    defaultLanguage: 'fr',
 </code>
-====== Raw ======
+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>
+Ajouter un lien vers la messagerie support sur la page d'accueil
+Fichier /usr/share/jitsi-meet/static/welcomePageAdditionalContent.html
+<code>
+<span style="margin-left: 30%;padding: 10px; background: rgb(5%,5%,15%); color: rgb(95%,95%,100%);font-size:14pt;">En cas de probl&egrave;me vous pouvez contacter le     support &agrave; cette adresse : <a href="mailto:visio-support@chapril.org">Message support</a></span>
+</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 ====
+Dans le fichier ''/etc/jitsi/meet/visio.chapril.org-config.js'' :
+<code>
+    startWithVideoMuted: true,
+</code>
+Possibilité de désactiver automatiquement à partir d'un certain nombre de participants :
+<code>
+    // Every participant after the Nth will start video muted.
+    // startVideoMuted: 10,
+</code>
+==== Abaisser la qualité vidéo par défaut ====
+Dans ''/etc/jitsi/meet/visio.chapril.org-config.js'' :
+<code>
+     // Sets the preferred resolution (height) for local video. Defaults to 720.
+-    // resolution: 720,
++    resolution: 360,
+-    // constraints: {
+-    //     video: {
+-    //         aspectRatio: 16 / 9,
+-    //         height: {
+-    //             ideal: 720,
+-    //             max: 720,
+-    //             min: 240
+-    //         }
+-    //     }
+-    // },
++    constraints: {
++        video: {
++            aspectRatio: 16 / 9,
++            height: {
++                ideal: 360,
++                max: 360,
++                min: 240
++            }
++        }
++    },
+</code>
+==== 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 =====
+Attention, démarrer le service coturn provoque une erreur dans la connexion au videobridge.
+====== Trace d'installation de PolluX ======
@@ Ligne 1424: / Ligne 1740: @@
 </code>
+====== Voir aussi ======
+  * https://wiki.hadoly.fr/documentation_technique:jitsi