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
4 changes: 2 additions & 2 deletions _data/nav/openvoxdb_8x.yml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
- text: General information
items:
- text: Release notes
link: release_notes.html
- text: Overview and requirements
link: index.html
- text: Contributing to OpenVoxDB
link: CONTRIBUTING.html
- text: Frequently asked questions
link: puppetdb-faq.html
- text: Release notes
link: release_notes.html
- text: Versioning policy
link: versioning_policy.html
- text: Known issues
Expand Down
351 changes: 35 additions & 316 deletions docs/_openvoxdb_8x/release_notes.markdown
Original file line number Diff line number Diff line change
@@ -1,345 +1,64 @@
---
title: "OpenVoxDB: Release notes"
title: "OpenVoxDB 8 Release Notes"
layout: default
canonical: "/openvoxdb/latest/release_notes.html"
---

[benchmark]: ./load_testing_tool.html
[query-timeout-parameter]: ./api/query/v4/overview.html#url-parameters
[terminus-config]: ./puppetdb_connection.html
# OpenVoxDB 8 Release Notes

---

# OpenVoxDB: Release notes

## OpenVoxDB 8.8.1

Released October 29 2024

### Bug fixes

* Fixed an issue with report garbage collection where a partition would become
partially detached and block future garbage collection progress. Garbage
collection will now finalize the partition detach operation and remove the
table. ([GitHub #4013](https://github.com/OpenVoxProject/openvoxdb/issues/4013))
* Fixed an issue with report garbage collection where a partition would be
detached, but the table was never deleted. Garbage collection will now
identify and clean-up these tables.
([GitHub #4013](https://github.com/OpenVoxProject/openvoxdb/issues/4013))

## OpenVoxDB 8.8.0

Released October 22 2024

### Improvements

* Released support and packages for Debian 12 (bookworm).
* Report partitions are now analyzed hourly to keep PostgreSQL's query planner
statistics up-to-date.

### Bug fixes

* Added a database constraint to prevent duplicate catalogs. If your database
contains any duplicate catalogs, only the most recent catalog for each
certname will be kept.

## OpenVoxDB 8.7.0

Released July 23 2024

### New features and improvements

* Improve performance of command processing by explicitly batching insertions
and reducing return network traffic from Postgres.
* Add a latest partition to reports and resource events to improve query
performance for queries using the `latest_report?` filter.

### Bug fixes

* Fixed an issue causing OpenVoxDB to crash if the Postgres database was
stopped. ([GitHub #3991](https://github.com/OpenVoxProject/openvoxdb/issues/3991))

### Contributors

Austin Blatt and Rob Browning.

## OpenVoxDB 8.6.0

Released June 11 2024

### New features and improvements

* Improve performance of fact queries by reducing jsonb merges.
* OpenVoxDB will no longer log long stack traces for standard ways that a user
query might be invalid.

### Contributors

Austin Blatt and Rob Browning.

## OpenVoxDB 8.5.1

Released April 24 2024

### Bug fixes

* Fix an error when querying for `nodes` and `latest_report_status`
[GitHub #3966](https://github.com/OpenVoxProject/openvoxdb/issues/3966)

### Contributors

Austin Blatt and Rob Browning.

## OpenVoxDB 8.5.0

Released April 11 2024

### New features and improvements

* Improve query performance on the certnames table
* Ship with updated dependencies (clojure, and pgjdbc)

### Bug fixes

* Ensure producer_timestamp is logged with legacy commands.

### Contributors

Austin Blatt, Cas Donoghue, and Rob Browning.

## OpenVoxDB 8.4.1

Released February 27 2024

### Bug fixes

* Fixed an issue with negated regex queries (`!~`) on JSON fields (dotted fact
paths and resource parameters), which were not matching the full negation of
the regex match when the key was missing from some of the JSON maps.

### Contributors

Austin Blatt, Jonathan Newman, Josh Partlow, and Rob Browning

## OpenVoxDB 8.3.0

Released January 18 2024

### New features and improvements

* The OpenVoxDB terminus now supports the
[`include_catalog_edges`][terminus-config] configuration option. Setting this
value to false will omit all resource edges from the catalog submitted to
OpenVoxDB.
([GitHub #3912](https://github.com/OpenVoxProject/openvoxdb/issues/3912))

### Bug fixes

* OpenVoxDB queries should no longer risk hanging when run just after
non-streaming queries (for example, those with `ast_only` set to
true). ([GitHub #3933](https://github.com/OpenVoxProject/openvoxdb/pull/3933))

### Contributors

Austin Blatt, Cas Donoghue, Eric Newton, Jonathan Newman, Josh Partlow,
Rob Browning, and Steve Axthelm

## OpenVoxDB 8.2.0

Released November 7 2023

### Security fixes

* Update trapperkeeper-webserver-jetty9 to 4.5.2 to address
CVE-2023-44487, CVE-2023-36478, GHSA-58qw-p7qm-5rvh,
GHSA-hmr7-m48g-48f6, and GHSA-3gh6-v5v9-6v9j.

* Update Bouncy Castle FIPS to v1.0.2.4 to resolve CVE-2022-45156
and CVE-2023-33202.

### Bug fixes

* Update jvm-ssl-utils to 3.5.2 to address a stack overflow in
certificates with tags.

### New features and improvements

* An `--offset` option has been added to the [`benchmark` command][benchmark]
This allows you to run two or more Benchmark instances in parallel,
offsetting the generated cert numbers so that the commands don't
collide in the database.
([GitHub #3896](https://github.com/OpenVoxProject/openvoxdb/issues/3896))

* The [`benchmark` command][benchmark] should be able to reach notably
higher maximum output rates. On one 60 core (non-hyperthreaded)
host where previously it could only simulate about 80k nodes with a
30 minute runinterval, it can now simulate over 140k nodes, more if
the randomization percentage is reduced from 100.
([GitHub #3886](https://github.com/OpenVoxProject/openvoxdb/issues/3886))
(PDB-5712)

* The [`benchmark` command][benchmark]'s `-t`/`--threads` argument has
been deprecated and renamed to `--senders`.
([GitHub #3886](https://github.com/OpenVoxProject/openvoxdb/issues/3886))
(PDB-5712)

* The [`benchmark` command][benchmark]'s default number of `--senders`
has been changed from four times the host core (hyperthread) count
to half the count (or 2, whichever's larger) after testing revealed
that with a 60 core (non-hyperthreaded) host, only 16 senders were
needed to hit a maximum rate with the local OpenVoxDB/PostgreSQL
hosts.
([GitHub #3886](https://github.com/OpenVoxProject/openvoxdb/issues/3886))
(PDB-5712)

* A `--simulators` option has been added to the
[`benchmark` command][benchmark]. It specifies the number of
threads to use for the generation of new host commands and defaults
to either 2, or half the core (hyperthread) count. The previous
internal value was always 4.
([GitHub #3886](https://github.com/OpenVoxProject/openvoxdb/issues/3886))
(PDB-5712)

* The [`benchmark` command][benchmark] command will now space out the
factset, catalog, and report for each host more realistically.
([GitHub #3880](https://github.com/OpenVoxProject/openvoxdb/pull/3880))
(PDB-5691)

### Contributors

Austin Blatt, Nick Burgan-Illig, Joshua Partlow, and Rob Browning

## OpenVoxDB 8.1.1

Released September 14 2023

### Bug fixes

* OpenVoxDB should no longer throw a `CancelledKeyException` when a
network connection is reused for multiple queries (originally
noticed in the 8.1.0 release).
([GitHub #3866](https://github.com/OpenVoxProject/openvoxdb/issues/3866))

### Contributors

Austin Blatt, Ingrida Cazers, Josh Partlow, Rob Browning, and
Steve Axthelm

## OpenVoxDB 8.1.0

Released August 22 2023

### New features and improvements

* RedHat Enterprise Linux 9 (RHEL 9) has been added as a supported
platform.
([PDB-5667](https://perforce.atlassian.net/browse/PDB-5667))

* Ubuntu 22.04 has been added as a supported platform.
([PDB-5636](https://perforce.atlassian.net/browse/PDB-5636))

* OpenVoxDB will now abandon queries more promptly when a client
disconnects. Previously an expensive query could continue running
indefinitely. The same mechanism should also help ensure query
timeouts are immediately enforced.
([GitHub #3867](https://github.com/OpenVoxProject/openvoxdb/issues/3867))

* When no database migrations are pending, OpenVoxDB will no longer
disconnect clients on restart.
([PE-36120](https://perforce.atlassian.net/browse/PE-36120))

### Bug fixes

* Some PQL queries with numerous `or` clauses should no longer cause
OpenVoxDB to run out of memory. Previously they could allocate an
exorbitant amount of RAM.
([GitHub #3874](https://github.com/OpenVoxProject/openvoxdb/issues/3874))

### Known issues
## OpenVoxDB 8.13.0

* The mechanism used to abandon queries and enforce timeouts mentioned
above may throw a `CancelledKeyException` when a network connection
is reused for multiple queries. For the time being, the problem can
be addressed by setting the experimental environment variable
`PDB_PROMPTLY_END_QUERIES` to `false`. (This variable may be
removed in a future release.)
([GitHub #3866](https://github.com/OpenVoxProject/openvoxdb/issues/3866))
Released May 4, 2026.

### Contributors
This is an enhancement release of OpenVoxDB.

Austin Blatt, Nick Burgan-Illig, Jonathan Newman, Eric Newton, Joshua
Partlow, Steve Axthelm, and Rob Browning
All bug fixes, new features and other changes are provided on the
[project's GitHub release page](https://github.com/OpenVoxProject/openvoxdb/releases/tag/8.13.0).

## OpenVoxDB 8.0.1
## OpenVoxDB 8.12.1

Released June 14 2023
Released January 23, 2026.

## New features and improvements
This is a bug-fix release of OpenVoxDB.

* All PQL statements that take longer than one second to parse will be
logged. Previously that was only the case when query logging was
enabled.
([PDB-5642](https://tickets.puppetlabs.com/browse/PDB-5642))
([PDB-5260](https://tickets.puppetlabs.com/browse/PDB-5260))
All bug fixes, new features and other changes are provided on the
[project's GitHub release page](https://github.com/OpenVoxProject/openvoxdb/releases/tag/8.12.1).

* A new `generate` CLI subcommand has been added. It can create a
base sampling of catalog, fact and report files suitable for
consumption by [`benchmark`][benchmark].
([PDB-5593](https://tickets.puppetlabs.com/browse/PDB-5593))
## OpenVoxDB 8.12.0

* OpenVoxDB sync (PE only) now uses the query timeouts introduced in
[PDB-4937](https://tickets.puppetlabs.com/browse/PDB-4937) to
further constrain sync operations to run within the
`entity-time-limit`.
([PDB-5232](https://tickets.puppetlabs.com/browse/PDB-5232))
Released January 23, 2026.

### Contributors
This is a bug-fix and enhancement release of OpenVoxDB.

Austin Blatt, Josh Partlow, and Rob Browning
All bug fixes, new features and other changes are provided on the
[project's GitHub release page](https://github.com/OpenVoxProject/openvoxdb/releases/tag/8.12.0).

## OpenVoxDB 8.0.0
## OpenVoxDB 8.11.0

Released April 25 2023
Released August 24, 2025.

## New features and improvements
This is a maintenance release of OpenVoxDB.

* Drop joins are now applied when evaluating sub-queries which should result in
performance improvements.
([PDB-5557](https://tickets.puppetlabs.com/browse/PDB-5557))
* OpenVoxDB now supports query timeouts for queries to the `query/` endpoint via
an [optional query parameter][query-timeout-parameter]. A
[default](./configure.html#query-timeout-default) and a
[maximum](./configure.html#query-timeout-max) can also be specified in
the configuration. The current default is ten minutes.
([PDB-4937](https://tickets.puppetlabs.com/browse/PDB-4937))
All bug fixes, new features and other changes are provided on the
[project's GitHub release page](https://github.com/OpenVoxProject/openvoxdb/releases/tag/8.11.0).

## Removals
## OpenVoxDB 8.10.0

* The deprecated query streaming method has been removed, along with the
associated `PDB_USE_DEPRECATED_STREAMING_METHOD` environment variable.
Released August 4, 2025.

* The previously optional PostgreSQL trigram index support,
[`pg_trgm`](https://www.postgresql.org/docs/14/pgtrgm.html) is now required.
This is an enhancement release of OpenVoxDB.

### Upgrading
All bug fixes, new features and other changes are provided on the
[project's GitHub release page](https://github.com/OpenVoxProject/openvoxdb/releases/tag/8.10.0).

* OpenVoxDB requires Java 11+ and recommends Java 17. Our packages have
been updated to require Java 11 or Java 17. **RedHat users** should be aware
that Java 8 remains the highest priority Java on its distributions even when
Java 11 is installed. This will cause OpenVoxDB to fail to start. Changing the
default Java from 8 to 11 by installing Java 11 and selecting it as the
default via `alternatives --config java` before upgrading will ensure a
successful upgrade. The alternatives command can be used to rectify a failed
OpenVoxDB 8 upgrade, you will then need to start the service manually.
## OpenVoxDB 8.9.1

* PostgreSQL 11, 12, and 13 are no longer supported. PostgreSQL 14+ is
required. This is not enforced by OpenVoxDB, so you _can_ continue to use
those unsupported PostgreSQL versions for now, but we reserve the right to
change that in any future OpenVoxDB release. Please use this extra overlap
time to upgrade your database.
* Added `Obsoletes`, `Replaces`, and `Conflicts` package metadata for
`puppetdb` and `puppetdb-termini` to the `openvoxdb` and
`openvoxdb-termini` packages to support clean upgrades.

### Contributors
## OpenVoxDB 8.9.0

Arthur Lawson, Austin Blatt, Ben Ford, Cas Donoghue, Jonathan Newman,
Josh Partlow, Nick Burgan-Illig, Nick Lewis, Noah Fontes, and Rob
Browning
This is the initial OpenVoxDB release, based on PuppetDB 8.8.1 and supported
on all platforms that PuppetDB supported, but for all architectures rather than
just x86_64.
Loading