====== Runbook: Server starten/stoppen ======

<WRAP round info>
**Dauer:** ~5 Minuten \\
**Rolle:** Gateway-Operator \\
**Voraussetzung:** Administratorrechte
</WRAP>

----

===== Workflow =====

<mermaid>
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
</mermaid>

----

===== 1. Status prüfen =====

**Windows:**

<code powershell>
# Prozess suchen
Get-Process -Name "WvdS.WebAPI.Data.Gateway.Api" -ErrorAction SilentlyContinue

# Oder via Port
netstat -ano | findstr :5000
</code>

**Linux:**

<code bash>
# Prozess suchen
pgrep -f "WvdS.WebAPI.Data.Gateway.Api"

# Oder via Port
ss -tlnp | grep 5000
</code>

----

===== 2. Server starten =====

**Windows (Konsole):**

<code powershell>
cd %GATEWAY_ROOT%
.\WvdS.WebAPI.Data.Gateway.Api.exe
</code>

**Windows (Hintergrund):**

<code powershell>
Start-Process -FilePath "%GATEWAY_ROOT%\WvdS.WebAPI.Data.Gateway.Api.exe" -WindowStyle Hidden
</code>

**Linux:**

<code bash>
cd /opt/gateway
./WvdS.WebAPI.Data.Gateway.Api &
</code>

----

===== 3. Server stoppen =====

**Windows:**

<code powershell>
# Graceful shutdown
Stop-Process -Name "WvdS.WebAPI.Data.Gateway.Api" -Force
</code>

**Linux:**

<code bash>
# Graceful shutdown
pkill -SIGTERM -f "WvdS.WebAPI.Data.Gateway.Api"

# Force kill (nur wenn nötig)
pkill -9 -f "WvdS.WebAPI.Data.Gateway.Api"
</code>

----

===== 4. Health Check =====

<code bash>
# Verfügbarkeit prüfen
curl -s http://localhost:5000/health

# Erwartete Antwort: "Healthy"
</code>

----

===== 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 |

----

===== Verwandte Runbooks =====

  * [[.:health-check|Health Check]] – Detaillierte Statusprüfung
  * [[.:logs-pruefen|Logs prüfen]] – Fehleranalyse
  * [[..:automatisierung:windows-dienst|Windows-Dienst]] – Als Service betreiben

----

<< [[.:start|← Tagesgeschäft]] | [[.:dsn-verwalten|→ DSN verwalten]] >>

----
//Wolfgang van der Stille @ EMSR DATA d.o.o. - Data Gateway Professional//

{{tag>operator runbook server start stop}}