oedb-backend/server_config/systemd_service_installation.md

# 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`.