Installer UsersHub App
- Documentation : https://usershub.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 UsersHub compatible avec la version de GeoNature installé en consultant les logs de GeoNature et UsrsHub
- Dans les anciennes versions de GeoNature l'information est disponible dans la config :
cat ~/www/geonature/config/settings.ini | grep usershub_release
- Se rendre dans le home de l'utilisateur geonat :
cd /home/geonat - Créer un dossier dwl/ qui contiendra les éléments téléchargés :
mkdir ~/dwl - Créer un dossier www/ qui contiendra le code source des éléments accessibles sur le web:
mkdir ~/www
Méthode utilisant Git
- Se placer dans le dossier www :
cd ~/www - Cloner le dépôt Git de UsersHub :
git clone https://github.com/PnX-SI/UsersHub.git usershub - Créer un lien symbolique depuis la racine du home de geonat :
cd ~/; ln -s www/usershub usershub - Se placer dans le dépôt de UsersHub www/usershub/ :
cd ~/usershub - Basculer sur la version souhaitée de UsersHub avec la commande
git checkout <tag>. Par exemple :git checkout 2.3.4
🗑️ 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/UsersHub/archive/2.1.0.zip -O usershub_v2.1.0.zip - Décompresser l'archive dans le dossier www de l'utilisateur geonat :
unzip usershub_v2.1.0.zip -d ~/www/ - Se rendre dans le dossier www :
cd ~/www/ - Renommer le dossier de UsersHub (au format GeoNature ⇒ uniformité):
mv UsersHub-2.1.0 usershub_v2.1.0 - Créer un lien symbolique :
ln -s usershub_v2.1.0 usershub
Configuration et installation de UsersHub
- Se rendre dans le dossier de UsersHub :
cd ~/www/usershub - Créer le fichier settings.ini :
cp config/settings.ini.sample config/settings.ini - Éditer le fichier settings.ini et modifier les propriétés :
vi config/settings.inidb_host=10.0.1.20 db_name=geonature2db user_pg=geonatadmin user_pg_pass=<mot-de-passe> insert_sample_data=false url_application=https://usershub.<domaine-sinp> 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 var/log - Lancer l'installation :
./install_app.sh 2>&1 | tee var/log/$(date +"%Y-%m-%d")_install_app.log
jpmilcent