DocsServers and Sensor
Install Checks
What Frabs checks on every server before you confirm.
Every install runs the same fixed checks, from the facts the sensor reported. Each shows passed, warning, note or failed on the review screen; open the ⓘ for the detail. A failed check blocks confirming.
The checks
| Check | What it proves | If it does not pass |
|---|---|---|
| Platform identified | A supported platform was found | Failed: nothing to attach to |
| Guest list read | Each platform's own guest list was read successfully, even if it is empty | Failed: the reason is shown (for example /etc/pve not mounted). Fix it, then Reconnect |
| Guests found | VMs and containers, counted separately | Shown for you to compare with what you run |
| Leftover configs ignored | Old configs that are not guests here (for example stale /var/lib/lxc on Proxmox) were not counted | Note only |
| Running guests with an interface | Every running guest has a network interface on the host | Warning: those guests cannot be watched until one appears |
| NICs the host cannot see | No passthrough, SR-IOV, macvlan or direct NICs | Warning: traffic on those NICs bypasses the host and cannot be watched or limited |
| Only VM interfaces watched | No bridge, bond, VLAN or uplink is on the watch list | Failed: the plan is rejected |
| Interfaces without a known guest | Every VM-like interface belongs to a known guest | Warning: traffic is counted, but no automatic action is ever taken against it |
| Routed containers (venet0) | Legacy OpenVZ containers share venet0 | Note: matched by each container's own IPs |
| Open vSwitch | OVS is in use | Warning: check every VM port is listed |
| Cluster / pool | This server's cluster and its other nodes | Note: install Frabs on every node with customer guests |
| Panel backend | For Virtualizor, VirtFusion and SolusVM, guests are read from the hypervisor underneath, not the panel | Note |
| Kernel support | The nftables hooks the sensor needs (Linux 4.2+) | Failed: upgrade the kernel |
What each platform must prove
| Platform | Checked |
|---|---|
| Proxmox VE | Proxmox's own guest list for this node (even if empty); VMs and containers apart; stale LXC ignored; cluster known; each guest's tap or veth on its bridge |
| libvirt | virsh answered; each VM by its UUID; interfaces from libvirt's live state; passthrough and SR-IOV flagged |
| VirtFusion, Virtualizor, SolusVM | The hypervisor underneath read (libvirt, Xen or OpenVZ); each VPS matched to a running guest on this node |
| OpenVZ | vzlist answered; bridged and routed containers told apart |
| Virtuozzo | prlctl answered for VMs and containers; NICs matched by MAC |
| LXC | Each container from lxc-ls confirmed by lxc-info; leftovers ignored |
| LXD, Incus | The API answered; macvlan, SR-IOV, physical and OVN NICs flagged |
| Xen, XCP-ng | xl answered; each domain by its UUID (domain IDs change on restart); vif interfaces found |