| 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 [2020/02/25 16:42] – 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.6.3.zip -O taxhub_v1.6.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>'' |
| * Décompresser l'archive dans le dossier //www// de l'utilisateur //geonat// : ''unzip taxhub_v1.6.3.zip -d ~/www/'' | * Décompresser l'archive dans le dossier //www// de l'utilisateur //geonat// : ''unzip taxhub_v1.7.3.zip -d ~/www/'' |
| * Se rendre dans le dossier //www// : ''cd ~/www/'' | * Se rendre dans le dossier //www// : ''cd ~/www/'' |
| * Renommer le dossier de TaxHub (au format GeoNature => uniformité): ''mv TaxHub-1.6.3 taxhub_v1.6.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.6.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> |
| user_pg_pass=<mot-de-passe> | user_pg_pass=<mot-de-passe> |
| insert_taxons_example=false | insert_taxons_example=false |
| gun_num_workers=4 # ATTENTION : voir si nécessaire de monter ce chiffre ou pas en cas de nombreux accès concurrents ! | gun_num_workers=5 # Par défaut mettre : (2 * nombre de CPU) + 1 |
| 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 install_app.log'' | |
| * Vérifier que le fichier de conf de //Supervisor// pour Taxhub utilise le lien symbolique : ''vi /etc/supervisor/conf.d/taxhub-service.conf'' | |
jpmilcent