| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente |
| serveurs:installation:web-srv:geonature-usershub-app [2021/04/14 14:45] – jpmilcent | serveurs:installation:web-srv:geonature-usershub-app [2023/11/13 15:32] (Version actuelle) – [Configuration et installation de UsersHub] jpmilcent |
|---|
| * **Documentation** : https://usershub.readthedocs.io/fr/latest/ | * **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. | * **Notes** : la base de données a déjà été installé par le script //install_db.sh// de GeoNature. |
| * Récupérer la version de UsrsHub compatible avec la version de GeoNature installée dans le fichier de config : ''cat ~/www/geonature/config/settings.ini | grep usershub_release'' | |
| | ===== 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/'' | * 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>'' | * 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>'' |
| * Renommer le dossier de UsersHub (au format GeoNature => uniformité): ''mv UsersHub-2.1.0 usershub_v2.1.0'' | * 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'' | * Créer un lien symbolique : ''ln -s usershub_v2.1.0 usershub'' |
| * Se rendre dans le dossier de UsersHub : ''cd 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'' | * 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> | * Éditer le fichier //settings.ini// et modifier les propriétés : ''vi config/settings.ini'' <code ini> |
| 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. | 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> | </code> |
| * Créer le dossier des logs : ''mkdir -p var/log'' | * Créer un dossier qui contiendra les logs de l'installation : ''mkdir -p var/log'' |
| * Créer le fichier de log de l'installation : ''touch var/log/install_app.log'' | * Lancer l'installation : ''./install_app.sh 2>&1 | tee var/log/$(date +"%Y-%m-%d")_install_app.log'' |
| * Lancer l'installation : ''./install_app.sh 2>&1 | tee install_app.log'' | |
| * Modifier le fichier de conf de //Supervisor// pour Usershub : ''sudo vi /etc/supervisor/conf.d/usershub-service.conf'' | |
| * Le paramètre //command// doit utiliser le lien symbolique : ''command = /home/geonat/www/usershub/gunicorn_start.sh'' | |
| * Le paramètre //stdout_logfile// doit utiliser le lien symbolique : ''stdout_logfile = /home/geonat/www/usershub/var/log/errors_uhv2.log'' | |
| * Ajouter le paramètre suivant pour forcer //Supervisor// à utiliser l'utilisateur //geonat// (création des fichiers de log) : '' user = geonat '' | |
jpmilcent