Installation de GeoNature uniquement ************************************ Cette procédure détaille l’installation de GeoNature (incluant TaxHub) sans UsersHub. Si vous souhaitez installer GeoNature avec UsersHub, reportez-vous à la section :ref:`installation-all`. Installation des dépendances ---------------------------- Installer les paquets suivants : .. code:: shell sudo apt install unzip git postgresql-postgis postgis python3-pip python3-venv python3-dev libpq-dev libgdal-dev libffi-dev libpangocairo-1.0-0 apache2 redis Récupération de l'application ----------------------------- * Se placer dans le répertoire de l'utilisateur (``/home/geonatureadmin/`` dans notre cas) * Récupérer l'application (``X.Y.Z`` à remplacer par le numéro de la `dernière version stable de GeoNature `_). .. code:: shell wget https://github.com/PnX-SI/GeoNature/archive/X.Y.Z.zip * Dézipper l'archive de l'application .. code:: shell unzip X.Y.Z.zip rm X.Y.Z.zip * Renommer le répertoire de l'application puis placez-vous dedans : .. code:: shell mv GeoNature-X.Y.Z /home/`whoami`/geonature/ cd geonature * Copier puis mettre à jour le fichier de configuration (``config/settings.ini``) comportant les informations relatives à votre environnement serveur : .. code:: shell cp config/settings.ini.sample config/settings.ini nano config/settings.ini Installation de l'application ----------------------------- Rendez vous dans le dossier ``install`` et lancez successivement dans l’ordre les scripts suivants : * ``01_install_backend.sh`` : Création du virtualenv python, installation des dépendances et du backend de GeoNature dans celui-ci. * ``02_configure_systemd.sh`` : Création des services systemd ``geonature`` et ``geonature-worker``, configuration de ``logrotate``, création des dossiers ``/run/geonature`` et ``/var/log/geonature``. * ``03_create_db.sh`` : Création du role PostgreSQL, de la base de données, ajout des extensions nécessaires (PostGIS, …), création des schémas nécessaires à GeoNature et ajout des données métiers. * ``04_install_gn_modules.sh`` : Installation des modules Occtax, Occhab et Validation (si activé dans le fichier `settings.ini`). * ``05_install_frontend.sh`` : Création des dossiers et liens symboliques nécessaires, création des fichiers custom à partir des fichiers d’exemple, génération des fichiers de configuration grâce à la commande ``geonature``, installation de nvm, npm et node ainsi que toutes les dépendances javascript nécessaires puis build du frontend, génération du fichier ``src/assets/config.json`` qui permet de connecter le frontend au backend. * ``06_configure_apache.sh`` : Installation du fichier de configuration Apache ``/etc/apache2/conf-available/geonature.conf`` et activation des modules Apache nécessaires. Vous pouvez alors démarrer le backend de GeoNature : ``sudo systemctl start geonature`` Configuration Apache -------------------- * Le script ``install/06_configure_apache.sh`` copie le fichier de configuration de référence ``install/assets/geonature_apache.conf``, le place dans ``/etc/apache2/conf-available/geonature.conf`` et remplace ses variables à partir de votre configuration de GeoNature. Relancez ce script si vous changez l'URL de votre GeoNature ou les paramètres liés aux chemins et URL des fichiers statiques et des médias. * Créez la configuration du vhost, incluant la configuration par défaut créée précédemment : .. code:: shell sudo cp install/assets/vhost_apache.conf /etc/apache2/sites-available/geonature.conf # Copier le vhost sudo nano /etc/apache2/sites-available/geonature.conf # Modifier la variable ``${DOMAIN_NAME}`` * Activez la nouvelle configuration : .. code:: shell sudo a2ensite geonature.conf * et redémarrez Apache : .. code:: shell sudo systemctl reload apache2 * L'application est disponible à l'adresse suivante : http://monurl.fr/geonature Une page HTML de maintenance et un vhost dédié sont aussi disponibles. Pour les mettre en place : .. code:: shell sudo cp install/assets/vhost_apache_maintenance.conf /etc/apache2/sites-available/geonature_maintenance.conf # Copier le vhost sudo nano /etc/apache2/sites-available/geonature_maintenance.conf # Modifier la variable ``${DOMAIN_NAME}`` sudo cp install/assets/maintenance.html /var/www/geonature_maintenance/index.html Pour passer votre GeoNature en maintenance, vous pouvez alors désactiver le vhost de GeoNature et activer celui de la page de maintenance : .. code:: shell sudo a2dissite geonature.conf sudo a2ensite geonature_maintenance.conf Dépendances ----------- Lors de l'installation de la BDD (``02_create_db.sh``), le schéma ``utilisateurs`` de UsersHub et le schéma ``taxonomie`` de TaxHub sont intégrés automatiquement dans la BDD de GeoNature. UsersHub n'est pas nécessaire au fonctionnement de GeoNature mais il sera utile pour avoir une interface de gestion des utilisateurs, des groupes et de leurs droits. TaxHub v2 est intégré à GeoNature depuis sa version 2.15.0 Voir la documentation de TaxHub : https://taxhub.readthedocs.io/ Voir la doc d'installation de UsersHub : https://usershub.readthedocs.io/ Passer en mode développement ---------------------------- .. Note:: Consultez le guide :ref:`mode-dev` de GeoNature.