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