repmgr primary unregister

repmgr primary unregister — unregister an inactive primary node

Description

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

Execution

repmgr primary unregister can be run on any active repmgr 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.

repmgr master unregister can be used as an alias for repmgr 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.