From 9c0a5eb0ad2f5a7e16add8d93bef403c4b6fa120 Mon Sep 17 00:00:00 2001 From: Michael Harp Date: Tue, 5 May 2026 07:10:34 -0400 Subject: [PATCH 1/3] Replace openvox-server index with modern landing page Removes the legacy Puppet Server table-of-contents page and replaces it with a concise landing page matching the style of the openvox agent index: short description, how it works, getting started path, and community link. Fixes broken links (puppetserver_vs_passenger.html missing, external_ca_configuration.html missing), removes Puppet Enterprise note, removes stale canonical pointing to /puppetserver/latest/, and removes all "Puppet Server" branding. Closes #150 Co-Authored-By: Claude Sonnet 4.6 Signed-off-by: Michael Harp --- docs/_openvox-server_8x/index.markdown | 76 +++++++------------------- 1 file changed, 21 insertions(+), 55 deletions(-) diff --git a/docs/_openvox-server_8x/index.markdown b/docs/_openvox-server_8x/index.markdown index 9172e9af8..bb785ae38 100644 --- a/docs/_openvox-server_8x/index.markdown +++ b/docs/_openvox-server_8x/index.markdown @@ -1,61 +1,27 @@ --- layout: default -title: "Puppet Server: Index" -canonical: "/puppetserver/latest/" +title: "OpenVox Server 8" --- -Puppet Server is the next-generation application for managing Puppet agents. +OpenVox Server is the primary server component in an OpenVox agent/server deployment. +It compiles configuration catalogs for managed nodes, serves files, manages certificates, +and receives reports from agents. +It is a Ruby and Clojure application that runs on the Java Virtual Machine (JVM). -> **Note:** For information about configuring and tuning settings specific to [Puppet Enterprise](https://puppet.com/docs/pe/), see -> [its documentation](https://puppet.com/docs/pe/latest/configuring/config_puppetserver.html). +## How it works -- [**About OpenVox Server**](./services_puppetserver.html) - - [Release notes](./release_notes.html) - - [Deprecated features](./deprecated_features.html) - - [Notable differences vs. the Apache/Passenger stack](./puppetserver_vs_passenger.html) - - [Compatibility with Puppet agent](./compatibility_with_puppet_agent.html) -- [**Installing Puppet Server**](./install_from_packages.html) -- [**Configuring Puppet Server**](./configuration.html) - - [global.conf](./config_file_global.html) - - [webserver.conf](./config_file_webserver.html) - - [web-routes.conf](./config_file_web-routes.html) - - [puppetserver.conf](./config_file_puppetserver.html) - - [auth.conf](./config_file_auth.html) - - [Migrating deprecated authentication rules](./config_file_auth_migration.html) - - [metrics.conf](./config_file_metrics.html) - - [logback.xml](./config_file_logbackxml.html) - - [Advanced logging configuration](./config_logging_advanced.html) - - [master.conf](./config_file_master.html) (deprecated) - - [ca.conf](./config_file_ca.html) - - [Differing behavior in puppet.conf](./puppet_conf_setting_diffs.html) -- **Using and extending Puppet Server** - - [Subcommands](./subcommands.html) - - [Using Ruby gems](./gems.html) - - [Using an external certificate authority](./external_ca_configuration.html) - - [External SSL termination](./external_ssl_termination.html) - - [Monitoring Puppet Server metrics](./puppet_server_metrics.html) - - [HTTP client metrics](./http_client_metrics.html) - - [Tuning guide](./tuning_guide.html) - - [Applying metrics to improve performance](./puppet_server_metrics_performance.html) - - [Scaling Puppet Server](./scaling_puppet_server.html) - - [Restarting Puppet Server](./restarting.html) -- **Known issues and workarounds** - - [Known issues](./known_issues.html) - - [SSL problems with load-balanced PuppetDB servers ("Server Certificate Change" error)](./ssl_server_certificate_change_and_virtual_ips.html) -- **Administrative API endpoints** - - [Environment cache](./admin-api/v1/environment-cache.html) - - [JRuby pool](./admin-api/v1/jruby-pool.html) -- **Server-specific Puppet API endpoints** - - [Environment classes](./puppet-api/v3/environment_classes.html) - - [Environment modules](./puppet-api/v3/environment_modules.html) - - [Static file content](./puppet-api/v3/static_file_content.html) -- **Status API endpoints** - - [Status services](./status-api/v1/services.html) - - [Simple status](./status-api/v1/simple.html) -- **Metrics API endpoints** - - [v1 metrics](./metrics-api/v1/metrics_api.html) - - [v2 (Jolokia) metrics](./metrics-api/v2/metrics_api.html) -- **Developer information** - - [Debugging](./dev_debugging.html) - - [Running from source](./dev_running_from_source.html) - - [Tracing code events](./dev_trace_func.html) +OpenVox agents periodically contact OpenVox Server over mutual-TLS HTTPS. +The server compiles a node-specific catalog from Puppet code and Hiera data, returns it +to the agent for enforcement, and collects the resulting report. +It also runs a built-in certificate authority for signing agent certificates. + +For a full description of the service and its internal components, see +[About OpenVox Server](./services_puppetserver.html). + +## Getting started + +1. Review [pre-install tasks](install_pre.html) — system requirements, DNS, firewall, and time synchronization +2. [Install OpenVox Server](install_from_packages.html) +3. [Configure OpenVox Server](configuration.html) + +For community help and support resources, see the [Vox Pupuli support page](https://voxpupuli.org/openvox/support/). From caa09863a22c0b7a1f20534cd61661c0e7bb44ab Mon Sep 17 00:00:00 2001 From: Michael Harp Date: Tue, 5 May 2026 07:16:53 -0400 Subject: [PATCH 2/3] Modernize openvox-server nav: remove Index entry, rebrand labels MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Remove explicit "Index" nav entry (landing page accessed via top nav) - Rename "About Puppet Server" → "About OpenVox Server", pointing to services_puppetserver.html (created in PR #151) - Rebrand "Configuring/Using and extending Puppet Server" section headings - Fix broken external_ca_configuration.html link (file does not exist); remove the duplicate nav entry since "Intermediate CA" already covers it - Fix "External SSL germination" typo → "External SSL termination" - Update remaining "Puppet Server" labels to "OpenVox Server" Co-Authored-By: Claude Sonnet 4.6 Signed-off-by: Michael Harp --- _data/nav/openvox-server_8x.yml | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/_data/nav/openvox-server_8x.yml b/_data/nav/openvox-server_8x.yml index ba959dbf6..d54c08062 100644 --- a/_data/nav/openvox-server_8x.yml +++ b/_data/nav/openvox-server_8x.yml @@ -1,6 +1,4 @@ --- -- text: Index - link: index.html - text: About OpenVox Server link: services_puppetserver.html - text: Release notes @@ -19,11 +17,11 @@ link: install_what_and_where.html - text: Upgrading OpenVox Server link: upgrade_minor.html -- text: Configuring Puppet Server +- text: Configuring OpenVox Server items: - - text: Configuring Puppet Server + - text: Configuring OpenVox Server link: configuration.html - - text: 'Main Puppet Server configurations: puppetserver.conf' + - text: 'Main OpenVox Server configurations: puppetserver.conf' link: config_file_puppetserver.html - text: 'Global settings: global.conf' link: config_file_global.html @@ -41,27 +39,25 @@ link: config_logging_advanced.html - text: 'CA service: ca.conf' link: config_file_ca.html - - text: Puppet Server use of puppet.conf settings + - text: OpenVox Server use of puppet.conf settings link: puppet_conf_setting_diffs.html - text: 'Configuring product-level interactions (optional): product.conf' link: config_file_product.html - text: Bootstrap upgrade notes link: bootstrap_upgrade_notes.html -- text: Using and extending Puppet Server +- text: Using and extending OpenVox Server items: - text: Using Ruby gems link: gems.html - text: Subcommands link: subcommands.html - - text: Using an external certificate authority - link: external_ca_configuration.html - text: Infrastructure CRL link: infrastructure_crl.html - text: Intermediate CA link: intermediate_ca.html - - text: External SSL germination + - text: External SSL termination link: external_ssl_termination.html - - text: Restarting Puppet server + - text: Restarting OpenVox Server link: restarting.html - text: Tuning, troubleshooting, and known issues items: @@ -70,7 +66,7 @@ - text: SSL problems with load-balanced PuppetDB servers ("Server Certificate Change" error) link: ssl_server_certificate_change_and_virtual_ips.html - - text: Puppet Server tuning guide + - text: OpenVox Server tuning guide link: tuning_guide.html - text: Migrating to the HOCON auth.conf format link: config_file_auth_migration.html From ebac153e04be27851fa2d137430f9bc556c80ee0 Mon Sep 17 00:00:00 2001 From: Michael Harp Date: Wed, 6 May 2026 06:23:10 -0400 Subject: [PATCH 3/3] Add Core packages section to openvox-server landing page Modeled on the openvox agent index, noting the Java 17/21 requirement and that a JDK is not bundled. Signed-off-by: Michael Harp --- docs/_openvox-server_8x/index.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/_openvox-server_8x/index.markdown b/docs/_openvox-server_8x/index.markdown index bb785ae38..e3a1cceae 100644 --- a/docs/_openvox-server_8x/index.markdown +++ b/docs/_openvox-server_8x/index.markdown @@ -18,6 +18,12 @@ It also runs a built-in certificate authority for signing agent certificates. For a full description of the service and its internal components, see [About OpenVox Server](./services_puppetserver.html). +## Core packages + +| Package | Contents | +| ------- | -------- | +| `openvox-server` | JVM-based catalog server; depends on `openvox-agent`. Requires Java 17 or 21 (not bundled). | + ## Getting started 1. Review [pre-install tasks](install_pre.html) — system requirements, DNS, firewall, and time synchronization