Différences

Ci-dessous, les différences entre deux révisions de la page.

--- serveurs:installation:web-srv:geonature-taxref-upgrade [2025/06/24 09:00] – [Détail utilisation du script "flask taxref migrate-to-vXX"] jpmilcent
+++ serveurs:installation:web-srv:geonature-taxref-upgrade [2025/07/03 13:32] (Version actuelle) – [Mise à jour de TaxRef] jpmilcent
@@ Ligne 6: / Ligne 6: @@
 **Migration de TaxRef en version** :
+  * v18 depuis v17 : création d'une commande pour TaxHub < v2.0 ; 3 nouvelles colonnes TaxRef ignorées.
   * v17 depuis v16 : évolution de la base impactant la migration entre la v1.9.4 et la v1.14.0 => nécessite de créer la table ''taxonomie.t_meta_taxref'' dans script SQL de pré-détection.
   * v16 depuis v15 : pas d'évolution de la base impactant la migration entre la v1.9.4 et la v1.11.3.
@@ Ligne 13: / Ligne 14: @@
   * Se connecter sur l'hôte ''web-srv''
   * Se placer dans le dossier ''~/www/'' : <code bash>cd ~/www/</code>
-  * Cloner le dépôt Taxhub : <code bash>git clone https://github.com/PnX-SI/TaxHub.git taxhub.taxref_v17</code>
+  * Si nécessaire, cloner le dépôt Taxhub : <code bash>git clone https://github.com/PnX-SI/TaxHub.git taxhub.taxref</code>
     * Mettre à jour les sous-module si utilisation en local en mode "dev" : <code bash>cd ~/www/taxhub.taxref_v17 ; git submodule init; git submodule update</code>
-  * Se placer dans le dossier cloné : <code bash>cd ~/www/taxhub.taxref_v17</code>
+  * Se placer dans le dossier cloné : <code bash>cd ~/www/taxhub.taxref</code>
-  * Copier les fichiers de configuration : <code bash>
+  * Basculer sur la branche de migation : <code bash>git switch feat/sinp-taxref-v18</code>
+  * Si nécessaire, copier les fichiers de configuration : <code bash>
 cp settings.ini.sample settings.ini
 cp apptax/config.py.sample apptax/config.py
@@ Ligne 22: / Ligne 24: @@
     * Éditer le fichier ''settings.ini'' : <code bash>vi settings.ini</code>
       * Modifier les 3 paramètres suivant :<code properties>
+# En préprod: db_host=localhost
 db_host=10.0.1.20
@@ Ligne 35: / Ligne 38: @@
     * Éditer le fichier ''config.py'' : <code bash>vi apptax/config.py</code>
       * Modifier les 2 paramètres suivant :<code properties>
+# En préprod: SQLALCHEMY_DATABASE_URI = "postgresql://geonatadmin:<geonatadmin-password>@localhost:5432/geonature2db"
 SQLALCHEMY_DATABASE_URI = "postgresql://geonatadmin:<geonatadmin-password>@10.0.1.20:5432/geonature2db"
 SECRET_KEY = '<generate-super-secret-key-with-uuid>'
 </code>
   * Lancer l'installation du ''venv'' : <code bash>./install_app.sh</code>
+    * Stopper le script quand il demande le mot de passe de geonat pour installer les scripts systéme : ''CTRL+C''
   * Activer le ''venv'' : <code bash>source venv/bin/activate</code>
