Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 26 additions & 26 deletions _data/nav/openvox_8x.yml
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
- text: Puppet 5 Platform
- text: OpenVox 8 Platform
items:
- text: Puppet release notes
- text: OpenVox release notes
link: "release_notes.html"
- text: Puppet known issues
- text: OpenVox known issues
link: "known_issues.html"
- text: System requirements
link: "system_requirements.html"
- text: Component versions in `puppet-agent`
- text: Component versions in `openvox-agent`
link: "about_agent.html"
- text: Puppet agent release notes
- text: OpenVox agent release notes
link: "release_notes_agent.html"
- text: Quick start guides
items:
Expand Down Expand Up @@ -37,33 +37,33 @@
link: "deprecated_settings.html"
- text: Installing and upgrading
items:
- text: Overview of Puppet's architecture
- text: Overview of OpenVox's architecture
link: "architecture.html"
- text: Pre-install tasks
link: "install_pre.html"
- text: Puppet Platform repositories
link: "puppet_platform.html"
- text: OpenVox Platform repositories
link: "openvox_platform.html"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This means there should be some file renamed, right?

- text: 'Install agent: Linux'
link: "install_linux.html"
- text: 'Install agent: Windows'
link: "install_windows.html"
- text: 'Install agent: macOS'
link: "install_osx.html"
- text: File location changes since Puppet 3.8.x
- text: File location changes since OpenVox 3.8.x
link: "whered_it_go.html"
- text: Pre-upgrade tasks from 3.8
link: "upgrade_major_pre.html"
- text: Upgrade agents from 3.8.x Puppet 5.x
- text: Upgrade agents from 3.8.x OpenVox 5.x
link: "upgrade_major_agent.html"
- text: Upgrade servers
link: "upgrade_major_server.html"
- text: Post-upgrade cleanup
link: "upgrade_major_post.html"
- text: 'Minor upgrades: From Puppet 4 and within Puppet 5.x'
- text: 'Minor upgrades: From OpenVox 4 and within OpenVox 5.x'
link: "upgrade_minor.html"
- text: Configuration
items:
- text: About Puppet's settings
- text: About OpenVox's settings
link: "config_about_settings.html"
- text: Short list of important settings
link: "config_important_settings.html"
Expand All @@ -75,7 +75,7 @@
link: "config_file_auth.html"
- text: 'fileserver.conf: Custom fileserver mount points'
link: "config_file_fileserver.html"
- text: 'puppetdb.conf: PuppetDB server locations'
- text: 'puppetdb.conf: OpenVoxDB server locations'
link: "config_file_puppetdb.html"
- text: 'hiera.yaml: Data lookup configuration'
link: "hiera_config_yaml_5.html"
Expand Down Expand Up @@ -133,27 +133,27 @@
link: "modules_metadata.html"
- text: Documenting modules
link: "modules_documentation.html"
- text: Puppet Strings
link: "puppet_strings.html"
- text: Puppet Strings style guide
link: "puppet_strings_style.html"
- text: OpenVox Strings
link: "openvox_strings.html"
- text: OpenVox Strings style guide
link: "openvox_strings_style.html"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same about files renamed

- text: Module cheat sheet
link: "cheatsheet_module.html"
- text: Puppet's services and tools
- text: OpenVox's services and tools
items:
- text: Puppet's commands
- text: OpenVox's commands
link: "services_commands.html"
- text: Running Puppet commands on Windows
- text: Running OpenVox commands on Windows
link: "services_commands_windows.html"
- text: The rack Puppet master
- text: The rack OpenVox master
link: "services_master_rack.html"
- text: Configuring a Server with Passenger and Apache
link: "passenger.html"
- text: The WEBrick Puppet master
- text: The WEBrick OpenVox master
link: "services_master_webrick.html"
- text: Puppet agent on *nix
- text: OpenVox agent on *nix
link: "services_agent_unix.html"
- text: Puppet agent on Windows
- text: OpenVox agent on Windows
link: "services_agent_windows.html"
- text: Puppet apply
Comment thread
tuxmea marked this conversation as resolved.
link: "services_apply.html"
Expand Down Expand Up @@ -413,7 +413,7 @@
link: "types/zone.html"
- text: zpool
link: "types/zpool.html"
- text: 'Reports: Tracking Puppet''s activity'
- text: 'Reports: Tracking OpenVox''s activity'
items:
- text: About reporting
link: "reporting_about.html"
Expand Down Expand Up @@ -563,7 +563,7 @@
link: "ssl_attributes_extensions.html"
- text: Regenerating all certificates in a deployment
link: "ssl_regenerate_certificates.html"
- text: Details about Puppet's internals
- text: Details about OpenVox's internals
items:
- text: Agent/master HTTPS communications
link: "subsystem_agent_master_comm.html"
Expand Down
27 changes: 12 additions & 15 deletions docs/_openvox_8x/about_agent.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,34 @@
---
layout: default
title: "Component versions in puppet-agent"
title: "Component versions in OpenVox-agent"
Copy link
Copy Markdown
Contributor

