Demoting Kafka broker

Learn how to demote a Kafka broker when Cruise Control rebalancing is in progress.

When a broker must undergo maintenance, demoting can be used for removing partition leadership from the given broker.

  1. In the command line, check the status of the Kafka cluster with the /kafka_cluster_state command.
  2. Check the status of Cruise Control with /state command to make sure that everything is set before demoting the broker.
  3. Run the /demote_broker command.
    See the REST API reference document for the needed endpoint parameter.
    Cruise Control displays the cluster load after the demoting operation.
  4. Check the status of the Kafka cluster with the /kafka_cluster_state command.
  5. Check the status of Cruise Control with the /state command.
The demoted broker does not contain any partition leaders.