====== Runbook: Zagon/zaustavitev strežnika ======

<WRAP round info>
**Trajanje:** ~5 minut \\
**Vloga:** Gateway-operater \\
**Predpogoj:** Administratorske pravice
</WRAP>

----

===== Potek dela =====

<mermaid>
flowchart TD
    A[Začetek] --> B{Že teče?}
    B -->|Da| C[Zaustavi]
    B -->|Ne| D[Zaženi]
    C --> D
    D --> E[Health Check]
    E --> F{Uspešno?}
    F -->|Da| G[Končano]
    F -->|Ne| H[Preveri dnevnike]
    H --> D

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

----

===== 1. Preverjanje stanja =====

**Windows:**

<code powershell>
# Išči proces
Get-Process -Name "WvdS.WebAPI.Data.Gateway.Api" -ErrorAction SilentlyContinue

# Ali prek porta
netstat -ano | findstr :5000
</code>

**Linux:**

<code bash>
# Išči proces
pgrep -f "WvdS.WebAPI.Data.Gateway.Api"

# Ali prek porta
ss -tlnp | grep 5000
</code>

----

===== 2. Zagon strežnika =====

**Windows (konzola):**

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

**Windows (ozadje):**

<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. Zaustavitev strežnika =====

**Windows:**

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

**Linux:**

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

# Prisilna zaustavitev (samo če potrebno)
pkill -9 -f "WvdS.WebAPI.Data.Gateway.Api"
</code>

----

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

<code bash>
# Preveri razpoložljivost
curl -s http://localhost:5000/health

# Pričakovan odgovor: "Healthy"
</code>

----

===== 5. Kontrolni seznam =====

| # | Točka preverjanja | V |
|---|-----------|---|
| 1 | Proces teče | |
| 2 | Port 5000 odprt | |
| 3 | Health Check "Healthy" | |
| 4 | Brez napak v konzoli | |

----

===== Odpravljanje težav =====

| Težava | Vzrok | Rešitev |
|---------|---------|--------|
| ''Port že v uporabi'' | Star proces teče | Ustavi proces, nato zaženi |
| ''Access denied'' | Manjkajoče pravice | Zaženi kot administrator |
| ''Config error'' | appsettings.json napačen | Preveri JSON-sintakso |
| ''Database connection failed'' | DSN napačno konfiguriran | Preveri Connection String |

----

===== Povezani Runbooks =====

  * [[.:health-check|Health Check]] - Podrobno preverjanje stanja
  * [[.:logs-pruefen|Pregled dnevnikov]] - Analiza napak
  * [[..:automatisierung:windows-dienst|Windows-storitev]] - Delovanje kot storitev

----

<< [[.:start|<- Dnevno poslovanje]] | [[.:dsn-verwalten|-> Upravljanje DSN]] >>

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

{{tag>operator runbook server start stop}}