Apache ActiveMQ Artemis 2.19.0 User Manual

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

摘要

文档详细介绍了Apache ActiveMQ Artemis 2.19.0版本及其相关功能。主要内容包括各个版本的更新亮点，如新功能、性能优化和安全性改进，以及如何进行版本升级。文档还提供了关于如何使用服务器、安装配置、目录结构、日志记录和安全机制的详细说明。特别提到了新版本的审计日志功能、SSL传输加密、JAAS安全管理和指标配置等关键特性。

AI总结

# Apache ActiveMQ Artemis 2.19.0 用户指南总结

## 1. 项目概述
Apache ActiveMQ Artemis 是一个高性能、多协议、可嵌入的异步消息系统，支持高可用性和灵活的集群配置。它基于 Java 8+ 开发，适用于从桌面到大型服务器的各种平台。

## 2. 主要功能
- **高可用性**：提供自动客户端故障转移，确保零消息丢失或重复。
- **高性能**：支持持久化消息和非持久化消息的高性能传输。
- **多协议支持**：支持 AMQP、STOMP、MQTT 等协议。
- **集群能力**：支持负载均衡和灵活的消息路由。
- **安全性**：提供基于 JAAS 的安全管理和 SSL 加密传输。

## 3. 版本更新亮点

### 2.19.0
- 新增通过管理 API 重放保留日志记录的功能。
- 支持通过环境变量或系统属性设置密码掩码的密钥。
- 新增 OFF WITH REDISTRIBUTION 类型，允许禁用消息负载平衡但仍支持重新分发。
- MQTT 会话状态自动清理功能，避免会话积累。
- 提供 Jakarta Messaging 3.0 客户端示例。

### 2.18.0
- 支持双镜像（Dual Mirror）用于灾难恢复。
- 集成 Zookeeper 进行副本保留和复制。
- 提供broker负载均衡功能。
- 支持XPath过滤表达式，与ActiveMQ Classic功能对齐。

### 2.6.0
- 支持正则表达式匹配客户端证书。
- 支持SASL_EXTERNAL机制。
- 提供虚拟主题映射和独占队列功能的示例。

### 2.5.0
- 支持独占消费者。
- 提供与ActiveMQ 5.x类似的虚拟主题命名能力。
- 支持 SSL 证书吊销列表。
- 支持 OpenWire 的最后值队列。
- 支持掩码密码在 bootstrap.xml 和 login.config 中的配置。
- 提供可配置的插件实现，用于记录各种 Broker 事件。

### 2.4.0
- 支持通过 XML 配置 JMX。
- 配置 STOMP WebSocket 的最大帧负载长度。
- 支持使用 JDBC 持久化进行高可用性配置。
- 实现基于角色的访问控制（RBAC）。

### 2.3.0
- 支持通过 XML 分片配置 Broker。

### 2.12.0
- 支持 SOCKS 代理。
- 支持大消息的 AMQP 支持。
- 自动创建死信队列和过期队列。
- 提供改进的队列创建 API。
- 支持通过环境变量覆盖 JVM 参数。
- 优化 Broker 启动时的堆内存使用。

## 4. 安装与目录结构
- **bin**：包含运行 Artemis 所需的二进制文件和脚本。
- **examples**：提供各种示例，帮助用户快速上手。
- **lib**：包含运行 Artemis 所需的 JAR 和库文件。
- **client**：提供客户端示例和文档。
- **web**： Broker 运行时的 Web 上下文加载目录。
- **schema**：包含 XML 模式文件，用于验证配置文件。
- **features**：包含各种功能模块的配置示例。

## 5. 使用说明
- **启动与停止 Broker**：通过脚本或命令行工具操作 Broker。
- **目录布局**：了解 Broker 实例的文件结构和用途。
- **配置管理**：通过 XML 或系统属性配置 Broker。

## 6. 升级注意事项
- **从 2.4.0 升级**：需要在 `artemis.instance/etc` 目录下创建 `management.xml` 文件。
- **从 2.3.0 升级**：确保 `artemis.instance/etc/management.xml` 文件存在。
- **审计日志配置**：在 `logging.properties` 中调整审计日志级别和输出方式。

## 7. 安全性
- **JAAS 安全管理器**：支持多种登录模块，提供灵活的安全认证。
- **基本安全管理器**：支持基于用户名和密码的认证，数据存储在 Broker 的绑定日志中。
- **已弃用的安全管理器**：读取 `artemis-users.properties` 和 `artemis-roles.properties` 文件进行认证。

## 8. 其他
- **审计日志**：默认情况下，审计日志级别为 ERROR，需手动调整以启用 INFO 级别。
- **许可证**：Apache License 2.0，免费使用和修改。

以上为《Apache ActiveMQ Artemis 2.19.0 User Manual》的主要内容总结，涵盖功能、安装、使用、升级和安全性等方面的重点信息。