oedb-backend/server_config/systemd_service_installation.md
2025-09-18 23:43:06 +02:00

2.5 KiB

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 :
# 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 :

  1. Démarrez le service :

  1. Vérifiez l'état du service :
sudo systemctl status oedb-uwsgi.service

Gestion du service

  • Pour arrêter le service :
sudo systemctl stop oedb-uwsgi.service
  • Pour redémarrer le service :
sudo systemctl restart oedb-uwsgi.service
  • Pour voir les logs du service :
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 :
sudo systemctl status postgresql
  1. Vérifiez les logs du service pour identifier les erreurs :
sudo journalctl -u oedb-uwsgi.service -n 50
  1. Vérifiez que les chemins dans le fichier de service sont corrects et que l'utilisateur www-data a accès à ces chemins.

  2. Assurez-vous que l'environnement virtuel Python est correctement configuré et que uwsgi est installé dans cet environnement.

  3. 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.