From 08ba714ea94370e89bc99baba5ba7c2a1c833a57 Mon Sep 17 00:00:00 2001 From: Adam Williamson Date: Oct 24 2025 22:29:19 +0000 Subject: openQA sysadmin guide: add note about qemu capability issue We currently have to give the qemu executable a special capability for the tap tests to work. Updating the qemu packages wipes this capability, then all the tap tests start failing. You have to run the playbook again to re-set the capability. Document this. I tried to find a way to use the qemu bridge helper to avoid the need for the capability, but could not. Signed-off-by: Adam Williamson --- diff --git a/modules/sysadmin_guide/pages/openqa.adoc b/modules/sysadmin_guide/pages/openqa.adoc index 2fb8109..0eaba0e 100644 --- a/modules/sysadmin_guide/pages/openqa.adoc +++ b/modules/sysadmin_guide/pages/openqa.adoc @@ -345,6 +345,14 @@ If many tests are failing early with errors suggesting they can't find required files, check for failed services on the worker hosts. Sometimes the NFS mount service fails and needs restarting. +=== Tests failing early, complaining "could not configure /dev/net/tun (tapXX): Operation not permitted" + +Run `rbac-playbook groups/openqa-workers.yml -t openqa_worker`. Limit +it to the specific affected hosts if you like. This happens when the +qemu package is updated and `/usr/bin/qemu-system-` loses the +capabilities it needs to configure tap devices (which are set in the +playbook). + === Disk space issues: server local root If a server is running out of space on its local root partition, the