dbpm check-core

Verify that Core is installed in the target database and optionally meets a minimum version requirement. This is a read-only command — it makes no changes.

Syntax

dbpm check-core [--minimum-version VERSION] [--connect STRING] [--runner EXEC]

EBNF diagram

flowchart LR
    command["command"] --> dbpm["dbpm"]
    dbpm --> check_core["check-core"]
    check_core --> options["{ option }"]
    options --> end_node(("end"))

    options -. expands to .-> option["option"]
    option --> minimum_version["--minimum-version VERSION"]
    option --> connect["--connect STRING"]
    option --> runner["--runner EXEC"]

    minimum_version -. constrains success .-> version_note["Core must be at least VERSION"]

Arguments

Argument	Default	Description
--minimum-version	none	Minimum acceptable Core version, such as 3.2.0. If omitted, any installed Core version passes.
--connect	DBPM_CONNECT	SQLPlus/SQLcl connect string.
--runner	DBPM_SQL_RUNNER or sqlplus	SQL runner executable.

Output

On success:

CORE_VERSION=3.4.0

On failure, dbpm exits with code 2 and prints an error to stderr.

Examples

Check that any Core version is installed:

dbpm check-core --connect user/pass@db

Check that Core meets a minimum version:

dbpm check-core --minimum-version 3.2.0 --connect user/pass@db

Using environment variables:

export DBPM_CONNECT=user/pass@db
dbpm check-core --minimum-version 3.0.0

Notes

• Run check-core before any non-Core deployment to verify the substrate is ready.
• Core must be bootstrapped with dbpm bootstrap-core before ordinary package installs can run.

---

Source: docs/commands/check-core.md