====== Operator Handbook ======

<WRAP round info>
**Target audience:** Sysadmins, DevOps, Operators \\
**Content:** Runbooks, checklists, scripts \\
**Format:** Copy-paste ready commands
</WRAP>

Operational guides for daily operation of the Data Gateway.

----

===== Overview =====

<mermaid>
flowchart TB
    subgraph DAILY["DAILY OPERATIONS"]
        D1[Start server]
        D2[Manage DSN]
        D3[Health Check]
        D4[Check logs]
    end

    subgraph AUTO["AUTOMATION"]
        A1[Windows Service]
        A2[systemd]
        A3[Docker]
        A4[Kubernetes]
    end

    subgraph MON["MONITORING"]
        M1[Prometheus]
        M2[Grafana]
        M3[Alerting]
    end

    subgraph SEC["SECURITY"]
        S1[Set up TLS]
        S2[Certificates]
        S3[Firewall]
    end

    DAILY --> AUTO
    AUTO --> MON
    MON --> SEC

    style D1 fill:#e8f5e9
    style A1 fill:#e3f2fd
    style M1 fill:#fff3e0
    style S1 fill:#ffebee
</mermaid>

----

===== Categories =====

^  Category  ^  Description  ^  Runbooks  ^
| [[.:tagesgeschaeft:start|Daily Operations]] | Start server, manage DSN, Health Check, Logs | 4 |
| [[.:automatisierung:start|Automation]] | Windows Service, systemd, Docker, Kubernetes | 4 |
| [[.:monitoring:start|Monitoring]] | Prometheus, Grafana, Alerting | 3 |
| [[.:sicherheit:start|Security]] | TLS, Certificates, Firewall | 3 |
| [[.:backup:start|Backup]] | Config Backup, DSN Export | 2 |

----

===== Quick Start =====

**Start Gateway immediately:**

<code bash>
# Windows
WvdS.WebAPI.Data.Gateway.Api.exe

# Linux
./WvdS.WebAPI.Data.Gateway.Api
</code>

**Health Check:**

<code bash>
curl http://localhost:5000/health
</code>

**First query:**

<code bash>
curl http://localhost:5000/api/v1/dsn/demo/tables
</code>

----

===== Prerequisites =====

| Component | Version | Check |
|-----------|---------|-------|
| .NET Runtime | 8.0+ | ''dotnet --version'' |
| OpenSSL | 3.0+ (for TLS) | ''openssl version'' |
| curl | any | ''curl --version'' |

----

===== Related Documentation =====

  * [[..:administrator:start|Administrator]] - Configuration & Architecture
  * [[..:entwickler:start|Developer]] - API Documentation
  * [[..:business:sicherheit:start|PQ Security]] - Post-Quantum Cryptography

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

{{tag>operator runbook data-gateway}}