Rebalance after demoting Kafka broker

When a broker needs maintenance during the rebalance process, you can demote the Kafka broker using the command line. After the maintenance is completed, the rebalancing process can be continued.

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.