ltcluster primary unregister

ltcluster primary unregister — unregister an inactive primary node

Description

ltcluster primary unregister unregisters an inactive primary node from the ltcluster metadata. This is typically when the primary has failed and is being removed from the cluster after a new primary has been promoted.

Execution

ltcluster primary unregister can be run on any active ltcluster node, with the ID of the node to unregister passed as --node-id.

Execute with the --dry-run option to check what would happen without actually unregistering the node.

ltcluster master unregister can be used as an alias for ltcluster primary unregister.

Options

--dry-run

Check prerequisites but don't actually unregister the primary.

--node-id

ID of the inactive primary to be unregistered.

--force

Forcibly unregister the node if it is registered as an active primary, as long as it has no registered standbys; or if it is registered as a primary but running as a standby.

Event notifications

A primary_unregister event notification will be generated.