Add OpenVox Server 9.x docs collection as a preview (latest stays on 8.x) - #457
Open
miharp wants to merge 1 commit into
Open
Add OpenVox Server 9.x docs collection as a preview (latest stays on 8.x)#457miharp wants to merge 1 commit into
miharp wants to merge 1 commit into
Conversation
This was referenced Aug 27, 2026
miharp
force-pushed
the
docs/openvox-server9-cutover
branch
from
August 27, 2026 13:37
4d014a1 to
6afdf23
Compare
miharp
added a commit
to miharp/openvox-docs
that referenced
this pull request
Aug 27, 2026
Add an upgrade-planning page to the 9.x collection covering what to review before moving a production deployment from OpenVox 8 to 9, alongside the existing package-mechanics page (upgrade_minor): - Component version table: Ruby 3.2 -> 4.0, OpenSSL 3.0 -> 3.5, OpenFact 5.x -> 6.x, JRuby 9.4 -> 10.1, Java 21/25 (17 dropped) - Ruby 4.0 review guidance for custom facts, functions, types, providers, and agent/server-installed gems - Behavior changes verified against the 9.0.0 prerelease sources: deferred functions preprocessed by default again (openvox#462), reports default store -> none (openvox#583), and the server setting fallback deprecation (openvox#536 - root agents still fall back with a warning, non-root runs fail; the code keeps the root fallback in beta2, so the page documents the deprecation rather than a hard removal) - Removed settings (configprint, pluginsync, data_binding_terminus, environment_data_provider) and other removals (regsubst encoding argument, pe_serverversion fact, zone_core module, Java keystores, legacy PAL APIs) - Server/OpenVoxDB notes: Java 17 dropped, Jetty 12, OpenVoxDB Debian 11/12 packages discontinued, openvox-server 9 requires openvox-agent 9 on the same host - Test-then-upgrade checklist and upgrade order Also add the nav entry and cross-link the page from the breaking- changes callout in upgrade_minor. Updated after the server, OpenVoxDB, and OpenFact 6 preview cutovers (OpenVoxProject#457, OpenVoxProject#458, OpenVoxProject#459): per-component release-notes links, OpenVox Server 9 also dropping Debian 11/12 and Amazon Linux 2, the OpenVox Server 9 filebucket read-authorization change (openvox-server#549), the OpenVoxDB bootstrap.cfg jetty10-service pitfall for upgrades from 8.14.0 or earlier, the PostgreSQL 14 minimum, and the concrete OpenFact 6 changes that affect fact code. Part of OpenVoxProject#456 Co-authored-by: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: Michael Harp <mike@mikeharp.com>
…8.x) Phase 1 of the major-version cutover in MAINTAINING.md for OpenVox Server: copy docs/_openvox-server_8x to docs/_openvox-server_9x, register the collection, nav map, product bar entry, and products.yml version (no reference pin; the collection is authored-only), and leave `latest` on 8.x until 9.0.0 ships. Authored content updated for the 9.0.0 prerelease series (beta1 to beta5): - index: title, prerelease notice, Java 21 or 25, openvox-agent 9.x dependency - install_pre: platform tables from the shared-actions main platform list (Debian 11/12 and Amazon Linux 2 dropped), Java 21 or 25 with 17 unsupported, note that the package pulls in openvox-agent 9.x - install_from_packages: openvox9 release packages - services_puppetserver: Java requirement and 9.x/9.x compatibility line - dev_running_from_source: Java 21 or 25, Ruby 3.2 for the source agent - config_file_auth and http_file_bucket_file: the 9.0 default auth.conf restricts filebucket GET/POST to pp_cli_auth certificates (openvox-server#549) - release_notes: rewritten for the 9.0.0 beta series - API pages that pinned /openvox/8.x/ now point at /openvox/9.x/, and the four hardcoded /openvox-server/latest/ links are relative so the frozen copy stays internally coherent Also, from the visual review: install_pre's DNS step now reflects the OpenVox 9 change that agents no longer fall back to the hostname `puppet` (matching the core 9.x page), and the puppet-api/v3/file_content page gets its unclosed heading backtick and missing sentence period fixed in both 8.x and 9.x. Config templates shipped in 8.15.2 and 9.0.0-beta5 differ only in the auth.conf filebucket rules, so the configuration pages are otherwise unchanged. Known issues and deprecated features are unchanged: the certificate-status settings still exist in 9. Part of OpenVoxProject#456 Co-authored-by: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: Michael Harp <mike@mikeharp.com>
miharp
force-pushed
the
docs/openvox-server9-cutover
branch
from
August 27, 2026 21:53
6afdf23 to
464a6cb
Compare
miharp
added a commit
to miharp/openvox-docs
that referenced
this pull request
Aug 27, 2026
Add an upgrade-planning page to the 9.x collection covering what to review before moving a production deployment from OpenVox 8 to 9, alongside the existing package-mechanics page (upgrade_minor): - Component version table: Ruby 3.2 -> 4.0, OpenSSL 3.0 -> 3.5, OpenFact 5.x -> 6.x, JRuby 9.4 -> 10.1, Java 21/25 (17 dropped) - Ruby 4.0 review guidance for custom facts, functions, types, providers, and agent/server-installed gems - Behavior changes verified against the 9.0.0 prerelease sources: deferred functions preprocessed by default again (openvox#462), reports default store -> none (openvox#583), and the server setting fallback deprecation (openvox#536 - root agents still fall back with a warning, non-root runs fail; the code keeps the root fallback in beta2, so the page documents the deprecation rather than a hard removal) - Removed settings (configprint, pluginsync, data_binding_terminus, environment_data_provider) and other removals (regsubst encoding argument, pe_serverversion fact, zone_core module, Java keystores, legacy PAL APIs) - Server/OpenVoxDB notes: Java 17 dropped, Jetty 12, OpenVoxDB Debian 11/12 packages discontinued, openvox-server 9 requires openvox-agent 9 on the same host - Test-then-upgrade checklist and upgrade order Also add the nav entry and cross-link the page from the breaking- changes callout in upgrade_minor. Updated after the server, OpenVoxDB, and OpenFact 6 preview cutovers (OpenVoxProject#457, OpenVoxProject#458, OpenVoxProject#459): per-component release-notes links, OpenVox Server 9 also dropping Debian 11/12 and Amazon Linux 2, the OpenVox Server 9 filebucket read-authorization change (openvox-server#549), the OpenVoxDB bootstrap.cfg jetty10-service pitfall for upgrades from 8.14.0 or earlier, the PostgreSQL 14 minimum, and the concrete OpenFact 6 changes that affect fact code. Part of OpenVoxProject#456 Co-authored-by: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: Michael Harp <mike@mikeharp.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Phase 1 of the major-version cutover in
MAINTAINING.mdfor OpenVox Server, following #430 for OpenVox core:docs/_openvox-server_8xcopied todocs/_openvox-server_9x, the collection registered in_config.yml,nav_map.yml,navigation.yml, andproducts.yml, withlateststaying on 8.x until 9.0.0 ships. The collection is authored-only, so there is no reference pin and nothing to regenerate. Content reflects the 9.0.0 prerelease series through9.0.0-beta5.Part of #456.
What changed beyond the copy
9x: index.markdownopenvox-agent9.x dependency9x: install_pre.mdmainplatform list (Debian 11/12 and Amazon Linux 2 dropped), Java 21 or 25 with 17 unsupported, note that the package pulls inopenvox-agent9.x, and the DNS step now says agents no longer fall back to the hostnamepuppet(matches the core 9.x page)9x: install_from_packages.markdownopenvox9-release-*packages (verified present on apt/yum.voxpupuli.org)9x: services_puppetserver.markdown9x: dev_running_from_source.markdown9x: config_file_auth.markdownauth.conffilebucket rule split (openvox-server#549)9x: http_file_bucket_file.md9x: release_notes.markdown9x: http_file_content.md/openvox/8.x/now point at/openvox/9.x/9x: http_file_metadata.md9x: subcommands.markdown/openvox-server/latest/link made relative9x: puppet-api/v3/file_content.markdown8x: puppet-api/v3/file_content.markdownHow the content was checked
OpenVox 8,8.x), reviewed hit by hit.pe_serverversionremoved, Debian 11/12 and Amazon Linux 2 packages dropped, agent 9 dependency, filebucket read authorization, gettext gem, CA bundle fallback). Only the items in the table needed page changes.ezbake/config/conf.d/*.conf) between 8.15.2 and 9.0.0-beta5: the only change is theauth.conffilebucket rule split, so the configuration reference pages are otherwise unchanged.certificate-status/client-whiteliststill exist in 9, so the deprecated-features page is unchanged. Known issues are not version-specific and are unchanged.mainseries in_data/supported_platforms.yml.jekyll build,rake test:products_data, markdownlint on the new collection, and htmlproofer over_site/openvox-server/9.x: the only failures are the generated OpenVox reference pages that are gitignored locally (the usual local false positive; CI generates them).Screenshots
Diffs for the small edits
diff against the 8.x source
Follow-ups
upgrade_minor.mdhere is unchanged.