Hypervisors

A hypervisor is a managed node. It is created by importing a Proxmox node or by enrolling a native KVM agent.

Status

Status	Meaning
online	Heartbeats/health fresh.
degraded	Recent transient failures or missed heartbeats.
offline	No heartbeat beyond the threshold. Running guests are not assumed dead.
maintenance	Excluded from new placements; existing guests keep running.

Capacity and capabilities

Each hypervisor reports CPU threads, memory and storage, and a set of capabilities derived from the provider or agent (KVM, QEMU, snapshots, cloud-init, live migration, storage types, console flags). Unknown capabilities are treated as unavailable.

Maintenance mode

Enter maintenance to stop new placements without stopping guests:

• Admin API: POST /api/application/pterocloud/hypervisors/{uuid}/maintenance.
• Exit with DELETE on the same path.

Evacuate guests first if you intend to service the node; see Node evacuation.

Native agent health

For native hosts, an offline agent does not imply the host is down. The panel reports the last-seen time and never fabricates a live check. See Native KVM readiness.

Commands

php artisan pterocloud:hypervisors
php artisan pterocloud:diagnose:hypervisor <uuid> --json

Related

• Scheduler
• Migration
• PC-KVM-### in the error reference