Installer le module GeoNature Export

Présentation de l'installation et mise à jour du module par ordre anté-chronologique :

• Sur "web-srv" :
  • cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.3.0.zip -O gn-module-export_v1.3.0.zip
  • '' unzip gn-module-export_v1.3.0.zip -d ~/www/modules/geonature/ ''
  • '' cd ~/www/modules/geonature/ ''
  • '' mv gn_module_export-1.3.0 export_v1.3.0 ''
  • '' rm -f export_old; ln -s export_v1.2.8 export_old ''
  • '' rm -f export; ln -s export_v1.3.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/ ''
  • '' 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.8to1.3.0.sql '' * Sur "web-srv" : * '' cd ~/www/geonature/backend '' * '' source venv/bin/activate '' * <del> pip install --no-use-pep517 -e /home/geonat/www/modules/geonature/export </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 ''
  • geonature update-module-configuration --build false EXPORTS
  • geonature update-configuration --build false && geonature generate-frontend-tsconfig && geonature generate-frontend-tsconfig-app && geonature generate-frontend-modules-route
  • '' geonature db stamp c2d02e345a06 ''
  • '' cd ~/geonature/frontend/ ''
  • '' nvm use ''
  • '' npm run build ''

• Sur "web-srv" :
  • cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.2.8.zip -O gn-module-export_v1.2.8.zip
  • '' 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 '' * '' geonature update-module-configuration --build false EXPORTS
  • geonature update-configuration --build false && geonature generate-frontend-tsconfig && geonature generate-frontend-tsconfig-app && geonature generate-frontend-modules-route
  • '' cd ~/geonature/frontend/ ''
  • '' nvm use ''
  • '' npm run build ''

• Sur "web-srv" :
  • cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.2.4.zip -O gn-module-export_v1.2.4.zip
  • '' 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 ''

• Sur "web-srv" :
  • cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.2.1.zip -O gn-module-export_v1.2.1.zip
  • '' 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

    # Déclenchement tous les jours à minuit des exports programmé du module Export
    0 0 * * * /home/geonat/www/modules/geonature/export/gn_export_cron.sh /home/geonat/www/geonature

• Sur "web-srv" :
  • cd ~/dwl ; wget https://github.com/PnX-SI/gn_module_export/archive/1.2.0.zip -O gn-module-export_v1.2.0.zip
  • '' 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 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 :

        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;
        }   

    • 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 : '' https://expert.silene.eu/exports/users
  • '' cd ~/www/geonature/backend ''
  • '' source venv/bin/activate ''
  • '' geonature update_module_configuration EXPORTS ''

• Se connecter à geonat : ssh geonat@web-<region>-sinp
• Télécharger le module :
  • Se placer dans son le dossier de téléchargements : cd ~/dwl/
  • Télécharger le module : wget https://github.com/PnX-SI/gn_module_export/archive/1.0.0.zip -O gn-module-export_v1.0.0.zip
  • Dézipper le module : unzip gn-module-export_v1.0.0.zip '' * Déplacer et renommer le dossier du module : ''mv gn_module_export-1.0.0/ ../www/modules/geonature/export_v1.0.0
  • Se placer dans le dossier des modules de GeoNature cd ~/www/modules/geonature/
  • Copier le fichier de config dans la nouvelle version : cp export/config/conf_gn_module.toml export_v1.0.0/config/conf_gn_module.toml
  • Modifier le lien symbolique pointant vers la version active du module : '' rm -f export; ln -s export_v1.0.0 export ''
  • Actions nécessaire dans cette version :
    • Créer le dossier de log du module sur la nouvelle version de GeoNature : mkdir -p ~/www/geonature/var/log/gn_export/
• Activer le module dans GeoNature :
  • Aller dans le dossier backend de GeoNature : cd ~/www/geonature/backend
  • Activer l'environnement virtuel : source venv/bin/activate
  • Mettre à jour la configuration :
    • du module Exports seulement : geonature update_module_configuration exports
    • OU de GeoNature dans sa globalité : geonature update_configuration '' * Pour voir les erreurs liées au module : ''tail -f ~/www/geonature/var/log/gn_errors.log

• 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 : wget https://github.com/PnX-SI/gn_module_export/archive/develop.zip -O gn-module-export_develop_e3bec2b_2019-09-30.zip
  • 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