Apache ActiveMQ Artemis 2.31.0 User Manual

• 语言: 英语
• 格式: .pdf
• 来源: activemq.apache.org

摘要

Table of Contents 1. General Project Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Why use Apache ActiveMQ Artemis? . . . . . . . . . . . . . . . . . . . .

AI总结

《Apache ActiveMQ Artemis 2.31.0 User Manual》摘要：

### 1. 项目概述
Apache ActiveMQ Artemis是一个开源的、支持多协议、高性能、集群化的异步消息系统，属于面向消息的中间件（Message Oriented Middleware, MoM）。其 официальный网站为 [https://activemq.apache.org/components/artemis/](https://activemq.apache.org/components/artemis/)，提供了下载、文档和社区支持资源。

---

### 2. 安装与使用
- **安装**：从官方下载页面获取最新版本，并解压到指定目录 `${ARTEMIS_HOME}`。安装包包含多个重要目录：
- `bin`：运行ActiveMQ Artemis的二进制文件和脚本。
- `examples`：各种示例代码。
- `lib`：运行所需的库和依赖。
- `etc`：配置文件目录。
- `web`：Web控制台资源。

- **运行服务器**：通过命令行工具（`artemis`）启动和管理服务器。支持两种模式：
- **传统命令行**：执行特定命令，如 `./artemis producer` 发送消息。
- **交互式Shell**：提供更便捷的命令行环境，适合交互式操作。

---

### 3. 配置与示例
文档提供了大量示例，涵盖了 ActiveMQ Artemis 的主要功能和配置，包括：
- **安全配置**：支持 OAuth 和 SSL 传输，示例展示了如何集成 Keycloak 进行身份验证。
- **消息管理**：如慢消费者检测、消息分页（支持大内存队列）、消息过期配置、静态消息选择器等。
- **协议支持**：包括 STOMP（1.1、1.2）、MQTT 5、HTTP Transport 等协议的配置示例。
- **集群与分布式**：队列消息重新分配、消费者排他队列等集群场景的应用。
- **性能优化**：消息生产者速率限制、性能评估工具等。

---

### 4. 升级说明
从 2.20.0 升级至 2.31.0 时需注意以下关键点：
1. **XML 配置更新**：将 XML命名空间 `activemq.org` 更改为 `activemq.apache.org`。
2. **数据库更新**：JDBC 持久化用户需修改 `NODE_MANAGER_STORE` 表，将 `HOLDER_EXPIRATION_TIME` 列从 `TIMESTAMP` 更改为 `BIGINT`（或 Oracle 的 `NUMBER(19)`）。
3. **JGroups 配置**：JGroups 由 3.x 升级至 5.x，需手动更新配置文件。

---

### 5. 新功能与改进
- 支持 MQTT 5 协议。
- 新增性能评估工具，便于测试吞吐量和响应性能。
- 分流（Diverts）支持多地址配置。
- 分页功能可按消息数量配置。

---

### 6. 命令行工具
ActiveMQ Artemis 提供命令行界面（CLI）和交互式 Shell，便于管理和监控消息系统。支持的功能包括：
- 创建和升级 Broker 实例。
- 消费消息、转移消息、浏览队列。
- 密码加密、性能测试等。

---

### 7. 其他
- **问题反馈**：用户可通过邮件列表联系社区获取支持。
- **资源适配器**：提供了如何构建 ActiveMQ 资源适配器（RAR）的示例，便于部署在其他应用服务器上。

---

本手册详细介绍了 ActiveMQ Artemis 的核心功能、配置方法、实用示例及升级注意事项，是使用和开发该系统的重要参考资源。