Apache ActiveMQ Artemis 2.31.0 User Manual

《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 的核心功能、配置方法、实用示例及升级注意事项，是使用和开发该系统的重要参考资源。