Skip to content
SHC Docs

shc volume assert-lease-lost

assert that a dead node cannot write, unblocking a stalled automatic failover

Assert, on your own responsibility, that cannot write.

Automatic volume failover refuses to move a volume without proof that its old node has stopped writing. That proof normally comes from the node’s own attachment lease expiring, or from a STONITH agent confirming a power cut. When both are unavailable the failover stalls indefinitely, and the only alternative used to be detaching the volume by hand in the provider console, which is the same risk with none of the ordering, the lease bump, or the record.

This verb is that exit, inside the product. It names one node, it is refused if the cluster still considers that node reachable, it is attributed to you, and it is scoped to the current failover episode: it lapses, and it is revoked the moment the node answers a health probe again.

If the assertion is wrong and the node is still running, two nodes will mount the same filesystem and its contents will be corrupted. Verify the node is dead out of band (provider console, power state, hypervisor) before asserting it.

shc volume assert-lease-lost <node> [flags]
-h, --help help for assert-lease-lost
--reason string what you verified, recorded verbatim in the audit record alongside your name
-y, --yes assume yes: you have verified out of band that the node cannot write (required)
--config stringArray extra YAML config file to layer on top of auto-discovered config; repeatable, later files win
-d, --debug enable debug mode (default: $SHC_DEBUG)
-e, --environment string environment name (default: "prod", or "default" on an estate with no licence and no trial; $SHC_ENVIRONMENT and shc ctx -e override it, and the "master" tenant is always "default")
--exclude string comma-separated dotted paths to drop
--fields string comma-separated columns/keys to show (and their order)
--filter string comma-separated dotted paths to keep (drops everything else)
-o, --output string output format: tty|text|json|yaml (default: $SHC_OUTPUT)
-s, --stack string stack name (default: $SHC_STACK)
-t, --tenant string tenant name (default: $SHC_TENANT)
-v, --verbose verbose output (default: $SHC_VERBOSE)
  • shc volume - manage and inspect cluster block volumes