Apache ActiveMQ Artemis 2.29.0 User Manual

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

摘要

文档主要介绍了Apache ActiveMQ Artemis 2.29.0版本的更新内容、安装配置、安全性增强以及与旧版本的兼容性。重点包括对Large Messages的改进、MBean访问权限的调整、SSL配置的优化、用户认证机制的增强，以及对旧版本升级时需要注意的关键事项。

AI总结

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

#### 1. 版本信息
- **2.29.0 版本亮点**：
- 重点改进了大消息（Large Messages）的测试和修复工作。
- 提供了详细的发布说明，包含已解决的所有问题。

- **升级注意事项**：
- **MBean 访问权限**：默认情况下，未在 `management.xml` 中定义的 MBean 访问权限为只读。若需要写入权限，需手动配置 `management.xml`。
- **地址定义**：`broker.xml` 中的地址定义必须指定路由类型（如 ``），否则 Broker 会拒绝配置。

#### 2. 安装指南
- **安装目录结构**：
- `bin`：包含运行 ActiveMQ Artemis 所需的二进制文件和脚本。
- `examples`：提供各种示例，帮助用户了解如何运行和使用 Broker。
- `lib`：包含运行 ActiveMQ Artemis 所需的 JAR 和库文件。
- `web`：Web 服务上下文加载的目录，包含 API 文档和用户指南。

- **运行环境**：
- Java 11+ 是运行 ActiveMQ Artemis 的最低要求。

#### 3. 安全配置
- **安全管理器**：
- **ActiveMQJAASSecurityManager**：默认安全组件，支持 JAAS 登录模块（如属性文件、LDAP、SSL 证书等）。
- **ActiveMQBasicSecurityManager**：基于用户名和密码的身份验证，支持通过管理 API 添加、删除和更新用户。
- **ActiveMQSecurityManagerImpl**：已弃用，基于属性文件 `artemis-users.properties` 和 `artemis-roles.properties`。

- **SSL 传输**：
- 支持通过 SSL 加密在不安全网络中传输消息，具体配置可参考文档。

#### 4. 用户认证
- **权限映射**：
- 从 ActiveMQ 5.x 到 Artemis 的权限映射：
- `read` 映射为 `consume` 和 `browse`。
- `write` 映射为 `send`。
- `admin` 映射为地址和队列管理权限（如 `createAddress`、`createDurableQueue` 等）。
- 若启用 `mapAdminToManage`，`admin` 权限将映射为 `manage` 权限。

#### 5. 其他重要信息
- **REST 模块移除**：
- 2.26.0 版本移除了 ActiveMQ-Artemis 的 REST 模块，用户可从 Maven 中央仓库获取旧版本。

- **Web 内容调整**：
- 2.25.0 版本起，Web 内容从分布中移除，所有 Web 请求重定向到控制台。若需自定义 Web 内容，需修改 `bootstrap.xml` 配置。

- **性能优化**：
- 支持按消息数量配置分页缓存。
- 支持 JDBC 持久化和计划消息。

#### 6. 总结
- Apache ActiveMQ Artemis 是一个高性能、多协议的 messaging system，支持嵌入式部署和高可用性集群。
- 2.29.0 版本重点改进了大消息处理和安全性，同时提供了对旧版本的兼容性和性能优化。
- 用户在升级时需注意 MBean 访问权限和地址定义的变更，并确保 Java 环境满足要求。