Quick Start

# Preface

This document is a quick start guide for Kingdee Apusic Distributed Message Queue for RabbitMQ (Apusic Distributed Message Queue, referred to as: ADMQ for RabbitMQ), providing product introduction, basic steps for installing and deploying the product, and verification methods.

# Target Audience

This document is intended for IT information business leaders, R&D managers, software project managers, software architects, and operations engineers.

For more information about ADMQ for RabbitMQ, please refer to the following ADMQ for RabbitMQ product documentation set:

No. Document Description
1 Kingdee Apusic Distributed Message Queue for RabbitMQ Quick Start Guide Briefly introduces how to get started with ADMQ for RabbitMQ.
2 Kingdee Apusic Distributed Message Queue for RabbitMQ Installation Guide Details how to install ADMQ for RabbitMQ on various operating systems, including starting and stopping the ADMQ for RabbitMQ service.
3 Kingdee Apusic Distributed Message Queue for RabbitMQ Message Engine User Guide Details the usage, configuration, management, and companion tools of the ADMQ for RabbitMQ message engine.
4 Kingdee Apusic Distributed Message Queue for RabbitMQ Console User Guide Details the usage and operation of the ADMQ for RabbitMQ console.
5 Kingdee Apusic Distributed Message Queue for RabbitMQ Development Guide Details how to develop ADMQ for RabbitMQ client applications in various languages.
6 Kingdee Apusic Distributed Message Queue for RabbitMQ Migration Guide Details the migration process from RabbitMQ to ADMQ for RabbitMQ.
7 Kingdee Apusic Distributed Message Queue for RabbitMQ Operations Guide Details the monitoring, operations, and security hardening of ADMQ for RabbitMQ.
8 Kingdee Apusic Distributed Message Queue for RabbitMQ Performance Tuning Guide Details performance tuning for ADMQ for RabbitMQ.

# Technical Support

ADMQ for RabbitMQ provides comprehensive technical support services. You can obtain technical support through the following channels:

  • Website: www.apusic.com
  • Phone: 400-855-5800
  • Email: support@apusic.com
  • Kingdee Cloud Community: https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

When requesting technical support, please provide the following information:

  1. Your name

  2. Company information and contact details

  3. Operating system and version

  4. Product version number

  5. Detailed logs, screenshots, and other information regarding the error or exception

# ADMQ Console Deployment

# 1. Preparation

# 1.1 Environment Requirements

  • Operating System: CentOS 7+ / Ubuntu 18.04+, recommended 4 cores 8GB or more

  • Network: Network connectivity between the console platform and RabbitMQ nodes (ports: 15672 management port, 5672 service port)

# 1.2 Installation Package

  • Obtain the management console installation package: admq-manager-V3.0.2.tar.gz (please contact technical support to obtain)

  • Upload the installation package to the target server (e.g., /opt directory)

# 2. Deploying the Management Console

# 2.1 Extract the Installation Package

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

# 2.2 Start the Console

bin/admq-service start
1

Verify startup:

bin/admq-service status
1

Seeing ADMQ Manager is running indicates success.

# 2.3 Access the Console

  • Browser access: https://<Console IP>:12306

  • Default credentials: admq / 11111111 (please change the password upon first login)

# 2.4 Initialize Default Configuration

Run on the server:

bin/init all
1

# 3. Deploying the RabbitMQ Service (via Management Console)

# 3.1 Upload License File

Upload the license file in Resource Management → License Management.

# 3.2 Upload Software Package

  1. Log in to the management console, go to the Resource Management menu.

  2. Upload:

    • Software package: admq-rabbitmq-<version>.tar.gz (platform pre-configured or custom)
  1. Wait for the upload to complete and verification to succeed.

# 3.3 Add Server

In Resource Management → Server Management, add a server. After adding, the agent program will be automatically deployed on the server.

Once successful, the added record will be displayed. It will periodically fetch server CPU and memory status, and obtain the license feature code. If applying for an official license, you need to provide the feature code information here.

# 3.4 Create RabbitMQ Service

  1. Go to Cluster Management → Cluster List.

  2. Click the Quick Deploy button.

  1. Select middleware type: ADMQ RabbitMQ.

  2. Select cluster mode:

    • Standalone Mode: Single node

    • Cluster Mode: Multiple nodes, shared metadata

    • Mirror Mode: Multiple nodes, automatic data synchronization

  1. Click Start Deployment, and the backend will automatically begin the deployment task.

# 3.5 Post-Deployment Status

  • The cluster list displays the newly connected cluster with the status "Normal".

# 4. Business-Side Verification

In the cluster list, click "Enter Business Functions" on the right to navigate to the resource management page.

# 4.1 Create Virtual Host (vhost)

# 4.2 Create User

Set permissions

# 4.3 Create Exchange

Add a new exchange under test

# 4.4 Create Queue

# 4.5 Create Binding

Ensure the routing key is set

# 4.6 Send Test Message and Verify Consumption

In Resource Management → Exchange Management, select ex01 and click Send Message.

In Resource Management → Queue Management, click the queue name to enter queue details, click Get Messages to view the message:

# 5. Common Issues and Solutions

Issue Possible Cause Solution
Test connection fails Network unreachable or port not open Check firewall and security groups to ensure ports 15672/5672 are reachable
Console startup port conflict Port 12306 is occupied Modify server.port in config/application.properties, restart the service
403 error when creating resource Insufficient RabbitMQ user permissions Use a user with the administrator tag, or grant .* permissions
No messages in queue after sending Routing key mismatch or binding error Check exchange type, routing key, and binding configuration consistency

# Technical Support

  • Phone: 400-855-5800
  • Email: support@apusic.com
编辑页面 (opens new window)
#快速使用手册

← Console User Manual→