Apache ActiveMQ Artemis 2.36.0 User Manual

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

摘要

The document provides a comprehensive guide to Apache ActiveMQ Artemis 2.36.0, an open-source, high-performance, multi-protocol messaging system. It details the setup, configuration, and usage of the broker, including the use of the broker.xml configuration file and system property substitution. The manual also covers various use cases, such as running Artemis on Windows as a service and managing dependencies. Additionally, it includes release notes for different versions, highlighting features like MQTT 5 support, performance tools, and improvements in clustering and message routing. The document also addresses upgrading from previous versions and configuration changes required for compatibility.

AI总结

### Apache ActiveMQ Artemis 2.36.0 用户手册总结

#### 项目概述
- Apache ActiveMQ Artemis 是一个开源的多协议、嵌入式、高性能、集群式、异步消息系统。
- 它属于面向消息的中间件（MoM）。
- 提供邮件列表和项目官网（[https://activemq.apache.org/components/artemis/](https://activemq.apache.org/components/artemis/)）用于支持和下载。

#### 核心功能
- **Broker 配置**：配置文件 `broker.xml` 提供了丰富的配置选项，默认配置即可满足大多数需求。
- **系统属性替换**：支持在配置文件中使用系统属性（如 `${activemq.remoting.netty.host}`）来替代值，可设置默认值或强制使用系统属性。
- **Windows 服务**：支持在 Windows 上以服务形式运行，可通过命令行安装。

#### 性能与新功能
- **性能工具**：新增性能评估工具，用于测试吞吐量和响应时间。
- **MQTT 5 支持**：支持 MQTT 5 协议。
- **镜像功能**：支持镜像核心消息的原生格式传输，优化了镜像功能。
- **多地址 Divert**：Divert 现在支持多个地址。
- **配置热重载**：支持运行时重新加载配置，包括桥梁配置。
- **按消息计数分页**：新增按消息计数配置分页的功能。

#### 升级注意事项
- **从 2.20.0 升级**：
- 修改 `bootstrap.xml` 和 `management.xml` 中的 XML 命名空间（从 `activemq.org` 更改为 `activemq.apache.org`）。
- 如果使用 JDBC 持久化，需更新数据库列 `HOLDER_EXPIRATION_TIME` 从 `TIMESTAMP` 更改为 `BIGINT`。
- 如果使用 JGroups，则需更新配置文件，参考 JGroups 文档。
- **从 2.31.x 升级**：
- MQTT 订阅队列自动删除依赖新的 `defaultMqttSessionExpiryInterval` 配置。
- 配置元素（如 `master`、`slave` 等）已更新为新名称（如 `primary`、`backup`）。

#### 其他功能
- **日志管理**：支持通过 CLI 命令清空队列、配置日志记录和审计日志。
- **消费者优先级**：支持配置消费者优先级。
- **FQQN 支持**：生产者支持完整队列名称（FQQN）。
- **LDAP 登录模块**：支持 LDAP 连接池配置。
- **JGroups 支持**：更新至 5.x 版本，需参考新配置文档。

#### 实例创建与管理
- **Broker 实例**：建议将实例目录独立于主程序目录（如 `/var/lib/mybroker`），避免升级影响。
- **命令行工具**：提供用于日志配置重载、队列清理等操作的 CLI 工具。

#### 其他重要信息
- **隔离性重构**：改进了集群环境中的隔离机制，优化了“脑裂”问题的处理。
- **资源限制配置**：支持配置资源限制，可禁用服务器端消息负载均衡。

#### 总结
Apache ActiveMQ Artemis 2.36.0 提供了高性能、多协议的消息传递功能，支持灵活的配置和扩展。文档详细介绍了 Broker 配置、系统属性替换、性能优化工具、升级注意事项等关键内容，适用于开发人员和系统管理员。