Removes a leaf node from the cluster without deleting its data.

This command must be run from the same host that the Master Aggregator is currently running on.

This command runs the REMOVE LEAF command on the Master Aggregator, which rebalances the leaf node’s partitions into the remaining cluster, and transitions the leaf node to the unknown state.

A leaf node that has been removed can be added back to the cluster, without any loss of data, by using the memsqlctl add-leaf command.

To completely remove a leaf node and its data, refer to the memsqlctl delete-node command.


memsqlctl remove-leaf [flags]
--force Disable automatic rebalance
-h, --help Help for remove-leaf
--host string The cluster-addressable hostname for the node
--port PORT The cluster-addressable port for the node (default 3306)
Global Flags:
-c, --config FILE_PATH Path to the memsqctl config file
--default-install-dir DIRECTORY_PATH Path to the default install directory
--insecure-ssl Fall back to insecure SSL connections to local nodes if memsqlctl is unable to otherwise establish a connection (ADVANCED)
-j, --json Print output in JSON format
--node-metadata-file FILE_PATH Path to the node metadata file
--parallelism POSITIVE_INTEGER Maximum amount of operations to be run in parallel
--ssl-ca FILE_PATH The path to the CA certificate file (in PEM format) to authenticate the database certificate
--timeout duration Maximum time for operation to complete (e.g., 30s, 10m, 1.5h)
--verbose-json Print output in JSON format, include some warnings and user messages
-v, --verbosity count Increase logging verbosity
-y, --yes Enable non-interactive mode and assume the user would like to move forward with the proposed actions by default


  • This command is interactive unless you use either --yes or --json flag to override interactive behavior.

  • The memsqlctl remove-leaf command is equivalent to the sdb-admin remove-leaf command.


The following is the standard output for the remove-leaf command.

sudo memsqlctl remove-leaf --host "" --port 3307
memsqlctl will perform the following actions on the local master aggregator on port 3306:

Would you like to continue? [y/N]: y
✓ Removed leaf from cluster

Last modified: April 22, 2024

Was this article helpful?