Installer et configurer GeoNature App

Voir la documentation commune aux 2 instances.

• Se placer dans le dossier install/ de GeoNature : cd /home/geonat/www/geonature/install/
• Créer un fichier de log vide : mkdir -p ../var/log/ ; 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 :

    URL_APPLICATION = 'https://expert.<domaine-sinp>' 
    API_ENDPOINT = 'https://expert.<domaine-sinp>/api'
    API_TAXHUB = 'https://taxhub.<domaine-sinp>/api'
    SECRET_KEY = '<uuid>' # Mettre un uuid généré avec la commande 'uuid' dans une Console
    MAIL_ON_ERROR = true
     
    # 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
     
    # 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>"
     
    # 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
     
    [FRONTEND]
        DISPLAY_MAP_LAST_OBS = true
     
    [MAPCONFIG]
        BASEMAP = [
            {"name" = "OpenStreetMap", "layer" = "//{s}.tile.openstreetmap.fr/hot/{z}/{x}/{y}.png", "attribution" = "&copy OpenStreetMap"},
            {"name"= "OpenTopoMap", "layer" = "//a.tile.opentopomap.org/{z}/{x}/{y}.png", "attribution" = "© OpenTopoMap"},
            {"name" = "GoogleSatellite", "layer" = "//{s}.google.com/vt/lyrs=s&x={x}&y={y}&z={z}", "subdomains" = ["mt0", "mt1", "mt2", "mt3"], "attribution" = "© GoogleMap"}
        ]
        CENTER = [43.96387, 6.06216]
        ZOOM_LEVEL = 8
        ZOOM_LEVEL_RELEVE = 15
        ZOOM_ON_CLICK = 16
     
    [SYNTHESE]
        NB_MAX_OBS_MAP = 100000
        NB_MAX_OBS_EXPORT = 100000
        NB_LAST_OBS = 10000
        LIST_COLUMNS_FRONTEND = [
            { prop = "lb_nom", name = "Taxon" },
            { prop = "date_min", name = "Date début" },
            { prop = "observers", name = "Observateurs" },
            { prop = "dataset_name", name = "Jeu de données" }

• 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
• Vérifier que le fichier de conf de Supervisor pour GeoNature utilise le lien symbolique : vi /etc/supervisor/conf.d/geonature-service.conf
• Modifier le fichier de conf de Supervisor pour GeoNature : sudo vi /etc/supervisor/conf.d/geonature-service.conf
  • Le paramètre command doit utiliser le lien symbolique : command = /home/geonat/www/geonature/backend/gunicorn_start.sh
  • Le paramètre stdout_logfile doit utiliser le lien symbolique : stdout_logfile = /home/geonat/www/geonature/var/log/gn_errors.log
  • Vérifier que le paramètre user est présent et a pour valeur geonat

• 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