Add OpenVoxDB 9.x docs collection as a preview (latest stays on 8.x) - #458
Open
miharp wants to merge 1 commit into
Open
Add OpenVoxDB 9.x docs collection as a preview (latest stays on 8.x)#458miharp wants to merge 1 commit into
miharp wants to merge 1 commit into
Conversation
miharp
force-pushed
the
docs/openvoxdb9-cutover
branch
from
August 27, 2026 13:37
c1c02d1 to
a64da50
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>
Phase 1 of the major-version cutover in MAINTAINING.md for OpenVoxDB: copy docs/_openvoxdb_8x to docs/_openvoxdb_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 9.0.0-beta1: - index: prerelease notice, version note, Java 21 or 25 (17 dropped), platform list from the shared-actions main platform list (Debian 11/12 dropped), OpenJDK 21/25 for custom installs, OpenVox Server naming in the server requirement plus the openvoxdb-termini package dependency (openvox-agent >= 8.26.2, no upper bound in beta1), PostgreSQL 14 minimum (oldest-supported-db in scf/storage.clj) - puppetdb-faq: supported JDK versions - install_from_source: JDK 21 - configure: the [jetty] note names Jetty 12 - release_notes: rewritten for the 9.0.0 prerelease series, including the bootstrap.cfg jetty10-service pitfall for upgrades from 8.14.0 or earlier The shipped config templates (resources/ext/config) are identical between 8.15.0 and 9.0.0-beta1 apart from the packaging dependency change, so the configuration pages are otherwise unchanged. Known issues and the versioning policy are not version-specific and are unchanged. 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/openvoxdb9-cutover
branch
from
August 27, 2026 21:53
a64da50 to
e5772c4
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 OpenVoxDB, following #430 (core) and #457 (server):docs/_openvoxdb_8xcopied todocs/_openvoxdb_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. Content reflects9.0.0-beta1, the only 9.x tag so far.Part of #456. Merge after #457: the 9.x release notes link to
/openvox-server/9.x/release_notes.html, which #457 adds.What changed beyond the copy
index.mdmainplatform list (Debian 11/12 dropped); OpenJDK 21/25 for custom installs; "OpenVox Server" naming in the server requirement plus theopenvoxdb-terminidependency (openvox-agent >= 8.26.2, no upper bound in beta1); PostgreSQL 14 minimumpuppetdb-faq.markdowninstall_from_source.markdownconfigure.markdown[jetty]note names Jetty 12release_notes.markdownbootstrap.cfgjetty10-servicepitfall for upgrades from 8.14.0 or earlierHow the content was checked
OpenVoxDB 8,8.x), reviewed hit by hit. The one remaining hit (api/query/v4/query.markdown, an issue with 8.1.0) is historical and stays.ssl-setupno longer using--configprint(update social share card #400), Jolokia 2.x config (discourage unbounded resource collectors #334).resources/ext/config/**,ezbake.conf) between 8.15.0 and 9.0.0-beta1: identical apart from the packaging dependency (openvox-agent >= 8.28.1, < 9.0.0~in 8.15.0 versus>= 8.26.2with no upper bound in beta1), so the configuration pages are otherwise unchanged. The missing upper bound looks like a beta1 artifact (the build branched from 8.13.0); the docs state what ships, and it is worth re-checking at the next 9.x tag.oldest-supported-dbinsrc/puppetlabs/puppetdb/scf/storage.clj(14.0 in both 8.15.0 and beta1). The 8.x page still says 11, which is already wrong for 8.x; left for a separate 8.x fix rather than widening this PR.mainseries in_data/supported_platforms.yml.jekyll build,rake test:products_data, markdownlint on the new collection, and htmlproofer over_site/openvoxdb/9.x: apart from the locally-absent generated OpenVox reference pages, the only failure is the link to the server 9.x release notes noted above.Screenshots
Diffs for the small edits
diff against the 8.x source
Follow-ups
canonical:front matter pointing at/openvoxdb/latest/; the theme only readscanonical_url(set by_plugins/canonical_latest.rb), so it is inert. Could be stripped from both collections in a cleanup.