serveurs:installation:web-srv:geonature-usershub-app [CBNA SINP]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== 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 : ''<nowiki>wget https://github.com/PnX-SI/UsersHub/archive/2.1.0.zip -O usershub_v2.1.0.zip</nowiki>''
  * 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.ini'' <code ini>
db_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.
</code>
  * 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''