Skip to content

VoxDocs 2.0.0 — OpenVox Project Alignment

Choose a tag to compare

View all tags
@cvquesty cvquesty released this 27 Apr 14:14
· 11 commits to development since this release
v2.0.0
451d0a9

VoxDocs 2.0.0 — OpenVox Project Alignment

VoxDocs 2.0 brings the community documentation into alignment with the official OpenVox documentation project and the platform's current state on RHEL 9.7.

Why a Major Version?

The conceptual framing of the project has shifted enough that returning readers will encounter new terminology and a restructured introduction:

  • The OpenVox team has rebranded several core components. Facter is now OpenFact, PuppetDB is now OpenVoxDB, and Bolt is now OpenBolt. Binary names (facter, puppetdb, bolt) and config files (facter.conf) are unchanged — only project/package names changed.
  • The official origin story has been refined. It now credits Overlook InfraTech for stepping in with community packaging when Perforce discontinued public distribution of open-source Puppet in late 2024, before Vox Pupuli adopted the project.
  • A Puppet Standards Steering Committee now guides language and feature evolution.
  • The documented package set has expanded to include openvoxdb, openvoxdb-termini, and openbolt as first-class members.

No documentation files were removed. Users on v1.x can continue using v1.1.0 as a snapshot reference.

Highlights

Version bumps (all verified against the live RHEL 9.7 lab)

Component v1.x v2.0.0
openvox-agent 8.25.0 8.26.2
OpenVox Server 8.12.1 8.12.1 (unchanged)
OpenFact (was Facter) 5.4.0 5.6.0
OpenBolt (was Bolt) 5.3.0 5.4.0
r10k 5.0.2 5.0.2 (unchanged)

New & expanded sections

  • README — new "A Brief History" section covering the Perforce → Overlook InfraTech → Vox Pupuli timeline; expanded versions table with package paths; Windows / macOS download URLs; links to the official Installing OpenVox and Support pages and the official docs repo.
  • Getting Started — new "Windows and macOS Agents" subsection; new "Full OpenVox Package Set" subsection covering openvox-agent, openvox-server, openvoxdb, openvoxdb-termini, openbolt; verification snippets for OpenFact and PuppetServer.
  • Migration Guide — new "Two migration paths" callout (Puppet 7 → OpenVox 7 → OpenVox 8 vs. Puppet 7 → Puppet 8 → OpenVox 8); new "Upgrade Order" subsection (server → openvoxdb → termini → agent); explicit warning that Puppet and OpenVox cannot coexist on the same host.
  • Architecture — branding callouts in the PuppetDB and Facter sections explaining the OpenVoxDB / OpenFact rename; OpenFact, OpenVoxDB, and OpenBolt added to the glossary.
  • CLI Reference — version banner now enumerates the actual lab package set; refreshed puppet --help, puppet --version, bolt --version, and facter --version captures from the live lab; OpenVoxDB row added to the Server & Infrastructure table.
  • Server Admin — PostgreSQL recommendation bumped to PostgreSQL 14+ (still requires 11+) with PGDG repo links, matching official OpenVoxDB 8 guidance.
  • Troubleshooting — new FAQ entry for the cosmetic puppet --version reporting bug in OpenVox 8.26.2 (OpenVoxProject/openvox#415).
  • Community — acknowledgments expanded to call out Overlook InfraTech's role and the Puppet Standards Steering Committee.
  • Orchestration — openbolt documented as the preferred package name alongside the legacy puppet-bolt.

Known issue documented

OpenVox 8.26.2 has a cosmetic bug where puppet --version reports 8.26.1. The agent itself is at the correct version — this affects the version string only. Tracked at OpenVoxProject/openvox#415. Verify the real package version with rpm -q openvox-agent or dpkg -l openvox-agent.

Diff stats

14 files changed, +218 / -27.

License

CC BY-SA 4.0. Original community-written work; no Perforce/Puppet documentation copied. All CLI output captured from a live RHEL 9.7 OpenVox lab.

Built with coffee, sudo access, and mild frustration by the community.

Assets 2
Loading