Skip to content

Latest commit

 

History

History
82 lines (70 loc) · 3.33 KB

install.md

File metadata and controls

82 lines (70 loc) · 3.33 KB
Raw

Installation/Désinstallation du module

Prérequis

Installation

Notes : l'installation proposée ici est en mode développement. Pour la production, supprimez les options --build false des commandes.

  1. Téléchargez le module sur votre serveur à partir d'une release : 
    wget https://github.com/PnX-SI/gn_module_suivi_habitat_territoire/releases/X.Y.Z.zip
  2. Créez un dossier qui contiendra vos modules : 
    mkdir /home/${USER}/modules
  3. Dézippez dans /home/${USER}/modules avec : 
    unzip X.Y.Z.zip
  4. Placez-vous dans le dossier de GeoNature et activez le venv : 
    source backend/venv/bin/activate
  5. Installez le module avec la commande : 
    geonature install-gn-module --build=false /home/${USER}/modules/gn_module_suivi_habitat_territoire
    • Adaptez le chemin /home/${USER}/modules/gn_module_suivi_habitat_territoire à votre installation.
  6. Complétez la configuration du module uniquement si nécessaire : 
    nano config/conf_gn_module.toml
    • Vous trouverez les paramètres possibles dans le fichier : config/conf_gn_module.toml.example.
    • Les valeurs par défaut dans : backend/gn_module_monitoring_habitat_territory/conf_schema_toml.py
  7. Mettre à jour le frontend : 
    geonature update-configuration
  8. Vous pouvez sortir du venv en lançant la commande : deactivate

Réglage des droits

Une fois le module installé, vous pouvez régler les droits du module pour votre groupe d'utilisateur :

  • Via le module Admin de GeoNature, accéder à l'interface d'administration des permissions (CRUVED).
  • Définissez les permissions suivant votre besoin. Voici un exemple :
    • C (Créer) à 3 (Toutes les données)
    • R (Lire) à 3 (Toutes les données)
    • U (Mise à jour) à 2 (Les données de mon organisme)
    • E (Export) à 3 (Toutes les données)
    • D (Supprimer) à 1 (Mes données)

Vous pouvez aussi utiliser la commande suivante pour attribuer tous les droits à un groupe spécifique (ici groupe admin) :

geonature permissions supergrant --group --nom "Grp_admin" --yes

Désinstallation

⚠️ ATTENTION : la désinstallation du module implique la suppression de toutes les données associées. Assurez vous d'avoir fait une sauvegarde de votre base de données au préalable.

Suivez la procédure suivante :

  1. Rétrograder la base de données pour y enlever les données spécifiques au module : 
    geonature db downgrade sht@base
  2. Désinstaller le package du virtual env : 
    pip uninstall gn-module-monitoring-habitat-territory
    • Possibilité de voir le nom du module avec : pip list
  3. Supprimer la ligne relative au module dans gn_commons.t_modules
  4. Supprimer le lien symbolique du module dans les dossiers :
    • geonature/external_modules
    • geonature/frontend/src/external_assets/
  5. Mettre à jour le frontend : 
    geonature update-configuration --build false && geonature generate-frontend-tsconfig && geonature generate-frontend-tsconfig-app && geonature generate-frontend-modules-route