Help Center/ Distributed Message Service for RocketMQ/ User Guide/ Managing Instances/ Restarting Brokers of a RocketMQ Instance
Updated on 2025-07-11 GMT+08:00
View PDF
Share

Restarting Brokers of a RocketMQ Instance

Restart one or more brokers of a RocketMQ instance at a time on the DMS for RocketMQ console.

How do I know which broker is the master?

Each broker has one master node and two standby nodes. For example, to purchase one broker, two brokers will be created. Three brokers are deployed in raft mode with broker IDs 1, 2, and 3. When one broker becomes the master, its broker ID is 0. In this case, the broker whose ID is 0 is the master one.

Figure 1 Restarting brokers

Notes and Constraints

Available only for RocketMQ 4.8.0 and not for 5.x.

During the restart, client requests for message consumption and production will be rejected for up to 30s. Restart brokers during off-peak hours. Restarting slave brokers does not affect services.

Prerequisite

The RocketMQ instance must be running.

Procedure

  1. Log in to the console.
  2. Click in the upper left corner to select a region.

    DMS for RocketMQ instances in different regions cannot communicate with each other over an intranet. Select a nearest location for low latency and fast access.

  3. Click and choose Middleware > Distributed Message Service for RocketMQ to open the console of DMS for RocketMQ.
  4. In the row containing the desired RocketMQ instance, choose More > Restart Broker.
  5. Select the brokers to be restarted and click Yes.

    It takes 3 to 15 minutes to restart the brokers.

Parent Topic: Managing Instances