====== Runbook: Avviare/arrestare server ======

<WRAP round info>
**Durata:** ~5 minuti \\
**Ruolo:** Operatore Gateway \\
**Prerequisito:** Diritti di amministratore
</WRAP>

----

===== Workflow =====

<mermaid>
flowchart TD
    A[Start] --> B{Gia in esecuzione?}
    B -->|Si| C[Arrestare]
    B -->|No| D[Avviare]
    C --> D
    D --> E[Health Check]
    E --> F{Riuscito?}
    F -->|Si| G[Finito]
    F -->|No| H[Controllare log]
    H --> D

    style G fill:#e8f5e9
    style H fill:#ffebee
</mermaid>

----

===== 1. Verificare stato =====

**Windows:**

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

# Oppure via porta
netstat -ano | findstr :5000
</code>

**Linux:**

<code bash>
# Cercare processo
pgrep -f "WvdS.WebAPI.Data.Gateway.Api"

# Oppure via porta
ss -tlnp | grep 5000
</code>

----

===== 2. Avviare server =====

**Windows (Console):**

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

**Windows (Background):**

<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. Arrestare server =====

**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 (solo se necessario)
pkill -9 -f "WvdS.WebAPI.Data.Gateway.Api"
</code>

----

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

<code bash>
# Verificare disponibilita
curl -s http://localhost:5000/health

# Risposta attesa: "Healthy"
</code>

----

===== 5. Checklist =====

| # | Punto di verifica | v |
|---|-----------|---|
| 1 | Processo in esecuzione | ☐ |
| 2 | Porta 5000 aperta | ☐ |
| 3 | Health Check "Healthy" | ☐ |
| 4 | Nessun errore in console | ☐ |

----

===== Troubleshooting =====

| Problema | Causa | Soluzione |
|---------|---------|--------|
| ''Porta gia in uso'' | Vecchio processo attivo | Terminare processo, poi avviare |
| ''Access denied'' | Diritti mancanti | Avviare come amministratore |
| ''Config error'' | appsettings.json errato | Verificare sintassi JSON |
| ''Database connection failed'' | DSN configurato male | Verificare Connection String |

----

===== Runbook Correlati =====

  * [[.:health-check|Health Check]] - Verifica stato dettagliata
  * [[.:logs-pruefen|Controllare log]] - Analisi errori
  * [[..:automatisierung:windows-dienst|Servizio Windows]] - Eseguire come servizio

----

<< [[.:start|<- Attivita Quotidiane]] | [[.:dsn-verwalten|-> Gestire DSN]] >>

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

{{tag>operator runbook server avviare arrestare}}