📝 Update documentation (french)

- add upgrade to v4.2 instructions
- update town initialization instructions

1 files changed, 54 insertions, 10 deletions

diff --git a/docs/fr/source/administrateur-serveur.rst b/docs/fr/source/administrateur-serveur.rst
index fe53fac5b..6b140ab5c 100644
--- a/docs/fr/source/administrateur-serveur.rst
+++ b/docs/fr/source/administrateur-serveur.rst
@@ -5,7 +5,7 @@ Administration serveur
 ======================
 
 :Auteur: Étienne Loks
-:Date: 2024-06-05
+:Date: 2025-05-15
 :Copyright: CC-BY 3.0
 
 ----------------------------------
@@ -83,16 +83,15 @@ Initialisation des communes
 Une liste des communes française peut être téléchargée et chargée ::
 
     cd /tmp
-    wget "http://ishtar-archeo.net/fixtures/initial_towns-fr.tar.bz2"
-    tar xvjf initial_towns-fr.tar.bz2
+    wget "http://ishtar-archeo.net/fixtures/ishtar-towns-france.json.7z"
+    apt install p7zip  # 7zip
+    7zr x ishtar-towns-france.json.7z
+    apt remove p7zip  # not needed by Ishtar
 
-    ISHTAR_PATH=/srv/ishtar # répertoire par défaut de l'installation pour le paquet Debian
-    PROJECT_PATH=$ISHTAR_PATH/le_nom_de_mon_instance
-    cd $PROJECT_PATH
-    ./manage.py loaddata /tmp/towns_norel-fr.json
-    ./manage.py loaddata /tmp/towns-fr.json
-    rm /tmp/initial_towns-fr.tar.bz2
-    rm /tmp/towns-*
+    INSTANCE_NAME=le_nom_de_mon_instance
+    cd /srv/ishtar/$INSTANCE_NAME
+    ./manage.py load_towns /tmp/ishtar-towns-*.json
+    rm /tmp/ishtar-towns*
 
 
 Mises à jour
@@ -199,6 +198,51 @@ Une fois que vous vous serez assuré que tout est fonctionnel, vous pourrez effa
 
     pg_dropcluster 11 main
 
+
+Mise à jour version 4.2 (Debian Bullseye) depuis la version 4.0
+***************************************************************
+
+Comme lors de toute migration non triviale, il est préférable de faire une sauvegarde de la base de données juste avant de lancer la mise à jour.
+
+Pour faciliter cette mise à jour, si celui-ci a été installé, il est conseillé de purger en amont le paquet optionnel `ishtar-libreoffice` ::
+
+    apt purge ishtar-libreoffice libreoffice-*
+    apt autoremove
+
+
+Celui-ci pourra être réinstallé une fois la mise à jour finie.
+
+Ensuite, mettez le dépôt Ishtar sur le canal `beta` et lancez la mise à jour ::
+
+    echo "deb https://deb.iggdrasil.net/apt/debian/ bullseye beta" > /etc/apt/sources.list.d/deb_iggdrasil_net_apt_debian.list
+    apt update
+    apt upgrade
+
+La version 4.2 introduit une historisation des contenants. Celle-ci est initialisée via un script ::
+
+    INSTANCE_NAME=le_nom_de_mon_instance
+    cd /srv/ishtar/$INSTANCE_NAME
+    ./manage.py migrate_find_container_v4_2
+
+
+Maintenant 2 files d'attentes distinctes sont utilisées pour les tâches de fond.
+Il est nécessaire de mettre à jour la configuration du démon `supervisor` ::
+
+    editor /etc/supervisor/conf.d/celery_$INSTANCE_NAME.conf
+    (...) # change the "command" line with the following instance
+    (...) # by replacing INSTANCE_NAME with actual instance name
+    command=/usr/bin/celery -A INSTANCE_NAME worker --loglevel=INFO -c 2 -Q low_priority,celery
+
+    supervisorctl restart all
+
+
+La mise à jour est terminée.
+
+Suite à cette mise à jour, il peut être bien de vérifier les éventuels formulaires personnalisés, le message d'accueil (nouvelle intégration des images aléatoires et possibilité d'ajouter des statistiques), les patrons de documents (en particulier passage de « état de conservation » en multivalué) et les recherches sauvegardées (les critères « plus grand que », « plus petit que », « avant » et « après » ont été supprimé au profit de la nouvelle syntaxe).
+
+La journalisation RGPD peut maintenant être activée en version 4.2. Reportez-vous à la section concernée pour plus de détail.
+
+
 ..
   TODO:
   .. warning:: L'installateur présume que vous avez un nom de domaine dédié pour votre installation. Si cela n'est pas le cas, reportez-vous à la section de la documentation concernée.