====== Runbook: Start/Stop Server ======

<WRAP round info>
**Duration:** ~5 minutes \\
**Role:** Gateway Operator \\
**Prerequisite:** Administrator rights
</WRAP>

----

===== Workflow =====

<mermaid>
flowchart TD
    A[Start] --> B{Already running?}
    B -->|Yes| C[Stop]
    B -->|No| D[Start]
    C --> D
    D --> E[Health Check]
    E --> F{Successful?}
    F -->|Yes| G[Done]
    F -->|No| H[Check logs]
    H --> D

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

----

===== 1. Check Status =====

**Windows:**

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

# Or via port
netstat -ano | findstr :5000
</code>

**Linux:**

<code bash>
# Find process
pgrep -f "WvdS.WebAPI.Data.Gateway.Api"

# Or via port
ss -tlnp | grep 5000
</code>

----

===== 2. Start 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. Stop 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 (only if necessary)
pkill -9 -f "WvdS.WebAPI.Data.Gateway.Api"
</code>

----

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

<code bash>
# Check availability
curl -s http://localhost:5000/health

# Expected response: "Healthy"
</code>

----

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

| # | Check | Done |
|---|-------|------|
| 1 | Process running | [ ] |
| 2 | Port 5000 open | [ ] |
| 3 | Health Check "Healthy" | [ ] |
| 4 | No errors in console | [ ] |

----

===== Troubleshooting =====

| Problem | Cause | Solution |
|---------|-------|----------|
| ''Port already in use'' | Old process running | Stop process, then start |
| ''Access denied'' | Missing permissions | Start as administrator |
| ''Config error'' | appsettings.json faulty | Check JSON syntax |
| ''Database connection failed'' | DSN misconfigured | Check connection string |

----

===== Related Runbooks =====

  * [[.:health-check|Health Check]] - Detailed status check
  * [[.:logs-pruefen|Check Logs]] - Error analysis
  * [[..:automatisierung:windows-dienst|Windows Service]] - Run as service

----

<< [[.:start|<- Daily Operations]] | [[.:dsn-verwalten|-> Manage DSN]] >>

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

{{tag>operator runbook server start stop}}