InitalCommit

SERVICE_ANLEITUNG.md

@@ -0,0 +1,156 @@
+# 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**
+