@jay7x jay7x Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should it be downcased?

---

[Facter]: {{facter}}/
[Hiera]: {{hiera}}/
[MCollective]: /mcollective/
[agent]: ./services_agent_unix.html
[apply]: ./services_apply.html
[Puppet Server]: {{puppetserver}}/
[release notes]: ./release_notes_agent.html

### Release contents of `puppet-agent` 5.x
### Release contents of `OpenVox-agent` 8.x
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should it be downcased?


See the table for details about which components shipped in which `puppet-agent` release, and the [package-specific release notes][release notes] for more information about packaging and installation fixes and features.
See the table for details about which components shipped in which `openvox-agent` release, and the [package-specific release notes][release notes] for more information about packaging and installation fixes and features.

> **Note:** [Hiera 5](./hiera_intro.html) is a backward-compatible evolution of Hiera, which is built into Puppet. To provide some backward-compatible features, it uses the classic Hiera 3 codebase. This means "Hiera" is still shown as version 3.x in the table above, even though this Puppet version uses Hiera 5.
### What `openvox-agent` and OpenVox Server are

### What `puppet-agent` and Puppet Server are
We distribute OpenVox as two core packages.

We distribute Puppet as two core packages.

- `puppet-agent` --- This package contains Puppet's main code and all of the dependencies needed to run it, including [Facter][], [Hiera][], and bundled versions of Ruby and OpenSSL. It also includes [MCollective][]. Once it's installed, you have everything you need to run [the Puppet agent service][agent] and the [`puppet apply` command][apply].
- `puppetserver` --- This package depends on `puppet-agent`, and adds the JVM-based [Puppet Server][] application. Once it's installed, Puppet Server can serve catalogs to nodes running the Puppet agent service.
- `openvox-agent` --- This package contains OpenVox's main code and all of the dependencies needed to run it, including [Facter][], [Hiera][], and bundled versions of Ruby and OpenSSL. Once it's installed, you have everything you need to run [the OpenVox agent service][agent] and the [`puppet apply` command][apply].
- `openvox-server` --- This package depends on `openvox-agent`, and adds the JVM-based [OpenVox Server][] application. Once it's installed, OpenVox Server can serve catalogs to nodes running the OpenVox agent service.

### How version numbers work

Puppet Server is a separate application that, among other things, runs instances of the Puppet master application. It has its own version number separate from the version of Puppet it runs and may be compatible with more than one existing Puppet version.
OpenVox Server is a separate application that, among other things, runs instances of the OpenVox server application. It has its own version number separate from the version of OpenVox it runs and may be compatible with more than one existing OpenVox version.

The `puppet-agent` package also has its own version number, which doesn't necessarily match the version of Puppet it installs.
The `openvox-agent` package also has its own version number, which doesn't necessarily match the version of OpenVox it installs.

Order is important in the upgrade process. First, update Puppet Server, then you update `puppet-agent`. If you upgrade Puppet Server or PuppetDB to version 5, if you're on the master it will automatically upgrade the `puppet-agent` package to Puppet agent 5.0.0 or newer. Puppet Server 5 will also prevent you from installing anything lower than `puppet-agent` 5.0.0 on your agent nodes.
Order is important in the upgrade process. First, update OpenVox Server, then you update `openvox-agent`. If you upgrade OpenVox Server or OpenVoxDB to version 8, if you're on the master it will automatically upgrade the `openvox-agent` package to OpenVox agent 8.0.0 or newer. OpenVox Server 8 will also prevent you from installing anything lower than `openvox-agent` 8.0.0 on your agent nodes.

Since the `puppet-agent` package distributes several different pieces of software, its version number will frequently increase when Puppet's version does not --- for example, `puppet-agent` 1.2.0 and 1.2.1 shipped the same Puppet version but different Facter versions. Similarly, new versions of Puppet Server usually don't require updates to the core Puppet code.
Since the `openvox-agent` package distributes several different pieces of software, its version number will frequently increase when OpenVox's version does not --- for example, `openvox-agent` 8.25.0 shipped the same OpenVox version but different Facter versions. Similarly, new versions of OpenVox Server usually don't require updates to the core OpenVox code.

This versioning scheme helps us avoid a bunch of "empty" Puppet releases where the version number increases without any changes to Puppet itself.
This versioning scheme helps us avoid a bunch of "empty" OpenVox releases where the version number increases without any changes to OpenVox itself.
Loading
Loading