快速入門

# 前言

本文檔為金蝶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. 點選 開始部署，後端會自動開始部署任務。

# 部署後狀態

  • 叢集列表顯示新接入的叢集，狀態為 "正常"。

image-20260922171655864

# 驗證

在叢集列表，點選右側的【進入業務功能】可以跳轉到資源管理頁面。

# 建立主題

在【資源管理】-【主題】頁面建立主題：test

image-20260922171930172

# 傳送測試訊息

在【資源管理】-【主題】中選擇 test，點選【傳送訊息】

image-20260922172017487

# 常見問題及處理

問題現象 可能原因 解決方法
測試連接失敗 網路不通或連接埠未開放 檢查防火牆、安全群組，確保 15672/5672 連接埠可達
啟動控制台報連接埠衝突 12306 連接埠被佔用 修改 config/application.properties 中的 server.port，重新啟動服務
编辑页面 (opens new window)
#快速使用手册

← 管控台使用者手冊→