# 迁移RabbitMQ的元数据到RocketMQ实例
分布式消息服务RocketMQ版支持通过控制台迁移RabbitMQ的元数据到云上RocketMQ实例。
#### 前提条件
- 已购买RocketMQ实例。
- 已[开启RabbitMQ管理插件](https://www.rabbitmq.com/docs/management)。
- 已购买RabbitMQ 3.7.17/3.8.35版本实例。
 
 #### 步骤一：获取RabbitMQ的元数据
1. 在浏览器中输入"http://*您的RabbitMQ IP地址*:15672/"，进入开源RabbitMQ控制台。
2. 在登录页面输入用户名和密码，单击"Login"。 
   默认的用户名和密码即购买RabbitMQ实例时配置的用户名和密码。
   
   
3. 在"Overview"页签中，单击"Download broker definitions"，导出元数据。 
   图1导出元数据   
   ![](https://support.huaweicloud.com/usermanual-hrm/zh-cn_image_0000001542962724.png "点击放大")
   
   
 
#### 步骤二：在控制台迁移元数据
1. 登录[RocketMQ实例控制台](https://console.huaweicloud.com/dms/?engine=reliability&locale=zh-cn#/queue/manager/instances)。
2. 单击RocketMQ实例的名称，进入实例概览页面。
3. 在左侧导航栏，选择"迁移上云 \> 元数据迁移"，进入迁移任务列表页面。
4. 单击"创建迁移任务"，弹出"创建迁移任务"对话框。
5. 参考[表1]，设置迁移任务的参数。
   
    表1迁移任务参数说明 
   | 参数     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   |:---|:---|
   | 任务类型   | 选择"RabbitMQ到RocketMQ元数据迁移"。                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 任务名称   | 您可以自定义迁移任务的名称，用于区分不同的迁移任务。 任务名称命名规则如下： - 长度为4\~64个字符。  - 只能由英文字符、数字、中划线、下划线组成，且开头须为英文字母。                                                                                                                                                                                            |
   | 是否同名覆盖 | - 如果开启同名覆盖，会对已有的同名元数据的配置进行修改。 例如：原实例Topic01的读队列个数为3，云上实例Topic01的读队列个数为2，开启同名覆盖后，云上实例Topic01的读队列个数变为3。   - 如果不开启同名覆盖，同名元数据的迁移将失败。 例如：原实例的Topic包含Topic01和Topic02，云上实例的Topic包含Topic01和Topic03，不开启同名覆盖，原实例Topic01的迁移将失败。    |
   | 元数据    | 上传[RabbitMQ的元数据]。                                                                                                                                                                                                                                                                                                                                                                                                                    |
      
   
   
6. 单击"确定"。 
   迁移完成后，在迁移任务列表页面查看"任务状态"。
   - 当"任务状态"为"迁移完成"，表示所有元数据都已成功迁移。 迁移成功后，请参考[使用客户端连接RocketMQ（关闭SSL）](https://support.huaweicloud.com/usermanual-hrm/hrm-ug-039.html)或[使用客户端连接RocketMQ（开启SSL）](https://support.huaweicloud.com/usermanual-hrm/hrm-ug-040.html)生产和消费消息，以确保元数据可用。
     
   
   - 当"任务状态"为"迁移失败"，表示元数据中部分或全部元数据迁移失败。 单击迁移任务名称，进入迁移任务详情页。在"迁移结果"中可查看到迁移失败的Topic/消费组名称，以及失败原因及解决方法。
     
   
   
   
   
 
#### 相关文档
创建元数据迁移任务也可以通过调用API完成，具体请参见[新建元数据迁移任务](https://support.huaweicloud.com/api-hrm/CreateRocketMqMigrationTask.html)。