Différences

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

--- serveurs:installation:web-srv:geonature-module-export [2020/02/26 10:26] – [Mise à jour vers la version v1.0.0 (compatible GeoNature v2.3.2)] jpmilcent
+++ serveurs:installation:web-srv:geonature-module-export [2023/06/11 21:19] (Version actuelle) – [Mise à jour vers la version v1.3.0 depuis la v1.2.8] jpmilcent
@@ Ligne 1: / Ligne 1: @@
 ====== Installer le module GeoNature Export ======
-===== Installer la version v0.1.1-dev =====
+Présentation de l'installation et mise à jour du module par ordre anté-chronologique :
-  * Se connecter à //geonat// : ''ssh geonat@web-<region>-sinp''
-  * Installer le module :
+===== Mise à jour vers la version v1.3.0 depuis la v1.2.8 ===
-    * Se placer dans son le dossier de téléchargements : ''cd ~/dwl/''
+  * Sur "//web-srv//" :
-    * Télécharger le module : ''<nowiki> wget https://github.com/PnX-SI/gn_module_export/archive/develop.zip -O gn-module-export_develop_e3bec2b_2019-09-30.zip </nowiki>''
+    * ''<nowiki> cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.3.0.zip -O gn-module-export_v1.3.0.zip </nowiki>''
-    * Créer l’arborescence de dossiers qui stockeront le module : ''mkdir -p ~/www/modules/geonature''
+    * '' unzip gn-module-export_v1.3.0.zip -d ~/www/modules/geonature/ ''
-    * Dézipper le module : ''unzip gn-module-export_develop_e3bec2b_2019-09-30.zip ''
+    * '' cd ~/www/modules/geonature/ ''
-    * Déplacer et renommer le dossier du module : ''mv gn_module_export-develop/ ../www/modules/geonature/export_v2019-09-30_develop_e3bec2b''
+    * '' mv gn_module_export-1.3.0 export_v1.3.0 ''
-    * Se placer dans le dossier des modules de GeoNature ''cd ~/www/modules/geonature/''
+    * '' rm -f export_old; ln -s export_v1.2.8 export_old ''
-    * Créer un lien symbolique : ''ln -s export_v2019-09-30_develop_e3bec2b export''
+    * '' rm -f export; ln -s export_v1.3.0 export ''
-  * Vérifier que la gestion des emails est configuré dans //GeoNature// : présence de la section ''[MAIL_CONFIG]'' dans le fichier ''config/geonature_config.toml''
+    * '' cp ~/www/modules/geonature/export_old/config/conf_gn_module.toml ~/www/modules/geonature/export/config/conf_gn_module.toml ''
-  * Activer le module dans //GeoNature// :
+    * '' cp -r ~/www/modules/geonature/export_old/backend/templates/swagger ~/www/modules/geonature/export/backend/templates/ ''
-    * Aller dans le dossier //backend// de GeoNature : ''cd ~/www/geonature/backend''
+    * '' rsync -av -e "ssh -p <port-ssh-db-srv>" /home/geonat/www/modules/geonature/ geonat@db-paca-sinp:/home/geonat/www/modules/geonature/ ''
-    * Activer l'environnement virtuel : ''source venv/bin/activate''
+  * Sur "//db-srv//" :
-    * Intégrer le module à //GeoNature// : ''geonature install_gn_module /home/geonat/www/modules/geonature/export/ export ''
+    * Mettre à jour la base de données : ''psql -h localhost -U geonatadmin -d geonature2db -f ~/www/modules/geonature/export/data/migrations/1.2.8to1.3.0.sql ''
-      * Soit '' geonature install_gn_module <chemin-abosule-vers-dossier-du-module> <nom-du-module-dans-url>''
+  * Sur "//web-srv//" :
-    * Pour voir les erreurs liées au module : ''tail -f ~/www/geonature/var/log/gn_errors.log''
+    * '' cd ~/www/geonature/backend ''
+    * '' source venv/bin/activate ''
+    * <del>''<nowiki> pip install --no-use-pep517 -e /home/geonat/www/modules/geonature/export </nowiki>''</del>
+      * Utiliser plutôt : ''%% pip install -e /home/geonat/www/modules/geonature/export %%''
+    * '' cd ~/geonature/external_modules/ ''
+    * '' ln -s /home/geonat/www/modules/geonature/export exports ''
+    * '' cd ~/geonature/frontend/src/external_assets/ ''
+    * '' ln -s /home/geonat/www/modules/geonature/export/frontend/assets exports ''
+    * ''<nowiki> geonature update-module-configuration --build false EXPORTS </nowiki>''
+    * ''<nowiki> geonature update-configuration --build false && geonature generate-frontend-tsconfig && geonature generate-frontend-tsconfig-app && geonature generate-frontend-modules-route </nowiki>''
+    * '' geonature db stamp c2d02e345a06 ''
+    * '' cd ~/geonature/frontend/ ''
+    * '' nvm use ''
+    * '' npm run build ''
+===== Mise à jour vers la version v1.2.8 depuis la v1.2.4 ===
+  * Sur "//web-srv//" :
+    * ''<nowiki> cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.2.8.zip -O gn-module-export_v1.2.8.zip </nowiki>''
+    * '' unzip gn-module-export_v1.2.8.zip -d ~/www/modules/geonature/ ''
+    * '' cd ~/www/modules/geonature/ ''
+    * '' mv gn_module_export-1.2.8 export_v1.2.8 ''
+    * '' rm -f export_old; ln -s export_v1.2.4 export_old ''
+    * '' rm -f export; ln -s export_v1.2.8 export ''
+    * '' cp ~/www/modules/geonature/export_old/config/conf_gn_module.toml ~/www/modules/geonature/export/config/conf_gn_module.toml ''
+    * '' cp -r ~/www/modules/geonature/export_old/backend/templates/swagger ~/www/modules/geonature/export/backend/templates/ ''
+    * '' rsync -av -e "ssh -p <port-ssh-db-srv>" /home/geonat/www/modules/geonature/ geonat@db-paca-sinp:/home/geonat/www/modules/geonature/ ''
+  * Sur "//db-srv//" :
+    * Mettre à jour la base de données : ''psql -h localhost -U geonatadmin -d geonature2db -f ~/www/modules/geonature/export/data/migrations/1.2.4to1.2.5.sql ''
+  * Sur "//web-srv//" :
+    * '' cd ~/www/geonature/backend ''
+    * '' source venv/bin/activate ''
+    * '' cd ~/geonature/external_modules/ ''
+    * '' ln -s /home/geonat/www/modules/geonature/export exports ''
+    * '' cd ~/geonature/frontend/src/external_assets/ ''
+    * '' ln -s /home/geonat/www/modules/geonature/export/frontend/assets exports ''
+    * ''<nowiki> geonature update-module-configuration --build false EXPORTS </nowiki>''
+    * ''<nowiki> geonature update-configuration --build false && geonature generate-frontend-tsconfig && geonature generate-frontend-tsconfig-app && geonature generate-frontend-modules-route </nowiki>''
+    * '' cd ~/geonature/frontend/ ''
+    * '' nvm use ''
+    * '' npm run build ''
+===== Mise à jour vers la version v1.2.4 depuis la v1.2.1 ===
+  * Sur "//web-srv//" :
+    * ''<nowiki> cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.2.4.zip -O gn-module-export_v1.2.4.zip </nowiki>''
+    * '' unzip gn-module-export_v1.2.4.zip -d ~/www/modules/geonature/ ''
+    * '' cd ~/www/modules/geonature/ ''
+    * '' mv gn_module_export-1.2.4 export_v1.2.4 ''
+    * '' rm -f export_old; ln -s export_v1.2.1 export_old ''
+    * '' rm -f export; ln -s export_v1.2.4 export ''
+    * '' cp ~/www/modules/geonature/export_old/config/conf_gn_module.toml ~/www/modules/geonature/export/config/conf_gn_module.toml ''
+    * '' cp -r ~/www/modules/geonature/export_old/backend/templates/swagger ~/www/modules/geonature/export/backend/templates/ ''
+    * '' rsync -av -e "ssh -p <port-ssh-db-srv>" /home/geonat/www/modules/geonature/ geonat@db-paca-sinp:/home/geonat/www/modules/geonature/ ''
+    * '' cd ~/www/geonature/backend ''
+    * '' source venv/bin/activate ''
+    * La base de données ayant été réinitialiser, nous devons réinstaller le module : ''geonature install_gn_module /home/geonat/www/modules/geonature/export/ export''
+      * Pour une simple mise à jour du module la commande est : '' geonature update_module_configuration EXPORTS ''
+===== Mise à jour vers la version v1.2.1 depuis la v1.2.0 ===
+  * Sur "//web-srv//" :
+    * ''<nowiki> cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.2.1.zip -O gn-module-export_v1.2.1.zip </nowiki>''
+    * '' unzip gn-module-export_v1.2.1.zip -d ~/www/modules/geonature/ ''
+    * '' cd ~/www/modules/geonature/ ''
+    * '' mv gn_module_export-1.2.1 export_v1.2.1 ''
+    * '' rm -f export_old; ln -s export_v1.2.0 export_old ''
+    * '' rm -f export; ln -s export_v1.2.1 export ''
+    * '' cp ~/www/modules/geonature/export_old/config/conf_gn_module.toml ~/www/modules/geonature/export/config/conf_gn_module.toml ''
+    * '' cp -r ~/www/modules/geonature/export_old/backend/templates/swagger/ ~/www/modules/geonature/export/backend/templates/swagger/ ''
+    * '' rsync -av -e "ssh -p <port-ssh-db-srv>" /home/geonat/www/modules/geonature/ geonat@db-paca-sinp:/home/geonat/www/modules/geonature/ ''
+    * '' cd ~/www/geonature/backend ''
+    * '' source venv/bin/activate ''
+    * '' geonature update_module_configuration EXPORTS ''
+    * Ajouter le cron au crontab de l'utilisateur //geonat// : ''crontab -e'' <code>
+# Déclenchement tous les jours à minuit des exports programmé du module Export
+0 * * * /home/geonat/www/modules/geonature/export/gn_export_cron.sh /home/geonat/www/geonature
+</code>
+===== Mise à jour vers la version v1.2.0 depuis la v1.0.0 ===
+  * Sur "//web-srv//" :
+    * ''<nowiki> cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.2.0.zip -O gn-module-export_v1.2.0.zip </nowiki>''
+    * '' unzip gn-module-export_v1.2.0.zip -d ~/www/modules/geonature/ ''
+    * '' cd ~/www/modules/geonature/ ''
+    * '' mv gn_module_export-1.2.0 export_v1.2.0 ''
+    * '' ln -s export_v1.0.0 export_old ''
+    * '' rm -f export; ln -s export_v1.2.0 export ''
+    * '' cp ~/www/modules/geonature/export_old/config/conf_gn_module.toml ~/www/modules/geonature/export/config/conf_gn_module.toml ''
+    * '' cp -r ~/www/modules/geonature/export_old/backend/templates/swagger/ ~/www/modules/geonature/export/backend/templates/swagger/ ''
+    * '' rsync -av -e "ssh -p <port-ssh-db-srv>" /home/geonat/www/modules/geonature/ geonat@db-paca-sinp:/home/geonat/www/modules/geonature/ ''
+  * Sur "//db-srv//" :
+    * Copier la source de la vue ''gn_exports.v_synthese_sinp'' car déjà mise à jour avec la mise à jour vers 2.5.3
+    * '' psql -h localhost -U geonatadmin -d geonature2db -f ~/www/modules/geonature/export/data/migrations/1.0.3to1.0.4.sql ''
+      * La mise à jour de la vue ''gn_exports.v_synthese_sinp'' échoue car la colonne id_nomenclature_obs_meth n'existe pas. Utiliser le code précédemment sauvegardé pour la créer à nouveau.
+    * '' psql -h localhost -U geonatadmin -d geonature2db -f ~/www/modules/geonature/export/data/migrations/1.1.0to1.2.0.sql ''
+  * Sur "//web-srv//" :
+    * TODO : modifier la config Nginx pour gérer les alias comme indiquée dans [[https://github.com/PnX-SI/gn_module_export/blob/master/README.md#url-des-fichiers|la doc du module Export]].
+      * Éditer le fichier ///etc/nginx/sites-available/geonature.conf// :
+        * Ajouter le code suivant dans la première entrée //server// : <code nginx>
+location /exports/schedules {
+    alias /home/geonat/www/geonature/backend/static/exports/schedules;
+}
+location /exports/users {
+    alias /home/geonat/www/geonature/backend/static/exports/usr_generated;
+}
+</code>
+      * Recharger Nginx : ''service nginx reload''
+      * Copier/coller le contenu du fichier ''conf_gn_module.toml.example'' dans ''conf_gn_module.toml'' et y remplacer :
+        * ''{GN_HOME}'' par '' /home/geonat/www/geonature/ ''.
+        * la valeur du paramètre '' export_web_url '' par : ''<nowiki> https://expert.silene.eu/exports/users </nowiki>''
+    * '' cd ~/www/geonature/backend ''
+    * '' source venv/bin/activate ''
+    * '' geonature update_module_configuration EXPORTS ''
-===== Mise à jour vers la version v1.0.0 (compatible GeoNature v2.3.2) =====
+===== Mise à jour vers la version v1.0.0 depuis la v0.1.1-dev =====
   * Se connecter à //geonat// : ''ssh geonat@web-<region>-sinp''
   * Télécharger le module :
@@ Ligne 39: / Ligne 150: @@
     * Pour voir les erreurs liées au module : ''tail -f ~/www/geonature/var/log/gn_errors.log''
+===== Installer la version v0.1.1-dev =====
+  * Se connecter à //geonat// : ''ssh geonat@web-<region>-sinp''
+  * Installer le module :
+    * Se placer dans son le dossier de téléchargements : ''cd ~/dwl/''
+    * Télécharger le module : ''<nowiki> wget https://github.com/PnX-SI/gn_module_export/archive/develop.zip -O gn-module-export_develop_e3bec2b_2019-09-30.zip </nowiki>''
+    * Créer l’arborescence de dossiers qui stockeront le module : ''mkdir -p ~/www/modules/geonature''
+    * Dézipper le module : ''unzip gn-module-export_develop_e3bec2b_2019-09-30.zip ''
+    * Déplacer et renommer le dossier du module : ''mv gn_module_export-develop/ ../www/modules/geonature/export_v2019-09-30_develop_e3bec2b''
+    * Se placer dans le dossier des modules de GeoNature ''cd ~/www/modules/geonature/''
+    * Créer un lien symbolique : ''ln -s export_v2019-09-30_develop_e3bec2b export''
+  * Vérifier que la gestion des emails est configuré dans //GeoNature// : présence de la section ''[MAIL_CONFIG]'' dans le fichier ''config/geonature_config.toml''
+  * Activer le module dans //GeoNature// :
+    * Aller dans le dossier //backend// de GeoNature : ''cd ~/www/geonature/backend''
+    * Activer l'environnement virtuel : ''source venv/bin/activate''
+    * Intégrer le module à //GeoNature// : ''geonature install_gn_module /home/geonat/www/modules/geonature/export/ export ''
+      * Soit '' geonature install_gn_module <chemin-abosule-vers-dossier-du-module> <nom-du-module-dans-url>''
+    * Pour voir les erreurs liées au module : ''tail -f ~/www/geonature/var/log/gn_errors.log''