Apache ActiveMQ Artemis 2.35.0 User Manual

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

摘要

《Apache ActiveMQ Artemis 2.35.0 User Manual》详细介绍了Apache ActiveMQ Artemis 2.35.0的功能、协议支持、安装配置、安全性配置以及版本升级等内容。Apache ActiveMQ Artemis 是一个开源的多协议、嵌入式、高性能、集群式、异步消息系统，支持多种协议如AMQP、MQTT、STOMP和OpenWire。文档还提供了安全性配置示例，包括基于角色的访问控制、LDAP集成和OAuth支持。此外，还介绍了如何使用高级特性如慢消费者检测、异步发送确认和静态消息选择器。

AI总结

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

#### 1. 项目概述
- **Apache ActiveMQ Artemis** 是一个开源的多协议、嵌入式、高性能、集群式、异步的消息系统。
- 它是一个消息导向中间件（MoM）的示例，支持多种协议和插件架构。
- 提供邮件列表和技术支持，项目主页和下载地址分别为 [https://activemq.apache.org/components/artemis/](https://activemq.apache.org/components/artemis/) 和 [https://activemq.apache.org/components/artemis/download/](https://activemq.apache.org/components/artemis/download/)。

#### 2. 核心功能
- **协议支持**：支持 AMQP 1.0、MQTT 3.1/3.1.1/5、STOMP 1.0/1.1/1.2 以及 OpenWire。
- **安全性**：支持基于角色的访问控制（RBAC），可与 LDAP 和 Keycloak 集成，提供 OAuth 和直接访问权限。
- **性能优化**：支持预确认模式、慢消费者检测和处理策略，以及异步发送确认功能。
- **扩展性**：支持插件架构，允许扩展协议和功能模块。

#### 3. 安装与使用
- **安装**：将 ActiveMQ Artemis 解压到目标目录，推荐将实例目录与主目录分离，便于升级和管理。
- **运行**：通过命令行运行 `./bin/artemis create` 创建实例，并启动 broker。
- **目录结构**：
- `bin`：包含运行脚本。
- `lib`：包含依赖库。
- `schema`：包含 XML 配置文件的模式。
- `web`：包含 Web 控制台相关文件。

#### 4. 升级指南
- **升级步骤**：
1. 修改 `artemis.profile` 或 `artemis.profile.cmd` 文件中的 `ARTEMIS_HOME` 属性，指向新版本的主目录。
2. 更新 `artemis-service.xml` 中的 `ARTEMIS_HOME` 属性（适用于 Windows 服务）。
3. 参考版本文档中的具体升级说明。
- **注意事项**：升级时需注意配置文件的兼容性和插件的更新。

#### 5. 高可用性与扩展性
- **镜像与复制**：支持镜像和复制功能，确保高可用性和数据一致性。
- **负载均衡**：支持通过 STOMP 和 AMQP 等协议实现负载均衡和集群扩展。

#### 6. 在 Apache Karaf 上的安装
- **安装步骤**：
1. 添加 Artemis 特性仓库：`feature:repo-add mvn:org.apache.activemq/artemis-features/1.3.0-SNAPSHOT/xml/features`。
2. 安装 Artemis 特性：`feature:install artemis`。
- **配置**：通过 `artemis.cfg` 文件配置broker，支持自定义日志格式和插件扩展。

#### 7. 版本更新亮点
- **2.35.0 版本**：
- 修复了大消息复制的回归问题。
- 迁移到 JUnit 5。
- **2.34.0 版本**：
- 提升镜像和分页性能。
- 增加安全事件统计和复制状态指标。
- 支持 SOCKS 代理和自动生成死信队列。

#### 8. 其他功能
- **SSL 支持**：通过配置 SSL 实现安全通信。
- **静态消息选择器**：支持基于过滤器的静态消息选择器，可直接应用于核心队列或 JMS 队列。
- **慢消费者检测**：自动检测和配置慢消费者策略，防止资源耗尽。

#### 9. 总结
Apache ActiveMQ Artemis 是一个功能强大且灵活的消息中间件，支持多种协议和插件扩展，适合高性能和高可用性的应用场景。其分离的主目录和实例目录设计使得升级和维护更加简便。通过合理的配置和插件扩展，可以满足不同场景的需求。