Installer et configurer GeoNature App

Ceci est une ancienne révision du document !

Récupérer l'URL de la dernière version de GeoNature disponible : curl -s https://api.github.com/repos/PnX-SI/GeoNature/releases/latest | grep tarball_url | cut -d\" -f4
Se placer dans le dossier dwl de l'utilisateur geonat : cd ~/dwl/
Exporter la dernière version de GeoNature dans une variable d'env locale à la session : export GNV=$(curl -s https://api.github.com/repos/PnX-SI/GeoNature/releases/latest | grep tag_name | cut -d\" -f4)
Télécharger l'archive : wget https://github.com/PnX-SI/GeoNature/archive/${GNV}.zip -O geonature_v${GNV}.zip
Décompresser l'archive dans le dossier www de l'utilisateur geonat : unzip geonature_v${GNV}.zip -d ~/www/
Se rendre dans le dossier www : cd ~/www/
Renommer le dossier au format GeoNature (⇒ uniformité): mv GeoNature-${GNV} geonature_v${GNV}

Se placer dans le dossier install/ de GeoNature : cd /home/geonat/www/geonature/install/
Créer un fichier de log vide : touch ../var/log/install_app.log
Lancer l'installation : ./install_app.sh 2>&1 | tee ../var/log/install_app.log
Préalable à la configuration de l'application :
- Générer un uuid avec la commande : uuid
- Définir un nouveau mot de passe pour l'utilisateur de GeoNature admin (à mettre à jour avec UsersHub une fois installé)

Configurer l'application :

Créer le fichier si nécessaire (normalement il est créé par le script d'install) : cp config/geonature_config.toml.sample config/geonature_config.toml
Éditer le fichier de config de l'appli : vi config/geonature_config.toml

Contenu :

API_TAXHUB = 'https://taxhub.<domaine-sinp>/api'
SECRET_KEY = '<uuid>' # Mettre un uuid généré avec la commande 'uuid' dans une Console
 
# Configuration de l'accès distant à UsersHub (API)
[USERSHUB]
    URL_USERSHUB = 'https://usershub.<domaine-sinp>' # sans slash final
    # Administrateur de mon application
    ADMIN_APPLICATION_LOGIN = "admin"
    ADMIN_APPLICATION_PASSWORD = "<mot-de-passe-admin>"
 
# Configuration de l'envoie d'emails
[MAIL_CONFIG]
    MAIL_SERVER = 'smtp-relay.gmail.com'# À remplacer par le serveur SMTP d'OVH ssl0.ovh.net
    MAIL_PORT = 587
    MAIL_USE_TLS = true
    MAIL_USE_SSL = false
    MAIL_USERNAME = 'mailer@cbn-alpin.fr'# À remplacer par un compte sur silene.eu
    MAIL_PASSWORD = '<mot-de-passe>'
    MAIL_DEFAULT_SENDER = 'contact@<domaine-sinp>'
    MAIL_ASCII_ATTACHMENTS = false
 
# Gestion des demandes d'inscription
[ACCOUNT_MANAGEMENT]
    ENABLE_SIGN_UP = true
    AUTO_ACCOUNT_CREATION = false
    VALIDATOR_EMAIL = 'contact@<domaine-sinp>'
    AUTO_DATASET_CREATION = false
    ENABLE_USER_MANAGEMENT = true
 
# Gestion du formulaire de demande d'inscription
[[ACCOUNT_MANAGEMENT.ACCOUNT_FORM]]
    type_widget = "checkbox"
    attribut_label = "<a target='_blank' href='http://docs.geonature.fr'>J'ai lu et j'accepte la charte</a>"
    attribut_name = "validate_charte"
    values = [true]
    required = true
 
[[ACCOUNT_MANAGEMENT.ACCOUNT_FORM]]
    type_widget = "select"
    attribut_label = "Exemple select"
    attribut_name = "select_test"
    values = ["valeur1", "valeur2"]
    required = false

Configuration de l'envoie d'email avec un compte Gmail. Il est nécessaire de:
- configurer un relai SMTP dans l'administration de Gsuite
- d'activer l'"accès aux applications moins sécurisées" sur son compte Google
Tester l'envoie d'email en essayant de s'inscrire depuis la page d'accueil de GeoNature
- En cas de problème, les logs sont accessibles dans : tail -f ~/www/geonature/var/log/gn_errors.log

Emplacement des fichiers de config :
- Le fichier config/settings.ini sert seulement aux scripts d'installation.
- Une fois GeoNature installé, il faut modifié la config dans config/geonature_config.toml
Prise en compte des mises à jour de la config :
- Se rendre dans le dossier backend/ : cd ~/www/geonature/backend
- Activer l'env virtuel : source venv/bin/activate
- Lancer la commande de mise à jour de la conf de GeoNature : geonature update_configuration
- Désactiver l'env virtuel : deactivate

Se connecter à la base de donnée avec DBeaver et accéder à la table gn_commons.t_modules
- Modifier le nom d'un menu de module en modifiant le champ module_label
- Modifier l'icône en sélectionnant une nouvelle parmi les icônes Font Awesome puis indiquer son nom dans le champ module_picto

Installer et configurer GeoNature App

Téléchargement et organisation des dossiers de GeoNature

Installer GeoNature App

Modification de la config de GeoNature

Modifier les noms et icônes des menus de GeoNature

CBNA SINP