-  * Lancer l'import de TaxRef : <code bash>flask taxref migrate-to-v17 import-taxref-v17</code>
+  * Lancer l'import de TaxRef : <code bash>flask taxref migrate-to-v18 import-taxref-v18</code>
-    * Pas certain que cela soit utile si on utilise le scripts SQL ''pre_detection.sql'' mais on peut lancer la commande suivante pour tester d'éventuel changement réalisé dans la base : <code bash>flask taxref migrate-to-v17 test-changes-detection</code>
+    * Pas certain que cela soit utile si on utilise le scripts SQL ''pre_detection.sql'' mais on peut lancer la commande suivante pour tester d'éventuel changement réalisé dans la base : <code bash>flask taxref migrate-to-v18 test-changes-detection</code>
   * Lors de la réalisation des tests en local, préparer une nouveau dossier de version de TaxRef sur le dépôt ''sinp-<region>-data'' :
     * Voir : [[https://github.com/cbn-alpin/sinp-paca-data/tree/main/taxref|PACA]] ou [[https://github.com/cbn-alpin/sinp-aura-data/tree/main/taxref|AURA]]
-    * Copier les fichiers csv générés par le script précédent dans le dossier ''taxref/v17/csv/'' du dépôt.
+    * Copier les fichiers csv générés par le script précédent dans le dossier ''taxref/v18/csv/'' du dépôt.
-    * Créer les scripts SQL qui permettront la migration dans le dossier ''taxref/v17/sql/''. Se baser sur la version précédente de TaxRef pour avoir des exemples de script SQL qu'il faudra adapté aux informations fournies dans les fichiers CSV.
+    * Créer les scripts SQL qui permettront la migration dans le dossier ''taxref/v18/sql/''. Se baser sur la version précédente de TaxRef pour avoir des exemples de script SQL qu'il faudra adapté aux informations fournies dans les fichiers CSV.
   * Lors de la mise en production, récupérer les fichiers SQL permettant la migration :<code bash>
 wget https://raw.githubusercontent.com/cbn-alpin/sinp-<region>-data/main/taxref/v<version>/sql/pre_detection.sql
 wget https://raw.githubusercontent.com/cbn-alpin/sinp-<region>-data/main/taxref/v<version>/sql/post_detection.sql
 </code>
-  * Lancer la migration de TaxRef : <code bash>flask taxref migrate-to-v17 apply-changes --script_predetection ./pre_detection.sql --script_postdetection ./post_detection.sql</code>
+  * Lancer la migration de TaxRef : <code bash>flask taxref migrate-to-v18 apply-changes --script_predetection ./pre_detection.sql --script_postdetection ./post_detection.sql</code>
     * **NOTE** : pour une raison inconnue, dans le cas du SINP AURA, il m'a fallu lancer à 2 reprises cette  commande. Après l'import, 14 conflits sont indiqués. Après le premier lancement, il reste 8 conflits. Après le second, cela tombe 0 et la migration s'effectue correctement...
-  * Vérifier que la nouvelle version de TaxRef a bien été migré correctement ! Vérifier qu'un cd_nom disparu dans la v17 n'est plus présent dans votre table ''taxonomie.taxref'' et qu'un nouveau cd_nom ajouté à partir de la v17 s'y trouve bien.
+  * Réactiver certaines contraintes :
-  * <color /#fff200>Si nécessaire (avant la v17)</color>, lier à nouveau les statuts de protection aux zones géographiques : <code bash>flask taxref link-bdc-statut-to-areas</code>
+    * Se connecter à db-srv : <code bash> ssh geonat@db-<region>-sinp</code>
+    * Se placer dans ''~/data/taxref/v18/sql/'' avec : <code bash> cd ~/data/taxref/v18/sql/</code>
+    * Lancer : <code bash>psql -h localhost -U geonatadmin -d geonature2db -f ./reactivation_contraintes_apres_taxref.sql</code>
+  * Vérifier que la nouvelle version de TaxRef a bien été migré correctement ! Vérifier qu'un cd_nom disparu dans la v18 n'est plus présent dans votre table ''taxonomie.taxref'' et qu'un nouveau cd_nom ajouté à partir de la v18 s'y trouve bien.
+  * <color /#fff200>Si nécessaire (avant la v18)</color>, lier à nouveau les statuts de protection aux zones géographiques : <code bash>flask taxref link-bdc-statut-to-areas</code>
     * Désactiver à nouveau les textes de la BDC Statut qui ne vous sont pas nécessaire à votre installation :
       * SINP PACA : <code bash>psql -h localhost -U geonatadmin -d geonature2db -f ~/data/db-geonature/data/sql/04_disable_status_text.sql</code>