Apache ActiveMQ Artemis 2.31.2 User Manual

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

摘要

文档详细介绍了Apache ActiveMQ Artemis 2.31.2的功能、配置和使用方法。主要内容包括：作为消息中间件（MoM）的核心功能，支持多种协议（如JMS、AMQP、MQTT等），配置大消息存储目录以处理超过内存限制的消息，以及升级从旧版本到新版本的具体步骤。文档还提供了丰富的示例，涵盖消息确认、慢消费者检测、SSL配置等应用场景。

AI总结

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

#### 1. 项目概述
- **Apache ActiveMQ Artemis** 是一个开源的多协议、嵌入式、高性能的消息系统，支持集群和异步通信。
- 它属于消息中间件（MoM），主要用于实现应用程序之间的异步通信。
- 提供多种协议支持，包括 OpenWire、AMQP、MQTT、STOMP 等。
- 官方文档和下载地址：[https://activemq.apache.org/components/artemis/](https://activemq.apache.org/components/artemis/)。

#### 2. 大消息配置
- **大消息定义**：当消息大小超过配置阈值时，ActiveMQ Artemis 会将消息存储为文件，仅在队列中保留一个轻量对象。
- **配置参数**：
- `large-messages-directory`：指定大消息存储目录，默认为 `data/largemessages`。
- `large-message-table`：用于数据库持久化的表名，默认为 `LARGE_MESSAGE_TABLE`。
- **性能建议**：将大消息目录存储在与日志或分页目录不同的物理卷上，以提高性能。

#### 3. 协议支持
- **OpenWire**：支持 ActiveMQ "Classic" 客户端，兼容 5.12.x 及以上版本。
- **AMQP 1.0**：支持大消息和事务。
- **MQTT**：通过配置端口和协议参数启用。
- **STOMP**：支持 1.1 和 1.2 版本。
- **其他功能**：支持 SSL、SASL 外部认证、角色基于访问控制（RBAC）等。

#### 4. 升级指南
- **升级步骤**：
1. 导航到broker实例的 `etc` 文件夹，编辑 `artemis.profile`（或 `artemis.profile.cmd`，适用于 Windows）。
2. 更新 `ARTEMIS_HOME` 属性，指向新版本的 Artemis 安装路径。
- **注意事项**：
- 升级可能需要额外的配置步骤，具体取决于旧版本和新版本的差异。
- 建议参考官方文档中的版本升级说明。

#### 5. 其他功能
- **慢消费者检测**：支持配置慢消费者策略。
- **静态消息选择器**：支持通过 JMS 和核心协议配置静态消息过滤器。
- **Spring 集成**：提供嵌入式 JMS 示例。
- **SSL 配置**：支持通过 SSL 提供安全通信。
- **消息优先级**：支持 JMS 1.1 规范中的消息优先级，范围为 0（最低）到 9（最高）。

#### 6. 目录结构
- **安装目录结构**：
- `bin`：包含运行和脚本文件。
- `examples`：提供各种协议的示例。
- `lib`：包含运行所需的 JAR 和库文件。
- `schema`：包含 XML 配置文件的模式。

#### 7. 安全性
- 支持通过外部 Keycloak 实现 OAuth 认证。
- 支持 masked passwords 和角色基于访问控制（RBAC）。

#### 8. 管理功能
- 提供 JMX 配置和监控功能。
- 支持通过 JMS 消息进行管理操作和事件通知。

#### 9. 性能优化
- 支持将 broker.xml 配置文件拆分为多个文件。
- 提供增强的消息计数和大小指标，便于监控和优化。

总结：Apache ActiveMQ Artemis 2.31.2 是一个功能强大、高度可配置的消息系统，支持多种协议和高级功能，适用于高性能和高可用性的消息通信场景。