====== Installer TaxHub App ====== * **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. ===== Téléchargement des sources et organisation des dossiers ===== * Se connecter sur l'instance //web-srv// avec l'utilisateur //geonat// : ''ssh geonat@db--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 ''. Par exemple : ''git checkout 1.12.1'' ==== 🗑️ Méthode utilisant une archive ===== * Se placer dans le dossier //dwl// de l'utilisateur //geonat// : ''cd ~/dwl/'' * Télécharger l'archive : ''wget https://github.com/PnX-SI/TaxHub/archive/1.7.3.zip -O taxhub_v1.7.3.zip'' * 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/'' * 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'' ===== 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'' * Éditer le fichier //settings.ini// et modifier les propriétés : ''vi settings.ini'' db_host=10.0.1.20 db_port=5432 db_name=geonature2db user_pg=geonatadmin user_pg_pass= insert_taxons_example=false 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. * Créer un dossier qui contiendra les logs de l'installation : ''mkdir -p ~/www/taxhub/var/log/'' * Lancer l'installation : ''./install_app.sh 2>&1 | tee var/log/$(date +"%Y-%m-%d")_install_app.log''