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-<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/
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=<mot-de-passe>
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