📝 edit migration instructionWIP/doc

1 files changed, 25 insertions, 14 deletions

diff --git a/docs/fr/source/installation.rst b/docs/fr/source/installation.rst
index 39a8d8b02..5a3c080e8 100644
--- a/docs/fr/source/installation.rst
+++ b/docs/fr/source/installation.rst
@@ -104,7 +104,7 @@ Comme lors de toute migration non triviale, il est préférable de faire une sau
 
 Le changement de version nécessite préalablement la mise à jour vers la nouvelle version de Debian.
 
-Pour faciliter cette mise à jour, si ceux-ci ont été installés, il est conseillé de purger en amont les paquet `ishtar-libreoffice`, `libreoffice` associés et `ishtar-tasks`::
+Pour faciliter cette mise à jour, si ceux-ci ont été installés, il est conseillé de purger en amont les paquet `ishtar-libreoffice`, tous les paquets `libreoffice` et `ishtar-tasks` ::
 
     apt purge ishtar-libreoffice ishtar-tasks libreoffice-*
     apt autoremove
@@ -114,13 +114,7 @@ Ceux-ci pourront être réinstallé une fois la mise à jour vers bullseye finie
 
 Éteignez les services web et ensuite procédez à la mise à jour de Debian selon la documentation Debian officielle (ou votre protocole/vos habitudes). Ne changez pas tout de suite le fichier source list (ou les lignes) correspondant au dépôt Ishtar.
 
-Sur cette nouvelle version, la gestion du service rabbitmq et des files associées n'est plus assurée via systemd mais via supervisor pour gérer cette migration supprimez les fichiers de configuration systemd résiduels ::
-
-    rm -f /etc/systemd/system/rabbitmq-notify-email\@.service
-    rm -f /etc/systemd/system/rabbitmq-server.service
-    rm -f /etc/systemd/system/multi-user.target.wants/rabbitmq-server.service
-
-Ensuite vous pouvez opérer la migration de la base de données postgresql vers la version 13 ::
+Ensuite vous pouvez opérer la migration de la base de données PostgreSQL vers la version 13 ::
 
     systemctl stop postgresql
     pg_dropcluster 13 main
@@ -134,7 +128,7 @@ Mettez à jour vers bullseye le dépôt correspondant à Ishtar (a priori dans l
     apt upgrade
     apt dist-upgrade
 
-Le paquet `python3-weasyprint` empêche parfois la mise à jour. Dans ce cas, le supprimer explicitement et relancer le paramétrage ::
+Le paquet `python3-weasyprint` empêche parfois la mise à jour (à cause d'un conflit de version). Dans ce cas, le supprimer explicitement et relancer le paramétrage ::
 
     apt remove python3-weasyprint
     apt --fix-broken install
@@ -147,19 +141,33 @@ Vous pouvez ensuite, le cas échéant, ré-installer les paquets `ishtar-libreof
 
     apt install ishtar-tasks ishtar-libreoffice
 
-On peut ensuite passer à la migration des données. Attention cette migration peut être longue (plusieurs heures), assurez vous que le processus de migration ne soit pas intérrompu (lancez le a minimum via un outil comme `screen`). Pour chaque instance dans le répertoire `/srv/ishtar/` ::
+On peut ensuite passer à la migration des données. Attention cette migration peut être longue (plusieurs heures), assurez vous que le processus de migration ne soit pas intérrompu (lancez le a minimum via un outil comme `screen`). Pour chaque instance, dans le répertoire `/srv/ishtar/` lancez les commandes ::
 
     cd /srv/ishtar/{le_nom_de_mon_instance}
     # mise à jour des données par défaut
     ./manage.py loaddata /usr/share/python3-django-ishtar/fixtures/initial_data-auth-fr.json 
     ./manage.py loaddata /usr/lib/python3/dist-packages/archaeological_files/fixtures/initial_data-fr.json
     # migration des données pour la nouvelle gestion géographique
+    editor local_settings.py
+    (...)  # à la fin du fichier ajouter les lignes
+    ISHTAR_MIGRATE_V4 = False
+    USE_BACKGROUND_TASK = False
+
     ## nombre-de-processus dépend du processeur et du nombre de fil d'execution disponible
-    ## plus y en a plus rapide est la conversion mais laissez quand même un peu de marge pour nepas rendre
+    ## plus y en a plus rapide est la conversion mais laissez quand même un minimum de marge pour ne pas rendre
     ## la machine inutilisable
     ./manage.py migrate_to_geo_v4 --process {nombre-de-processus}
+    # une fois la migration finie
+    editor local_settings.py
+    (...)  # supprimer les deux lignes ajoutées
 
-La migration de systemd vers supervisor n'est pas gérée, seule les nouvelles instances ont un fichier supervisor créé à l'installation. La suppression des anciennes configuration puis la création des nouvelles se fait ainsi la gestion du service rabbitmq et des files associées n'est plus assurée via systemd mais via supervisor pour gérer cette migration supprimez les fichiers de configuration systemd résiduels et créez les fichiers de configuration pour chaque instance ::
+Si vous utilisez `ishtar-tasks`, sur cette nouvelle version, la gestion du service rabbitmq n'est plus assurée via `systemd` mais via `supervisor.` Pour gérer cette migration supprimez les fichiers de configuration `systemd` résiduels ::
+
+    rm -f /etc/systemd/system/rabbitmq-notify-email\@.service
+    rm -f /etc/systemd/system/rabbitmq-server.service
+    rm -f /etc/systemd/system/multi-user.target.wants/rabbitmq-server.service
+
+La migration de `systemd` vers `supervisor` n'est pas gérée, seule les nouvelles instances ont un fichier supervisor créé à l'installation. La suppression des anciennes configuration puis la création des nouvelles se fait ainsi la gestion du service rabbitmq et des files associées n'est plus assurée via systemd mais via supervisor pour gérer cette migration supprimez les fichiers de configuration systemd résiduels et créez les fichiers de configuration pour chaque instance ::
 
     rm -f /etc/monit/conf-enabled/celery-*
     rm -f /etc/systemd/system/celery-*
@@ -181,9 +189,12 @@ La migration de systemd vers supervisor n'est pas gérée, seule les nouvelles i
     supervisorctl reread  # prise en compte des nouveaux fichiers de configuration
     supervisorctl update  # mise à jour
 
-La migration est a priori terminée. En ce qui concerne le paramétrage, il est impératif de d'éditer les permissions pour accéder aux données géographiques. Ouvrez votre instance sur un navigateur web en admin et rendez-vous ) la page : http(s)://{my-ihstar}/admin/ishtar_common/profiletypesummary/  pour ajouter les permissions nécessaires.
+La migration est terminée.
+Redémarrez la machine et assurez vous que tous les services fonctionnent convenablement en particulier via les commandes `systemctl --failed` et `supervisorctl status`.
+
+En ce qui concerne le paramétrage, il est impératif de d'éditer les permissions pour accéder aux données géographiques. Ouvrez votre instance sur un navigateur web en admin et rendez-vous à la page : `http(s)://{my-ihstar}/admin/ishtar_common/profiletypesummary/`  pour ajouter les permissions nécessaires.
 
-Une fois que vous vous êtes assuré que tout est fonctionnel vous pourrez effacer l'ancien cluster postgresql correspondant à la version 11 ::
+Une fois que vous vous êtes assuré que tout est fonctionnel vous pourrez effacer l'ancien cluster PostgreSQL correspondant à la version 11 ::
 
     pg_dropcluster 11 main