NewTS Documentation for Cassandra does not adequately describe the importance or use of the org.opennms.newts.config.driver_settings_file setting

Description

None

Environment

The Datastax driver was updated in Horizon 32, and now requires an additional configuration directive and file. This was mentioned in the H32 release notes, but the deployment documentation does not convey its importance. The `org.opennms.newts.config.driver_settings_file` setting is mentioned in the midst of many other settings, but it's not listed as required. The Cassandra storage strategy will not work without both this setting, and a properly configured configuration file at the location specified by the setting. Customers upgrading their OpenNMS installations from pre-H32 versions, or configuring NewTS for the first time, may easily miss this and the errors produced in the OpenNMS logs do not make it obvious where the configuration error may be.

Acceptance / Success Criteria

None

Activity

Dino Yancey January 6, 2025 at 9:25 PM

MARK TINBERG May 15, 2024 at 9:16 PM

The problem I ran into was that after upgrading to meridian 2024 with the new datastax driver nothing was setting the default auth class so I added datastax-java-driver.advanced.auth-provider.class=PlainTextAuthProvider to the timeseries.properties file and that was the minimum change needed to allow opennms to connect to scylladb. If there are other settings that would have been set by default with the old datastax driver and need to be specified somewhere then there should be a default properties file that includes those settings, like this one, to ease upgrades.

Merged

Details

Assignee

Reporter

Components

Affects versions

Priority

PagerDuty

Created April 30, 2024 at 9:18 PM
Updated January 17, 2025 at 5:57 PM
Resolved January 17, 2025 at 5:57 PM