快速使用手册

# 前言

本文档为金蝶Apusic分布式消息队列for RabbitMQ（Apusic Distributed Message Queue，简称：ADMQ for RabbitMQ）的快速使用手册，提供产品介绍，安装部署产品的基本步骤及验证方式。

# 适用对象

本文档适用于IT信息化业务负责人、研发经理、软件项目经理、软件架构师、运维工程师。

# 相关文档

了解更多ADMQ for RabbitMQ产品相关的信息，请参阅以下ADMQ for RabbitMQ产品手册文档集：

序号 手册文档 说明
1 金蝶Apusic分布式消息队列for RabbitMQ 快速使用手册 简单介绍了如何快速上手使用ADMQ for RabbitMQ 。
2 金蝶Apusic分布式消息队列for RabbitMQ 安装手册 详细介绍如何在各操作系统上安装ADMQ for RabbitMQ，以及ADMQ for RabbitMQ服务启停等操作。
3 金蝶Apusic分布式消息队列for RabbitMQ 消息引擎用户手册 详细介绍 ADMQ for RabbitMQ 消息引擎相关功能的使用、配置、管理及配套工具的使用方法。
4 金蝶Apusic分布式消息队列for RabbitMQ 管控台用户手册 详细介绍ADMQ for RabbitMQ管控台相关功能的使用和操作说明。
5 金蝶Apusic分布式消息队列for RabbitMQ 开发手册 详细介绍基于各开发语言进行ADMQ for RabbitMQ客户端应用开发的说明。
6 金蝶Apusic分布式消息队列for RabbitMQ 迁移手册 详细介绍从RabbitMQ迁移到ADMQ for RabbitMQ的说明。
7 金蝶Apusic分布式消息队列for RabbitMQ 运维手册 详细介绍ADMQ for RabbitMQ的监控、运维、安全加固等运维说明。
8 金蝶Apusic分布式消息队列for RabbitMQ 性能优化手册 详细介绍ADMQ for RabbitMQ性能调优的说明。

# 技术支持

ADMQ for RabbitMQ产品提供全面的技术支持服务，您可以通过以下方式获得技术支持：

  • 网址：www.apusic.com
  • 电话：400-855-5800
  • 邮箱：support@apusic.com
  • 金蝶云社区：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

您在取得技术支持时，请提供如下信息：

  1. 您的姓名

  2. 公司信息与联系方式

  3. 操作系统及其版本

  4. 产品版本号

  5. 出现异常及错误的日志、截图等详细信息

# ADMQ 管控部署

# 一、准备工作

# 1.1 环境要求

  • 操作系统：CentOS 7+ / Ubuntu 18.04+，建议 4 核 8GB 以上

  • 网络：管控平台与 RabbitMQ 节点之间网络互通（端口：15672 管理端口、5672 服务端口）

# 1.2 安装包

  • 获取管理控制台安装包：admq-manager-V3.0.2.tar.gz（请联系技术支持获取）

  • 将安装包上传至目标服务器（如 /opt 目录）

# 二、部署管理控制台

# 2.1 解压安装包

tar zxvf admq-manager-V3.0.2.tar.gz -C /opt/
cd /opt/admq-manager-V3.0.2
1
2

# 2.2 启动控制台

bin/admq-service start
1

验证启动：

bin/admq-service status
1

看到 ADMQ Manager is running 即表示成功。

# 2.3 访问控制台

  • 浏览器访问：https://<控制台IP>:12306

  • 默认账号：admq / 11111111（首次登录请修改密码）

# 2.4 初始化默认配置

在服务器执行

bin/init all
1

# 三、部署 RabbitMQ 服务（在管理控制台操作）

# 3.1 上传授权文件

在【资源管理】-【License管理】上传授权文件

# 3.2 上传软件包

  1. 登录管理控制台，进入 资源管理 菜单。

  2. 上传：

    • 软件包：admq-rabbitmq-<version>.tar.gz（平台预置或自定义）
  1. 等待上传完成并校验成功。

# 3.3 添加服务器

在【资源管理】-【服务器管理】添加服务器，添加后会自动在服务器上部署代理程序。

成功后可看到添加的记录，会定时获取服务器cpu、内存状态，并获取授权特征码，如果申请正式授权，需要提供这里的特征码信息。

# 3.4 创建 RabbitMQ 服务

  1. 进入 集群管理 → 集群列表。

  2. 点击 快速部署 按钮。

  1. 选择中间件类型：ADMQ RabbitMQ。

  2. 选择集群模式：

    • 单机模式：单节点 Kafka

    • 集群模式：多节点，元数据共享

    • 镜像模式：多节点，数据自动同步

  1. 点击 开始部署，后端会自动开始部署任务 。

# 3.5 部署后状态

  • 集群列表显示新接入的集群，状态为 "正常"。

# 四、业务侧验证

在集群列表，点击右侧的【进入业务功能】可以跳转到资源管理页面。

# 4.1 创建虚拟主机（vhost）

# 4.2 创建用户

设置权限

# 4.3 创建交换机（Exchange）

在 test 下面新增交换机

# 4.4 创建队列（Queue）

# 4.5 创建绑定（Binding）

要注意设置路由键

# 4.6 发送测试消息并消费验证

在【资源管理】-【交换机管理】中选择 ex01，点击【发送消息】

在【资源管理】-【队列管理】，点击队列名称进入队列详情，点击【获取消息】，可以看到消息：

# 五、常见问题及处理

问题现象 可能原因 解决方法
测试连接失败 网络不通或端口未开放 检查防火墙、安全组，确保 15672/5672 端口可达
启动控制台报端口冲突 12306 端口被占用 修改 config/application.properties 中的 server.port，重启服务
创建资源时报 403 RabbitMQ 用户权限不足 使用 administrator 标签的用户，或授予 .* 权限
消息发送后队列无消息 路由 key 不匹配或绑定错误 检查交换机类型、路由 key 和绑定配置是否一致

# 技术支持

  • 电话：400-855-5800
  • 邮箱：support@apusic.com
编辑页面 (opens new window)
#快速使用手册

← 管控台用户手册→