华为云首页用户手册

分布式消息服务ROCKETMQ版-RocketMQ业务迁移:实施步骤（通过mqadmin命令导出源实例的元数据）

时间：2024-04-18 16:51:17

分布式消息服务ROCKETMQ版

实施步骤（通过mqadmin命令导出源实例的元数据）

迁移元数据至分布式消息服务RocketMQ版实例。

获取其他厂商或自建RocketMQ实例的元数据。
1. 登录主机，下载RocketMQ软件包。
```
wget https://archive.apache.org/dist/rocketmq/4.9.8/rocketmq-all-4.9.8-bin-release.zip
```
2. 解压软件包。
```
unzip rocketmq-all-4.9.8-bin-release.zip
```
3. （可选）如果RocketMQ实例开启了ACL访问控制，执行mqadmin命令时，需要鉴权。
  切换到解压后的软件包目录下，在“conf/tools.yml”文件中，增加如下内容。
```
accessKey:*******
secretKey:*******
```
  accessKey和secretKey表示在控制台“用户管理”页面，创建的用户名和密钥。
4. 进入解压后的软件包目录下，执行以下命令，查询集群名称。
```
sh ./bin/mqadmin clusterList -n {nameserver地址及端口号}
```
  例如：“nameserver地址及端口号”为“192.168.0.65:8100”。
```
sh ./bin/mqadmin clusterList -n 192.168.0.65:8100
```
5. 执行以下命令，导出元数据。
  - 未开启SSL的实例，执行以下命令。
```
sh ./bin/mqadmin exportMetadata -n {nameserver地址及端口号} -c {RocketMQ集群名称} -f {导出的元数据文件的存放路径}
```
    例如：“nameserver地址及端口号”为“192.168.0.65:8100”，“RocketMQ集群名称”为“DmsCluster”，“导出的元数据文件的存放路径”为“/tmp/rocketmq/export”。
```
sh ./bin/mqadmin exportMetadata -n 192.168.0.65:8100 -c DmsCluster -f /tmp/rocketmq/export
```
  - 已开启SSL的实例，执行以下命令。
```
JAVA_OPT=-Dtls.enable=true sh ./bin/mqadmin exportMetadata -n {nameserver地址及端口号} -c {RocketMQ集群名称} -f {导出的元数据文件的存放路径}
```
    例如：“nameserver地址及端口号”为“192.168.0.65:8100”，“RocketMQ集群名称”为“DmsCluster”，“导出的元数据文件的存放路径”为“/tmp/rocketmq/export”。
```
JAVA_OPT=-Dtls.enable=true sh ./bin/mqadmin exportMetadata -n 192.168.0.65:8100 -c DmsCluster -f /tmp/rocketmq/export
```

在控制台迁移元数据。

登录分布式消息服务RocketMQ版控制台。
单击RocketMQ实例的名称，进入实例详情页面。
在左侧导航栏，选择“元数据迁移”，进入迁移任务列表页面。
单击“创建迁移任务”，弹出“创建迁移任务”对话框。

参考表2，设置迁移任务的参数。

表2 迁移任务参数说明
参数	说明
任务名称	您可以自定义迁移任务的名称，用于区分不同的迁移任务。
是否同名覆盖	如果开启同名覆盖，会对已有的同名元数据的配置进行修改。例如：原实例Topic01的读队列个数为3，云上实例Topic01的读队列个数为2，开启同名覆盖后，云上实例Topic01的读队列个数变为3。如果不开启同名覆盖，同名元数据的迁移将失败。例如：原实例的Topic包含Topic01和Topic02，云上实例的Topic包含Topic01和Topic03，不开启同名覆盖，原实例Topic01的迁移将失败。
元数据	上传获取其他厂商或自建RocketMQ实例的元数据。

单击“确定”。
迁移完成后，在迁移任务列表页面查看“任务状态”。
- 当“任务状态”为“迁移完成”，表示所有元数据都已成功迁移。
- 当“任务状态”为“迁移失败”，表示元数据中部分或全部元数据迁移失败。单击迁移任务名称，进入迁移任务详情页，在“迁移结果”中查看迁移失败的Topic/消费组名称，以及失败原因。

迁移生产消息至分布式消息服务RocketMQ版实例。
将生产客户端的元数据连接地址改为分布式消息服务RocketMQ版实例的元数据连接地址，重启生产业务，使得生产者将新的消息发送到分布式消息服务RocketMQ版实例中。
迁移消费消息至分布式消息服务RocketMQ版实例。
待消费组中的消息消费完之后，将消费客户端的元数据连接地址改为分布式消息服务RocketMQ版实例的元数据连接地址，重启消费业务，使得消费者从分布式消息服务RocketMQ版实例中消费消息。
如果有多个RocketMQ实例需要迁移到同一个分布式消息服务RocketMQ版实例中，请依次进行迁移。