|
| 1 | +--- |
| 2 | +layout: post |
| 3 | +title: Announcing puppet-openvoxdb |
| 4 | +date: 2026-03-25 |
| 5 | +github_username: d1nuc0m |
| 6 | +--- |
| 7 | + |
| 8 | +Today we launched [puppet/openvoxdb](https://forge.puppet.com/modules/puppet/openvoxdb/readme), a Puppet module to install OpenVoxDB! |
| 9 | + |
| 10 | +## What is OpenVoxDB? |
| 11 | + |
| 12 | +OpenVoxDB is the OpenVox fork of [PuppetDB](https://github.com/puppetlabs/puppetdb). |
| 13 | +It collects OpenVox agent run reports, that can then be queried using [PQL (Puppet Query Language)](https://help.puppet.com/pdb/current/topics/pql.htm). |
| 14 | + |
| 15 | +Collected data can also be visualized in a web dashboard like [Puppetboard](https://github.com/voxpupuli/puppetboard) or [OpenVox Gui](https://github.com/voxpupuli/openvoxview). There also are web dashboards outside of VoxPupuli, like [OpenVox Gui](https://github.com/cvquesty/openvox-gui) and [Pabawi](https://github.com/example42/pabawi). |
| 16 | + |
| 17 | +## What is puppet-openvoxdb? |
| 18 | + |
| 19 | +It is a fork of [puppetlabs/puppetdb](https://forge.puppet.com/modules/puppetlabs/puppetdb) adapted for OpenVoxDB: the main changes are the installed packages and parameters type validation. |
| 20 | +If you want to try OpenVoxDB or where already using PuppetDB and want to migrate - this module is for you. |
| 21 | +It automates OpenVoxDB install, PostgreSQL setup and OpenVox Server configuration so that clients interact with OpenVoxDB. |
| 22 | + |
| 23 | +### Migration from PuppetDB and/or puppetlabs-openvoxdb |
| 24 | + |
| 25 | +In a test environment you can just rename the classes from puppetdb to openvoxdb, type check the parameters, add the VoxPupuli repositories and it should work. |
| 26 | +However in production environments you are advised to migrate manually - and don't forget a backup. |
| 27 | + |
| 28 | +### Caveats |
| 29 | + |
| 30 | +* EL10 is not supported yet, due to lack of support in `puppetlabs/postgresql` |
| 31 | +* Migration from PuppetDB < 8.x is not supported yet. |
| 32 | + You should migrate first to PuppetDB < 8.x to PuppetDB 8.x, and from there to OpenVoxDB 8.x |
| 33 | + |
| 34 | +## Contribute |
| 35 | + |
| 36 | +There is still a lot of work to do for cleanup and optimization - you can find [voxpupuli/puppet-openvoxdb on GitHub](https://github.com/voxpupuli/puppet-openvoxdb/). |
| 37 | +Issues and PRs are welcome! |
0 commit comments