Files
Infraviewer/SERVICE_ANLEITUNG.md
2026-02-17 16:00:34 +01:00

157 lines
2.7 KiB
Markdown

# Infraviewer als systemd Service installieren
## Automatische Installation (empfohlen)
```bash
cd /home/sdsadmin/infraviewer
./install-service.sh
```
## Manuelle Installation
Falls Sie die Installation Schritt für Schritt durchführen möchten:
### 1. Service-Datei kopieren
```bash
sudo cp /tmp/infraviewer.service /etc/systemd/system/infraviewer.service
```
### 2. Alte Server-Prozesse beenden
```bash
pkill -f "node server.js"
```
### 3. systemd neu laden
```bash
sudo systemctl daemon-reload
```
### 4. Service aktivieren (Autostart beim Booten)
```bash
sudo systemctl enable infraviewer.service
```
### 5. Service starten
```bash
sudo systemctl start infraviewer.service
```
### 6. Status prüfen
```bash
sudo systemctl status infraviewer.service
```
---
## Service-Verwaltung
### Status anzeigen
```bash
sudo systemctl status infraviewer
```
### Service starten
```bash
sudo systemctl start infraviewer
```
### Service stoppen
```bash
sudo systemctl stop infraviewer
```
### Service neu starten
```bash
sudo systemctl restart infraviewer
```
### Autostart aktivieren
```bash
sudo systemctl enable infraviewer
```
### Autostart deaktivieren
```bash
sudo systemctl disable infraviewer
```
### Logs anzeigen
```bash
# Letzte Logs anzeigen
sudo journalctl -u infraviewer -n 50
# Live-Logs verfolgen
sudo journalctl -u infraviewer -f
# Logs seit heute
sudo journalctl -u infraviewer --since today
```
---
## Service-Konfiguration
Die Service-Datei befindet sich unter:
```
/etc/systemd/system/infraviewer.service
```
### Eigenschaften des Service:
-**Automatischer Start** beim Systemstart
-**Automatischer Neustart** bei Absturz (nach 10 Sekunden)
-**Logs** werden ins Systemlog geschrieben
-**Läuft als Benutzer** `sdsadmin`
-**Arbeitsverzeichnis** `/home/sdsadmin/infraviewer`
### Service bearbeiten:
```bash
sudo nano /etc/systemd/system/infraviewer.service
# Nach Änderungen:
sudo systemctl daemon-reload
sudo systemctl restart infraviewer
```
---
## Fehlerbehebung
### Service startet nicht
```bash
# Detaillierte Fehlermeldungen anzeigen
sudo systemctl status infraviewer -l
# Logs prüfen
sudo journalctl -u infraviewer -n 100
```
### Port bereits belegt
```bash
# Prüfen, welcher Prozess Port 3001 verwendet
sudo lsof -i :3001
# Prozess beenden
sudo kill -9 <PID>
```
### Service deinstallieren
```bash
sudo systemctl stop infraviewer
sudo systemctl disable infraviewer
sudo rm /etc/systemd/system/infraviewer.service
sudo systemctl daemon-reload
```
---
## Zugriff auf die Anwendung
Nach erfolgreicher Installation ist die Anwendung erreichbar unter:
**http://localhost:3001**
oder von anderen Rechnern im Netzwerk:
**http://192.168.120.88:3001**