summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/fr/source/administrateur-serveur.rst64
1 files changed, 54 insertions, 10 deletions
diff --git a/docs/fr/source/administrateur-serveur.rst b/docs/fr/source/administrateur-serveur.rst
index 28311fc1d..ab4662803 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.