Version initiale de l'installation.

README.md

@@ -1,2 +1,110 @@
-# Service AUDIO
+# Service audio.chalec.org
 
+Service d'audio-conférence du chaton de Libre en communs basé sur le logiciel libre Mumble : https://www.mumble.info/.
+
+Responsable: Christian Momon (@cpm) 
+
+/!\/!\/!\/!\/!\/!\/!\
+RÉDACTION EN COURS
+/!\/!\/!\/!\/!\/!\/!\
+
+# Site web
+
+Pour l'instant :
+- le service Mumble n'a pas besoin de serveur web ;
+- décision de ne pas installer une application de client web pour Mumble.
+
+Cela n'empêchera pas les gens d'essayer d'aller sur la page web https://audio.chalec.org/.
+
+Donc une page d'information permet d'apporter une réponse à ce cas, par exemple en donnant des informations sur comment se connecter, comment configurer son client, où trouver un client…
+
+Il s'agit d'une simle page XHTML faite à la main et placée dans `/var/www/audio.chalec.org/`.
+
+# Service Mumble
+
+Service d'audio-conférence basé sur le logiciel libre Mumble : https://www.mumble.info/
+
+## Installation
+
+Ouvrir les ports nécessaires :
+```
+ufw allow 64738/udp
+ufw allow 64738/tcp
+```
+
+Installer le paquet :
+```
+apt-get install mumble-server
+```
+
+Configurer, notamment le mot de passe de SuperUser :
+```
+dpkg-reconfigure mumble-server
+```
+
+Transmettre le mot de passe à l'équipe.
+
+## Gestion du certificat
+
+Utiliser le certificat SSL du site web `audio.chalec.org` pour enrichir le fichier `/etc/mumble-server.ini` :
+```
+sslCert=/etc/letsencrypt/live/audio.chalec.org/fullchain.pem
+sslKey=/etc/letsencrypt/live/audio.chalec.org/privkey.pem
+```
+
+Rendre les certificats lisibles par Mumble :
+```
+chgrp mumble-server /etc/letsencrypt/archive/audio.chalec.org/privkey*
+chmod g+r mumble-server /etc/letsencrypt/archive/audio.chalec.org/privkey*
+```
+
+À noter que cela suffit même en cas de regénération du certificat. En effet, Certbot a l'intelligence de propager le groupe et les permissions du groupe des certificats précédents ! C'est même indiqué dans la documentation officielle, https://eff-certbot.readthedocs.io/en/stable/using.html :
+```
+privkey.pem
+    Private key for the certificate […]
+
+    Note: As of Certbot version 0.29.0, private keys for new certificate
+    default to 0600. Any changes to the group mode or group owner (gid)
+    of this file will be preserved on renewals.
+```
+
+Redémarrer le service Mumble :
+```
+systemctl restart mumble-server
+```
+
+## Personnalisation
+
+### Amélioration de la qualité
+
+Dans le fichier `/etc/mumble-server.ini` :
+```
+bandwidth=100000
+```
+
+### Modifier le message d'accueil à la connexion
+Dans le fichier `/etc/mumble-server.ini` :
+```
+welcometext="<br />Bienvenue sur le service d'audio-conférence de <b>Chalec</b>.<br />https://audio.a-lec.org/<br />"
+```
+
+Pour mettre une image dans le message de bienvenue :
+- générer une image assez petite en format png ;
+- la convertir en base64 : ` cat chalec-logo.png | base64 -w 0 > t`
+- insérer le contenu de `t` dans le code `<center><img src='data:image/png;base64,0123456789ABCDEF' /><center>`
+
+### Renommer la racine
+Par défaut, la racine est nommée « Root ». Pour la renommer, éditer `/etc/mumble-server.ini` :
+```                                                                           
+registerName=Chalec
+```
+
+### Salons temporaires
+Pour autoriser la création de salons temporaires :
+- se connecter en tant que SuperUser
+- racine > souris bouton droit > onglet LCA 
+- cadre permissions : cocher « Créer des temporaires »
+- cliquer sur « OK ».
+
+### Salons par défaut
+Pour créer des salons par défaut, se connecter avec le compte `SuperUser` et faire clique-droit sur la racine puis `Ajouter`.