Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente |
serveurs:installation:web-srv:geonature-taxref-upgrade [2025/07/02 15:33] – [Installation de la dernière version de TaxHub] jpmilcent | serveurs:installation:web-srv:geonature-taxref-upgrade [2025/07/03 13:32] (Version actuelle) – [Mise à jour de TaxRef] jpmilcent |
---|
| |
**Migration de TaxRef en version** : | **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. | * 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. | * v16 depuis v15 : pas d'évolution de la base impactant la migration entre la v1.9.4 et la v1.11.3. |
</code> | </code> |
* Lancer l'installation du ''venv'' : <code bash>./install_app.sh</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> | * 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'' : | * 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]] | * 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> | * 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/pre_detection.sql |
wget https://raw.githubusercontent.com/cbn-alpin/sinp-<region>-data/main/taxref/v<version>/sql/post_detection.sql | wget https://raw.githubusercontent.com/cbn-alpin/sinp-<region>-data/main/taxref/v<version>/sql/post_detection.sql |
</code> | </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... | * **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 : | * 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> | * SINP PACA : <code bash>psql -h localhost -U geonatadmin -d geonature2db -f ~/data/db-geonature/data/sql/04_disable_status_text.sql</code> |