Skip to content

Commit 13c5caa

Browse files
miharpclaude
andcommitted
Address tuxmea review comments on OpenFact landing page
- Drop legacy facts note (mixed two separate deprecations) - Clarify resolution selection: highest-weighted wins (verified in source) - Separate facts vs. report storage: facts are not persisted without OpenVoxDB; only reports go to local disk by default - Fix cross-collection link: remove ../ prefix on about_agent.html Signed-off-by: Michael Harp <mike@mikeharp.com> Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 51e726c commit 13c5caa

1 file changed

Lines changed: 7 additions & 10 deletions

File tree

docs/_openfact_5x/index.md

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,6 @@ structured data about a node's operating system, hardware, networking, and more.
88
in OpenVox manifests as top-scope variables (e.g. `$facts['os']['family']`) and are used by the
99
catalog compiler to make node-specific decisions.
1010

11-
> **Note:** Legacy flat facts (e.g. `$::osfamily`) are hidden from `facter`'s default CLI output
12-
> and are not collected or sent to OpenVox Server in OpenVox 8. From the CLI you can still view
13-
> them with `facter --show-legacy`. In the agent, they can be re-enabled by setting
14-
> `include_legacy_facts=true` in the agent's `puppet.conf`, but this is not recommended.
15-
> Use the structured `$facts` hash instead.
16-
1711
OpenFact is the community-maintained continuation of Puppet's Facter, originally adopted under
1812
[Vox Pupuli](https://voxpupuli.org/) stewardship alongside OpenVox. It is downstream-compatible
1913
with Facter — existing custom facts and external facts work unchanged.
@@ -23,11 +17,14 @@ with Facter — existing custom facts and external facts work unchanged.
2317
OpenFact runs on each managed node and resolves facts by querying the system directly: reading
2418
`/proc` entries, running shell commands, calling OS APIs, and so on. Results are returned as a
2519
structured hash. When a fact can be resolved in multiple ways (for example, differently on Linux
26-
versus Windows), OpenFact picks the first applicable resolution and discards the rest.
20+
versus Windows), OpenFact runs the highest-weighted applicable resolution.
2721

2822
**In an agent/server deployment**, OpenFact runs automatically at the start of each agent run.
29-
The collected facts are sent to OpenVox Server, where they are available to the catalog compiler
30-
and stored for reporting.
23+
The collected facts are sent to OpenVox Server and made available to the catalog compiler.
24+
Facts are not persisted without OpenVoxDB — they are used during catalog compilation and then
25+
discarded. The agent run produces a report, which OpenVox Server stores on local disk by default;
26+
without periodic cleanup, report storage will grow unbounded. OpenVoxDB is an optional component
27+
that provides durable storage for facts, catalogs, and reports.
3128

3229
**Standalone**, the `facter` CLI lets you query facts directly on any node — useful for
3330
ad-hoc inspection, debugging, or scripting without triggering a full agent run.
@@ -36,7 +33,7 @@ ad-hoc inspection, debugging, or scripting without triggering a full agent run.
3633

3734
OpenFact ships inside the `openvox-agent` package and does not need to be installed separately.
3835
The version bundled with a given agent release is listed in
39-
[Component versions in openvox-agent](../../openvox/latest/about_agent.html).
36+
[Component versions in openvox-agent](/openvox/latest/about_agent.html).
4037

4138
## Getting started
4239

0 commit comments

Comments
 (0)