93 lines
No EOL
2.5 KiB
Markdown
93 lines
No EOL
2.5 KiB
Markdown
# 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`. |