KVM commissioning sheet

Site: __________________ Date: __________ Engineer: __________________

Role	Value
KVM host	Ubuntu 24.04 ☐
Guest IP (br0/DHCP)	__________________
GPUs (BDF / model)	__________________
Guest build (`pixop-version`)	__________________
SRT gateway (active / standby)	__________________

Workflow (before test):

	Expected
Input (resolution, codec, frame rate, HDR/SDR)	__________________
Processing (e.g. upscale factor, tone mapping)	__________________
Output (resolution, codec, frame rate, HDR/SDR)	__________________

Delivery: sha256sum -c QCOW2 ☐ installer archive ☐ · scripts/ at extract root ☐

Host

Step	Pass	Notes
`cd` extract root; `sudo ./scripts/pixop-install doctor` — no FAIL	☐
`install --dry-run` then `install` with `--bridge br0`, `--gpu`, license	☐	VM not autostarted at install
`start` + `status` — VFIO on GPUs	☐
`license status` — file hash OK	☐

Guest health

Step	Pass	Notes
SSH + `pixop-preflight` exit 0	☐
`nvidia-smi` — passed GPUs	☐
`pixop-stack status` — pair up	☐
`tsduckctl credentials` secured	☐

Live pipeline (continuous input ≥ 2 min)

Step	Pass	Notes
Caller → ingest UDP 5000	☐
`pixop-flow` — traffic through stages (traffic only)	☐
Caller egress UDP 5001 — processed TS	☐
Decoder/analyzer: continuous video (no bypass); continuous audio when workflow expects it	☐
Valid geometry, scale, codec, fps, bitrate, HDR/SDR vs workflow table	☐
No A/V stalls; visual compare if required	☐
`curl -sS http://127.0.0.1:8080/v1/metrics` (on guest) rates move	☐

Optional (if in scope)

Step	Pass	Notes
`sudo ./scripts/pixop-install restart` — guest recovers	☐
`autostart enable` then host reboot — domain returns	☐
Standby gateway path (external failover)	☐

Acceptance: Host + guest health + live pipeline rows pass ☐ Sign-off: __________________

Rollback: stop → uninstall (keeps disk); --purge only with backup. Escalate: status, pixop-version, license hashes, journalctl -u pixop-live (no secrets).

Guides: KVM deployment guide · KVM troubleshooting guide