Reference For: administrators

Cluster errors

Causes and remedies for the error codes about the controllers of a domain.

error.cluster.version_skew

Text in the console
Controller {node} runs an older version. Upgrade every controller before a datastore enters maintenance mode.
Meaning for API clients
A controller of the domain runs a version that does not know datastore maintenance mode; upgrade every controller before a datastore enters it.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentWhat it holds
nodethe node id of the controller that runs the older version.
versionthe version it reported, when it reported one.

Cause. A controller of the domain runs a version that does not know datastore maintenance mode. The datastore record gains a maintenance state when a datastore first enters maintenance mode, and an older controller cannot read such a record. Maintenance mode is refused until every controller declares that it knows it.

Remedy.

  1. Upgrade every controller of the domain to the same version.
  2. Start maintenance mode again. In the console, select Enter maintenance mode… under More actions of the datastore; with the CLI: kyvernon datastore enter-maintenance <id>.

Version 0.1. Last changed: 2026-11-15