| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente |
| serveurs:installation:web-srv:geonature-taxhub-app [2021/04/14 15:00] – jpmilcent | serveurs:installation:web-srv:geonature-taxhub-app [2023/11/12 21:29] (Version actuelle) – [Méthode utilisant Git] jpmilcent |
|---|
| * **Documentation** : https://taxhub.readthedocs.io/fr/latest/ | * **Documentation** : https://taxhub.readthedocs.io/fr/latest/ |
| * **Notes** : la base de données a déjà été installé par le script //install_db.sh// de GeoNature. | * **Notes** : la base de données a déjà été installé par le script //install_db.sh// de GeoNature. |
| * Récupérer la version de TaxHub compatible avec la version de GeoNature installé dans le fichier : ''cat ~/www/geonature/config/settings.ini | grep taxhub_release'' | |
| | ===== Téléchargement des sources et organisation des dossiers ===== |
| | * Se connecter sur l'instance //web-srv// avec l'utilisateur //geonat// : ''ssh geonat@db-<region>-sinp'' |
| | * Déterminer la version de TaxHub compatible avec la version de GeoNature installé en consultant les logs de GeoNature et Taxhub |
| | * Dans les anciennes versions de GeoNature l'information est disponible dans la config : ''cat ~/www/geonature/config/settings.ini | grep taxhub_release'' |
| | * Se rendre dans le home de l'utilisateur //geonat// : ''cd /home/geonat'' |
| | * Créer un dossier //dwl/// : ''mkdir ~/dwl'' |
| | * Créer un dossier //www/// : ''mkdir ~/www'' |
| | |
| | ==== Méthode utilisant Git ==== |
| | * Se placer dans le dossier //www// : ''cd ~/www'' |
| | * Cloner le dépôt Git de TaxHub : ''%%git clone https://github.com/PnX-SI/TaxHub.git taxhub%%'' |
| | * Créer un lien symbolique depuis la racine du home de //geonat// : ''cd ~/; ln -s www/taxhub taxhub'' |
| | * Se placer dans le dépôt de TaxHub //www/taxhub/// : ''cd ~/taxhub'' |
| | * Basculer sur la version souhaitée de TaxHub avec la commande ''git checkout <tag>''. Par exemple : ''git checkout 1.12.1'' |
| | |
| | ==== 🗑️ Méthode utilisant une archive ===== |
| * Se placer dans le dossier //dwl// de l'utilisateur //geonat// : ''cd ~/dwl/'' | * Se placer dans le dossier //dwl// de l'utilisateur //geonat// : ''cd ~/dwl/'' |
| * Télécharger l'archive : ''<nowiki>wget https://github.com/PnX-SI/TaxHub/archive/1.7.3.zip -O taxhub_v1.7.3.zip</nowiki>'' | * Télécharger l'archive : ''<nowiki>wget https://github.com/PnX-SI/TaxHub/archive/1.7.3.zip -O taxhub_v1.7.3.zip</nowiki>'' |
| * Renommer le dossier de TaxHub (au format GeoNature => uniformité): ''mv TaxHub-1.7.3 taxhub_v1.7.3'' | * Renommer le dossier de TaxHub (au format GeoNature => uniformité): ''mv TaxHub-1.7.3 taxhub_v1.7.3'' |
| * Créer un lien symbolique : ''ln -s taxhub_v1.7.3 taxhub'' | * Créer un lien symbolique : ''ln -s taxhub_v1.7.3 taxhub'' |
| * Se rendre dans le dossier de TaxHub : ''cd taxhub'' | |
| | ===== Configuration et installation de TaxHub ===== |
| | * Se rendre dans le dossier de TaxHub : ''cd ~/www/taxhub'' |
| * Créer le fichier //settings.ini// : ''cp settings.ini.sample settings.ini'' | * Créer le fichier //settings.ini// : ''cp settings.ini.sample settings.ini'' |
| * Éditer le fichier //settings.ini// et modifier les propriétés : ''vi settings.ini'' <code ini> | * Éditer le fichier //settings.ini// et modifier les propriétés : ''vi settings.ini'' <code ini> |
| gun_host=127.0.0.1 # Bloquer l'accès extérieur au port 5000 de l'API => mettre en place un proxy Nginx via un sous-domaine si nécessaire. | gun_host=127.0.0.1 # Bloquer l'accès extérieur au port 5000 de l'API => mettre en place un proxy Nginx via un sous-domaine si nécessaire. |
| </code> | </code> |
| * Pour OpenCV (utiliser par TaxHub) installer les paquets suivant : ''aptitude install libsm6 libxext6 libxrender-dev'' | * Créer un dossier qui contiendra les logs de l'installation : ''mkdir -p ~/www/taxhub/var/log/'' |
| * Créer le dossier des logs : ''mkdir -p var/log'' | * Lancer l'installation : ''./install_app.sh 2>&1 | tee var/log/$(date +"%Y-%m-%d")_install_app.log'' |
| * Créer le fichier de log de l'installation : ''touch var/log/install_app.log'' | |
| * Lancer l'installation : ''./install_app.sh 2>&1 | tee var/log/install_app.log'' | |
| * Modifier le fichier de conf de //Supervisor// pour Taxhub : ''sudo vi /etc/supervisor/conf.d/taxhub-service.conf'' | |
| * Le paramètre //command// doit utiliser le lien symbolique : ''command = /home/geonat/www/taxhub/gunicorn_start.sh'' | |
| * Le paramètre //stdout_logfile// doit utiliser le lien symbolique : ''stdout_logfile = /home/geonat/www/taxhub/var/log/taxhub-errors.log'' | |
| * Ajouter le paramètre suivant pour forcer Supervisor à utiliser l'utilisateur //geonat// (création des fichiers de log) : '' user = geonat '' | |
jpmilcent