快速使用手册

# 前言

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

# 适用对象

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

# 相关文档

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

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

# 技术支持

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

  • 网址：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. 出现异常及错误的日志、截图等详细信息

# 部署

# 准备工作

# 环境要求

  • 操作系统：CentOS 7+ / Ubuntu 18.04+，建议 4 核 8GB 以上
  • 网络：管控平台与 Kafka 节点之间网络互通

# 获取安装包

  • 获取管理控制台安装包：ADMQ-manager-V2.0.6.20260601-x86_64.tar.gz`（请联系技术支持获取）
  • 将安装包上传至目标服务器（如 /opt 目录）

# 部署管理控制台

# 解压安装包

tar zxvf ADMQ-manager-V2.0.6.20260601-x86_64.tar.gz -C /opt/
cd /opt/admq-manager-V2.0.6
1
2

# 启动控制台

bin/admq-service start
1

验证启动：

bin/admq-service status
1

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

# 访问控制台

  • 浏览器访问：https://<控制台IP>:12306
  • 默认账号：admq / 11111111（首次登录请修改密码）

# 初始化默认配置

在服务器执行

bin/init all
1

# 部署 ADMQ for Kafka

# 上传授权文件

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

# 上传软件包

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

  2. 上传：

    • 软件包：admq-kafka-<version>.tar.gz（平台预置或自定义）

  3. 等待上传完成并校验成功。

# 添加服务器

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

成功后可在服务器列表看到添加的记录：

会定时获取服务器cpu、内存状态，并获取授权特征码，如果申请正式授权，需要提供这里的特征码信息。

# 快速部署

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

  2. 点击 快速部署 按钮。

  3. 选择中间件类型：ADMQ Kafka。

  4. 选择集群模式：

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

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

# 部署后状态

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

# 验证

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

# 创建主题

在【资源管理】-【主题】页面创建主题：test

# 发送测试消息

在【资源管理】-【主题】中选择 test，点击【发送消息】

# 常见问题及处理

问题现象 可能原因 解决方法
测试连接失败 网络不通或端口未开放 检查防火墙、安全组，确保 15672/5672 端口可达
启动控制台报端口冲突 12306 端口被占用 修改 config/application.properties 中的 server.port，重启服务
编辑页面 (opens new window)
#快速使用手册

← 管控台用户手册→