debug shared_buffer stream
This commit is contained in:
145
service/README.md
Normal file
145
service/README.md
Normal file
@@ -0,0 +1,145 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user