Werk #19218: mk-oracle: Migrate legacy Oracle plugin configuration to new format

Component

Checks & agents

Title

mk-oracle: Migrate legacy Oracle plugin configuration to new format

Date

Jul 1, 2026

Level

Prominent Change

Class

New Feature

Compatibility

Compatible - no manual interaction needed

Checkmk versions & editions

3.0.0b1 Not yet released	Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT
2.5.0p9 Not yet released	Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT

Previously, users who had an existing legacy Oracle plugin configuration had to manually rewrite it in the new YAML-based format used by mk-oracle. This was error-prone and time-consuming, especially for complex setups with multiple database users, sections, and instance filters.

Starting with this release, mk-oracle provides a built-in migration command to automatically convert legacy Oracle plugin configuration files to the new format. Run the migration with:

mk-oracle -M <path-to-legacy-config> or mk-oracle --migrate-config <path-to-legacy-config>

The converted configuration is written to stdout by default. Use --migrate-output <path> to write it to a file instead. This works on all supported operating systems (Linux, AIX, Solaris, Windows). Custom SQL metrics are not yet supported by the migration and must be transferred manually.

To the list of all Werks