Documentation de la partie mise à jour

HowtoMatomo.md

@@ -59,3 +59,43 @@ Puis ajouter cette tâche dans la crontab de l'utilisateur :
 MAITO="foo@bar.com"
 30 * * * * /usr/bin/php /home/matomo/www/console core:archive --url=https://domaine-matomo-instance.com
 ~~~
+
+## Mise à jour
+
+On peux facilement mettre à jour Matomo depuis l'interface d'administration en un seul click.
+Il faut avant s'assurer que le répertoire racine de Matomo soit bien avec les droits en `755`
+
+Ensuite il faut se connecter en tant que "super user" ou "admin" à Matomo et aller dans la section « Administration », si un nouvelle mise à jour est disponible, elle est proposer, donc cliquer sur "Update Automatically".
+
+### Mise à jour sur les serveurs Matomo à fort trafic
+
+Pour les serveurs à fort trafic, la mise à jour de Matomo peut prendre entre plusieurs minutes à plusieurs heures, il est donc recommander de lancer la mise à jour en ligne de commande.
+
+Vous pouvez mettre à jour Matomo en cli de cette façon :
+
+~~~
+$ php /home/matomo/www/console core:update
+~~~ 
+
+Il est recommander également pour les serveurs a haut trafic, de désactivé le tracking des visiteurs et l'interface web de cette façon :
+
+~~~
+[Tracker]
+record_statistics = 0
+
+[General]
+maintenance_mode = 1
+~~~
+
+Lorsque Matomo est en `maintenance_mode=1`le endpoint de l'API `index.php` retourne une `503`.
+Si Matomo est derrière un load-balancer de type Haproxy, il faut rajouter la variable `multi_server_environment=1` pour que Matomo renvoie une `200`
+
+Cela garantira que les mises à jour du schéma de base de données sont terminées dès que possible et sans erreurs de lecture/écriture simultanées.
+
+Lorsque la mise à jour est terminé, **ne pas oublier de désactivé le mode maintenance et de réactivé le tracking.**
+
+### Une fois la mise à jour terminée
+
+Lorsque la mise à jour s'est terminé avec succès, il est recommander d'aller dans `Admin > Diagnostics > System check` et d'examiner les recommandations faite par Matomo.
+
+Par exemple, la vérification de l'intégrité des fichiers peut indiquer qu'il reste des fichiers de la version précédente qui peuvent désormais être supprimés.