up demo

server_config/systemd_service_installation.md

@@ -0,0 +1,93 @@
+# Installation du service systemd pour uWSGI
+
+Ce document explique comment installer et activer le service systemd pour faire fonctionner le serveur uWSGI de l'OpenEventDatabase backend.
+
+## Prérequis
+
+- Système Linux avec systemd
+- Droits d'administrateur (sudo)
+- PostgreSQL installé et configuré
+- Python et dépendances installées (voir README.md)
+
+## Installation du service
+
+1. Copiez le fichier de service dans le répertoire systemd :
+2. Assurez-vous que les permissions sont correctes :
+3. Assurez-vous que l'utilisateur www-data a les permissions nécessaires sur le répertoire du projet :
+4. Rechargez la configuration de systemd :
+```bash
+# attention à bien corriger le password POSTGRES_PASSWORD=blahblah dans le fichier du service pour mettre celui de l'utilisateur postgres que vous aurez créé
+sudo cp oedb-uwsgi.service /etc/systemd/system/
+
+sudo chmod 644 /etc/systemd/system/oedb-uwsgi.service
+sudo chown -R www-data:www-data /home/poule/encrypted/oedb-backend
+sudo systemctl daemon-reload
+sudo systemctl enable oedb-uwsgi.service
+sudo systemctl start oedb-uwsgi.service
+```
+
+## Activation et démarrage du service
+
+1. Activez le service pour qu'il démarre automatiquement au démarrage du système :
+
+```bash
+
+```
+
+2. Démarrez le service :
+
+```bash
+
+```
+
+3. Vérifiez l'état du service :
+
+```bash
+sudo systemctl status oedb-uwsgi.service
+```
+
+## Gestion du service
+
+- Pour arrêter le service :
+
+```bash
+sudo systemctl stop oedb-uwsgi.service
+```
+
+- Pour redémarrer le service :
+
+```bash
+sudo systemctl restart oedb-uwsgi.service
+```
+
+- Pour voir les logs du service :
+
+```bash
+sudo journalctl -u oedb-uwsgi.service
+```
+
+## Dépannage
+
+Si le service ne démarre pas correctement, vérifiez les points suivants :
+
+1. Assurez-vous que PostgreSQL est en cours d'exécution :
+
+```bash
+sudo systemctl status postgresql
+```
+
+2. Vérifiez les logs du service pour identifier les erreurs :
+
+```bash
+sudo journalctl -u oedb-uwsgi.service -n 50
+```
+
+3. Vérifiez que les chemins dans le fichier de service sont corrects et que l'utilisateur www-data a accès à ces chemins.
+
+4. Assurez-vous que l'environnement virtuel Python est correctement configuré et que uwsgi est installé dans cet environnement.
+
+5. Vérifiez que le script setup_db.sh s'exécute correctement et que la base de données est accessible avec les identifiants fournis.
+
+## Personnalisation
+
+Si vous souhaitez modifier la configuration du service, éditez le fichier `/etc/systemd/system/oedb-uwsgi.service` puis rechargez la configuration de systemd avec `sudo systemctl daemon-reload`.