Runbook: Server starten/stoppen

Dauer: ~5 Minuten
Rolle: Gateway-Operator
Voraussetzung: Administratorrechte

Workflow

flowchart TD A[Start] --> B{Läuft bereits?} B -->|Ja| C[Stoppen] B -->|Nein| D[Starten] C --> D D --> E[Health Check] E --> F{Erfolgreich?} F -->|Ja| G[Fertig] F -->|Nein| H[Logs prüfen] H --> D style G fill:#e8f5e9 style H fill:#ffebee

1. Status prüfen

Windows:

# Prozess suchen
Get-Process -Name "WvdS.WebAPI.Data.Gateway.Api" -ErrorAction SilentlyContinue
 
# Oder via Port
netstat -ano | findstr :5000

Linux:

# Prozess suchen
pgrep -f "WvdS.WebAPI.Data.Gateway.Api"
 
# Oder via Port
ss -tlnp | grep 5000

2. Server starten

Windows (Konsole):

cd %GATEWAY_ROOT%
.\WvdS.WebAPI.Data.Gateway.Api.exe

Windows (Hintergrund):

Start-Process -FilePath "%GATEWAY_ROOT%\WvdS.WebAPI.Data.Gateway.Api.exe" -WindowStyle Hidden

Linux:

cd /opt/gateway
./WvdS.WebAPI.Data.Gateway.Api &

3. Server stoppen

Windows:

# Graceful shutdown
Stop-Process -Name "WvdS.WebAPI.Data.Gateway.Api" -Force

Linux:

# Graceful shutdown
pkill -SIGTERM -f "WvdS.WebAPI.Data.Gateway.Api"
 
# Force kill (nur wenn nötig)
pkill -9 -f "WvdS.WebAPI.Data.Gateway.Api"

4. Health Check

# Verfügbarkeit prüfen
curl -s http://localhost:5000/health
 
# Erwartete Antwort: "Healthy"

5. Checkliste

#	Prüfpunkt	✓
—	———–	—
1	Prozess läuft	☐
2	Port 5000 offen	☐
3	Health Check „Healthy“	☐
4	Keine Fehler in Konsole	☐

Troubleshooting

Problem	Ursache	Lösung
———	———	——–
`Port bereits in Verwendung`	Alter Prozess läuft	Prozess beenden, dann starten
`Access denied`	Fehlende Rechte	Als Administrator starten
`Config error`	appsettings.json fehlerhaft	JSON-Syntax prüfen
`Database connection failed`	DSN falsch konfiguriert	Connection String prüfen

Inhaltsverzeichnis

Runbook: Server starten/stoppen

Workflow

1. Status prüfen

2. Server starten

3. Server stoppen

4. Health Check

5. Checkliste

Troubleshooting

Verwandte Runbooks

Seiten-Werkzeuge