MaJ (MySQL8 en dépendance, config mmctl, utilisation de mmctl pour reload la conf)

HowtoMattermost.md

@@ -6,16 +6,16 @@ title: Howto Mattermost
 * Documentation : <https://docs.mattermost.com>
 
 
-[Mattermost](https://mattermost.com) est un logiciel libre de discussion instantanées. C'est une alternative open source à Slack.
+[Mattermost](https://mattermost.com) est un logiciel libre de discussion instantanées en équipe. C'est une alternative open source à Slack qu'on peut héberger soi-même.
 
 ## Installation
 
 ### Pré-requis
 
-Une machine avec Debian 11 (Bullseye) avec les logiciels suivants : 
+Une machine avec Debian 11 (Bullseye) ou plus récent avec les logiciels suivants : 
 
 * [Nginx](/HowtoNginx) - Servira de reverse proxy web
-* [MySQL](/HowtoMySQL) - Base de donnée pour l'application
+* [MySQL 8](/HowtoMySQL) - Base de donnée pour l'application -- **Obligatoirement** MySQL 8 car Mattermost n'est plus compatible avec MariaDB 
 
 ### Mise en place 
 
@@ -24,12 +24,12 @@ Tout d'abord, on a besoin :
 * D'un utilisateur unix : `mattermost`
 
 
-On récupère donc la dernière version Team LTS (actuellement la 7.8.1) et on déroule : 
+On récupère donc la dernière version Team LTS (actuellement la 8.1.6) et on déroule : 
 
 ~~~
 # su - mattermost
-$ wget https://releases.mattermost.com/7.8.1/mattermost-team-7.8.1-linux-amd64.tar.gz
-$ tar mattermost-team-7.8.1-linux-amd64.tar.gz
+$ wget https://releases.mattermost.com/7.8.1/mattermost-team-8.1.6-linux-amd64.tar.gz
+$ tar mattermost-team-9.1.6-linux-amd64.tar.gz
 $ cd mattermost
 $ mkdir data
 ~~~
@@ -69,7 +69,7 @@ Par défaut, Mattermost écoute sur le port 8065. En s'y connectant, on peut cr
 
 On peut aussi configurer nginx comme reverse proxy en s'inspirant de la configuration conseillée dans [la documentation officielle](https://docs.mattermost.com/install/install-debian.html#configuring-nginx-as-a-proxy-for-mattermost-server).
 
-> Note: La configuration proposée par les développeurs s'appuie sur le module de cache de nginx. Ce module permet de décharger de certaines requêtes le service mattermost. Mais il peut compliquer les test lors de soucis sur l'interface web.
+> Note: La configuration proposée par les développeurs s'appuie sur le module de cache de Nginx. Ce module permet de décharger de certaines requêtes le service Mattermost. Mais il peut compliquer les tests lors de soucis sur l'interface web. Dans cet exemple de configuration il n'est donc pas activé par défaut.
 
 ~~~
 upstream backend {
@@ -145,12 +145,29 @@ Voir [la documentation officielle](https://docs.mattermost.com/administration/up
 # Plugins
 
 Mattermost est extensible avec de nombreux plugins.
-La plupart du temps, il suffit de décompacter une archive dans le répertoire `plugins/` puis de l'activer dans la console système.
+La plupart du temps, il suffit de décompacter une archive dans le répertoire `plugins/` puis de l'activer dans la console système. Il est aussi possible d'uploader l'archive du plugin via la console système si cette option à été activée dans le `config.json`
 
 # FAQ / Plomberie
 
-## Supprimer une équipe
+## Configuration de l'outil CLI `mmctl`
+
+Certaines opérations de maintenance se réalisent via l'outil en cli `mmctl`.
+Celui-ci nécessite de se connecter avec un compte administrateur de l'instance Mattermost
 
 ~~~
-$ /home/mattermost/mattermost/bin/mattermost -c /home/mattermost/config/config.json team <NomÉquipe> delete
+$ mattermost/bin/mmctl auth login https://mattermost.example.com/
+Connection name: default
+Username: USERNAME
+Password: PASSWORD
+
+  credentials for "default": "USERNAME@https://mattermost.example.com" stored
+
 ~~~
+
+## Recharger la configuration
+
+Depuis quelques versions, Mattermost ne surveille plus le fichier de configuration pour y détecter les changements.
+Il faut donc utiliser l'outil en CLI `mmctl` pour demander à Mattermost.
+
+On le fait avec la commande `mattermost/bin/mmctl config reload` (après avoir configuré `mmctl`)
+