146 lines
2.5 KiB
Markdown
146 lines
2.5 KiB
Markdown
# VizionStreamer Systemd Service
|
|
|
|
Automatischer Start und Überwachung des VizionStreamer mit systemd.
|
|
|
|
## Inhalt
|
|
|
|
- `vizionstreamer.service` - Systemd service file
|
|
- `watchdog.sh` - Watchdog-Script (startet Streamer neu bei Crash)
|
|
- `install.sh` - Installations-Script
|
|
- `uninstall.sh` - Deinstallations-Script
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
cd service
|
|
sudo ./install.sh
|
|
```
|
|
|
|
Das Script:
|
|
1. Kopiert die Service-Datei nach `/etc/systemd/system/`
|
|
2. Aktiviert den Service (Start beim Booten)
|
|
3. Startet den Service sofort
|
|
|
|
## Deinstallation
|
|
|
|
```bash
|
|
cd service
|
|
sudo ./uninstall.sh
|
|
```
|
|
|
|
## Befehle
|
|
|
|
### Service verwalten
|
|
|
|
```bash
|
|
# Service starten
|
|
sudo systemctl start vizionstreamer
|
|
|
|
# Service stoppen
|
|
sudo systemctl stop vizionstreamer
|
|
|
|
# Service neu starten
|
|
sudo systemctl restart vizionstreamer
|
|
|
|
# Status anzeigen
|
|
sudo systemctl status vizionstreamer
|
|
|
|
# Autostart deaktivieren
|
|
sudo systemctl disable vizionstreamer
|
|
|
|
# Autostart aktivieren
|
|
sudo systemctl enable vizionstreamer
|
|
```
|
|
|
|
### Logs anzeigen
|
|
|
|
```bash
|
|
# Live-Logs verfolgen
|
|
sudo journalctl -u vizionstreamer -f
|
|
|
|
# Letzte 100 Zeilen
|
|
sudo journalctl -u vizionstreamer -n 100
|
|
|
|
# Logs seit heute
|
|
sudo journalctl -u vizionstreamer --since today
|
|
|
|
# Alle Logs
|
|
sudo journalctl -u vizionstreamer --no-pager
|
|
```
|
|
|
|
## Funktionen
|
|
|
|
✅ **Automatischer Start** beim Booten
|
|
✅ **Watchdog** startet Prozess bei Crash neu (max. 10 Versuche)
|
|
✅ **Systemd Integration** - Logs in journald
|
|
✅ **Graceful Shutdown** - Sauberes Beenden
|
|
✅ **Restart-Limit** - Verhindert endlose Restart-Loops
|
|
|
|
## Konfiguration
|
|
|
|
### Service-Einstellungen anpassen
|
|
|
|
Service-Datei bearbeiten:
|
|
```bash
|
|
sudo systemctl edit vizionstreamer --full
|
|
```
|
|
|
|
Nach Änderungen:
|
|
```bash
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl restart vizionstreamer
|
|
```
|
|
|
|
### Watchdog-Intervall ändern
|
|
|
|
In `watchdog.sh`:
|
|
```bash
|
|
CHECK_INTERVAL=5 # Sekunden (Standard: 5)
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Service startet nicht
|
|
|
|
1. Status prüfen:
|
|
```bash
|
|
sudo systemctl status vizionstreamer
|
|
```
|
|
|
|
2. Logs prüfen:
|
|
```bash
|
|
sudo journalctl -u vizionstreamer -n 50
|
|
```
|
|
|
|
3. Manuell testen:
|
|
```bash
|
|
./watchdog.sh
|
|
```
|
|
|
|
### Permissions
|
|
|
|
Falls Permission-Probleme:
|
|
```bash
|
|
sudo usermod -a -G video maik
|
|
sudo usermod -a -G audio maik
|
|
```
|
|
|
|
### Service deaktivieren (temporär)
|
|
|
|
```bash
|
|
sudo systemctl stop vizionstreamer
|
|
sudo systemctl disable vizionstreamer
|
|
```
|
|
|
|
## Systemanforderungen
|
|
|
|
- Linux mit systemd
|
|
- Zugriff auf `/dev/video*` Geräte
|
|
- User `maik` muss Zugriff auf Kamera haben
|
|
|
|
## Support
|
|
|
|
Bei Problemen siehe:
|
|
- `sudo journalctl -u vizionstreamer -f`
|
|
- `tail -f ../watchdog.log`
|