ActiveMQ Artemis 2.27.1 Documentation

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

摘要

文档详细介绍了ActiveMQ Artemis 2.27.1版本的更新内容，包括新功能、性能改进和升级注意事项。主要更新包括引入新的性能评估工具、支持多地址的Diverts、运行时配置重新加载、改进的日志记录机制（使用SLF4J和Log4J 2），以及对JDBC持久化和JGroups配置的更新。文档还提供了详细的升级步骤，确保用户能够顺利迁移现有配置到新版本。

AI总结

### ActiveMQ Artemis 2.27.1 文档总结

#### 1. 新功能与改进
- **性能工具**：新增性能评估工具，支持吞吐量和负载下响应时间的测试。
- **Diverts 多地址支持**：支持配置多个地址。
- **运行时配置重新加载**：支持桥接（bridges）的运行时配置重新加载。
- **分页配置**：新增基于消息数量的分页配置功能。

#### 2. 升级注意事项
- **XML 命名空间变更**：在 `bootstrap.xml` 和 `management.xml` 中将 XML 命名空间从 `activemq.org` 更新为 `activemq.apache.org`。
- **JDBC 持久化更新**：由于 `ARTEMIS-3679` 的变更，`NODE_MANAGER_STORE` 表的 `HOLDER_EXPIRATION_TIME` 列从 `TIMESTAMP` 变为 `BIGINT`（或 `NUMBER(19)` 在 Oracle 中）。需要手动更新数据库或停止 Broker 后删除表，重启后会自动重建。
- **JGroups 更新**：从 3.x 升级到 5.x，配置文件格式发生变化，需参考 JGroups 官方文档更新配置。

#### 3. 版本兼容性
- **Java 11 要求**：从 2.20.0 版本开始，Java 11 成为硬性要求。
- **SLF4J 和 Log4J 2**：从 2.27.0 版本开始， Broker 使用 SLF4J 作为日志 API，并采用 Log4J 2 作为日志实现。

#### 4. 其他重要功能
- **回放日志记录**：支持通过管理 API 回放保留的 journal 记录。
- **自动清理 MQTT 会话**：在客户端未清理会话时，自动清理 MQTT 会话状态。
- **环境变量密码掩码**：新增环境变量或系统属性来设置密码掩码。
- **消息负载平衡**：支持禁用消息负载平衡同时允许重新分发。

#### 5. 安装与使用
- **目录结构**：
- `bin`：包含运行 Broker 的二进制文件和脚本。
- `examples`：提供各种示例，涵盖 JMS、AMQP 等协议的使用场景。
- `lib`：包含运行 Broker 所需的 JAR 和库文件。
- `schema`：包含 XML 配置文件的验证 schema。
- **Broker 实例创建**：建议将 Broker 实例目录与主目录分离，便于后续升级。

#### 6. 其他版本亮点
- **2.20.0**：引入升级工具，支持从旧版本平滑迁移。
- **2.7.0**：支持高级目的地选项（如 `consumersBeforeDispatchStarts` 和 `timeBeforeDispatchStarts`）。
- **2.6.x**：主要为修复版本，包含一些改进但无重大新功能。

#### 7. 使用注意事项
- 升级时需备份现有配置文件，部分自定义配置可能丢失，需手动恢复。
- 使用新版本前，建议详细阅读升级说明并测试环境。

总结：ActiveMQ Artemis 2.27.1 版本在性能、功能和易用性方面均有显著提升，但升级时需注意配置文件和数据库的兼容性问题。