Qudata Agent
How Agent manages instances, which technologies it uses, and how to monitor it.
Qudata Agent is a system service that manages instance lifecycle on node.
It runs in background, communicates with platform, and ensures correct task startup, execution, and completion.
Isolation technologies
Agent uses proven open-source virtualization stack:
QEMU/KVM - hardware virtualization. Each instance is a full VM isolated from host and from other instances.
VFIO (PCI passthrough) - GPU is passed directly to VM. During task execution, host cannot access GPU context or VRAM content.
NVIDIA drivers must not be installed on host. They are installed only inside VM. Host drivers block GPU passthrough.
Instance lifecycle
- Platform sends start command.
- Agent prepares environment and allocates resources.
- GPU switches to passthrough mode and is assigned to VM.
- VM starts and runs user workload.
- After completion, VM stops, GPU returns to host, resources are released.
If any stage fails, Agent performs automatic rollback and restores consistent node state.
Monitoring
Agent runs as systemd service. Main commands:
# Status
systemctl status qudata-agent
# Real-time logs
journalctl -u qudata-agent -f
# Restart (maintenance window only)
systemctl restart qudata-agent