Files
cairnobs/deploy/windows
jcoffey-dev 39ba6105f4
ci / check (pull_request) Successful in 5m5s
ci / postgres (pull_request) Successful in 9m50s
Windows: a Hyper-V host's VMs, like libvirt's
Each report a Windows agent asks WMI's root\virtualization\v2 for every
VM's state and health, BIOS GUID, generation, vCPUs, memory and automatic
start action: COM through x/sys/windows, no cgo, no new dependency. They're
the host's VMs on its page and in workloads, judged as libvirt's are, and an
agent inside one links to it by the BIOS GUID.

Hyper-V shows VMs only to Administrators and Hyper-V Administrators, a group
that can also change them, so the agent isn't added on its own: without it,
the host page and a warning say so and docs/windows.md says how to add it or
set hyperv: false.

Tested on Windows Server 2025 with Hyper-V nested under KVM, both ways.
2026-11-15 03:25:13 -07:00
..
2026-11-14 21:42:10 -07:00

Cairn OBS agent for Windows

Reports this host's health to Cairn OBS (obs-beacond): CPU, memory,
volumes, network, uptime and the Windows services you name.

Install, in PowerShell as Administrator, from this folder:

  .\obs-beacon-agent.exe service install

That copies the agent to C:\Program Files\Cairn OBS, registers the
obs-beacon-agent service (automatic start, restarted if it fails, running as
its own account NT SERVICE\obs-beacon-agent with no administrator rights) and
makes C:\ProgramData\obs-beacon for its config and state. Then either join
with a token from Hosts, Add host:

  & "C:\Program Files\Cairn OBS\obs-beacon-agent.exe" join <token>
  Start-Service obs-beacon-agent

or write C:\ProgramData\obs-beacon\agent.yaml from agent.example.yaml and
start the service. Its log is in the Application event log, source
obs-beacon-agent.

Upgrade: run `service install` from the new zip; it stops the service,
replaces the program and starts it again. Remove: `service uninstall`
(the config and state in ProgramData are kept).

Licensed under the GNU Affero General Public License v3 or later
(LICENSE.txt); the components it's built from are in THIRD_PARTY_NOTICES.md.