Apache ActiveMQ Artemis 2.23.1 User Manual

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

摘要

Apache ActiveMQ Artemis 是一个开源的多协议嵌入式高性能消息系统，支持高可用性和灵活的集群配置。文档详细介绍了如何使用 ActiveMQ Artemis 服务器，包括安装、配置、启动和停止操作，以及目录布局和文件功能。此外，文档还涵盖了版本升级注意事项，如 XML 方案更改和数据库更新，以及新功能和改进，如 MQTT 5 支持、性能工具添加和消费者优先级实现。

AI总结

### Apache ActiveMQ Artemis 2.23.1 用户指南总结

#### 1. 什么是 Apache ActiveMQ Artemis？
- Apache ActiveMQ Artemis 是一个高性能、多协议的嵌入式消息中间件。
- 支持高可用性和灵活的集群配置，提供自动客户端故障转移，确保零消息丢失或重复。
- 支持多种协议，如 OpenWire、AMQP 1.0 和 MQTT。

#### 2. 安装与配置
- **关键文件夹**：
- `bin`：包含运行 ActiveMQ Artemis 所需的二进制文件和脚本。
- `lib`：包含运行所需的 JAR 和库文件。
- `examples`：提供各种示例，展示如何运行和配置 ActiveMQ Artemis。
- `web`：Web 上下文加载目录，包含 API 文档和用户手册。
- **运行与停止**：文档详细说明了如何启动和停止服务器，并介绍了目录布局和文件用途。

#### 3. 创建 Broker 实例
- 支持从旧版本升级，需注意以下事项：
- 更新 `etc/bootstrap.xml` 和 `etc/management.xml` 中的 XML 命名空间，从 `activemq.org` 更新为 `activemq.apache.org`。
- 如果使用 JDBC 持久化，需更新数据库列 `HOLDER_EXPIRATION_TIME` 从 `TIMESTAMP` 更改为 `BIGINT`（或 `NUMBER(19)` 在 Oracle 中）。

#### 4. 版本更新亮点
- **2.23.0 版本**：
- 支持嵌入式 Web 服务器的管理操作。
- 增加对 JakartaEE 10 的支持。
- 修复高 CPU 使用率问题（ReadWrite 锁相关）。
- **2.22.0 版本**：
- 默认生产者窗口大小从 `cluster-connection` 更改为 1MB，以避免高延迟环境中的 `OutOfMemoryError`。
- **2.21.0 版本**：
- 支持 MQTT 5.0。
- 新增性能工具，用于评估系统在高负载下的吞吐量和响应能力。
- **2.19.0 版本**：
- 新增通过管理 API 回放保留日志记录的功能。
- 支持禁用消息负载均衡但仍允许重新分发。
- **2.7.0 版本**：
- 支持 ActiveMQ 5.x 的高级目标选项，如 `consumersBeforeDispatchStarts` 和 `timeBeforeDispatchStarts`。
- 新增 CLI 命令用于清空队列。
- **2.6.0 版本**：
- 支持正则表达式匹配客户端证书。
- 新增对 AMQP 客户端的 SASL_EXTERNAL 支持。
- **1.0.0 版本**：
- 首次发布，功能与 ActiveMQ 5.x 对齐，包括 OpenWire 支持、AMQP 1.0 支持等。

#### 5. 其他注意事项
- **性能优化**：
- 支持按消息数量配置分页。
- 提供性能工具用于评估系统在高负载下的表现。
- **故障排除**：
- 文档提供了一些基本的故障排除方法和重启顺序。
- **兼容性**：
- Java 11 及以上版本为强制要求。
- 支持多种登录模块，如 LDAP、SSL 证书和 Properties 文件。

#### 6. 总结
Apache ActiveMQ Artemis 是一个功能丰富、高性能的消息中间件，适用于需要高可用性和灵活集群配置的场景。文档提供了详细的安装、配置和升级指南，同时强调了版本更新中的重要功能和改进。用户应特别注意从旧版本升级时的 XML 配置和数据库调整，以确保系统平稳运行。