Apache ActiveMQ Artemis 2.32.0 User Manual

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

摘要

This document provides an in-depth guide to Apache ActiveMQ Artemis 2.32.0, a high-performance, multi-protocol messaging system. It covers key features such as message-oriented middleware functionality, high availability, clustering, and support for various protocols like AMQP, MQTT, and OpenWire. The manual includes details on installation, configuration, upgrading from previous versions, and examples demonstrating broker and client features. It also highlights performance improvements, security enhancements, and seamless integration capabilities.

AI总结

### Apache ActiveMQ Artemis 2.32.0 用户手册总结

#### 1. 项目概述
- **Apache ActiveMQ Artemis** 是一个开源的多协议、嵌入式、高性能、集群化、异步的消息系统。
- 它是面向消息的中间件（MoM）的一个示例，支持多种协议（如AMQP、OpenWire、STOMP、MQTT）。
- 提供高可用性和灵活的集群功能，支持自动客户端故障转移和消息负载均衡。

#### 2. 主要功能
- **高性能**：提供持久化和非持久化消息的高性能处理。
- **高可用性**：支持自动客户端重新连接和零消息丢失。
- **多协议支持**：支持多种消息协议，满足不同应用场景的需求。
- **嵌入式和可扩展性**：可嵌入到现有系统或作为独立服务器运行。
- **安全性**：支持基于角色的访问控制（RBAC）、SSL证书认证和多种JAAS登录模块。

#### 3. 版本更新亮点
##### 2.32.0 版本
- **新功能**：
- 支持独占消费者（Exclusive Consumers）。
- 提供虚拟主题命名能力（等效于ActiveMQ "Classic"）。
- 支持SSL证书吊销列表。
- 支持OpenWire的最后一值队列（Last-Value Queues）。
- 支持在`bootstrap.xml`和`login.config`中使用掩码密码。
- 可配置的日志记录插件（如`LoggingActiveMQServerPlugin`）。
- 支持将`broker.xml`拆分成多个文件。
- 增强了队列的消息计数和大小指标。

##### 2.5.0 版本
- **新功能**：
- 通过XML配置JMX，而非通过命令行或启动脚本的系统属性。
- 支持通过STOMP WebSocket配置最大帧负载长度。
- 支持使用JDBC持久化进行高可用性配置。
- 实现基于角色的JMX管理对象访问控制。

##### 1.1.0 版本
- **新功能**：
- 支持MQTT协议。
- 提供新的CLI工具，支持生产环境中的服务器创建、启动和停止。
- 改进用户界面和日志记录功能。
- 支持配置资源限制和禁用服务器端消息负载均衡。

#### 4. 升级指南
- **从2.4.0升级到2.32.0**：
- 修改接受器URL，确保兼容HornetQ和Artemis 1.x客户端。
- 配置`anycastPrefix`和`multicastPrefix`。
- **从2.3.0升级到2.4.0**：
- 创建`management.xml`文件，配置基于角色的JMX授权。
- 移除旧的Jolokia WAR文件。

#### 5. 使用服务器
- **安装**：
- 下载最新版本，解压后进入`${ARTEMIS_HOME}`目录。
- 重要文件夹包括`bin`（运行脚本）、`lib`（依赖库）、`schema`（XML模式）和`web`（Web上下文）。
- **创建 Broker 实例**：
- 建议不在`${ARTEMIS_HOME}`下创建实例，以方便后续升级。
- 示例：在Unix系统中，实例可存放在`/var/lib/mybroker`。

#### 6. 示例
- **示例仓库**：
- 提供90多个示例，展示broker和客户端功能。
- 示例按功能分类：`clustered`（负载均衡）、`ha`（故障转移）、`perf`（性能测试）、`standard`（标准功能）。
- 协议分类：`amqp`、`mqtt`、`openwire`、`stomp`。
- **运行示例**：
- 使用`mvn clean package`生成broker分布。
- 进入示例目录，使用`mvn verify`或`mvn install`运行。
- 支持不启动服务器运行示例（使用`-PnoServer`配置）。

#### 7. 法律声明
- 软件遵循Apache License 2.0协议，允许自由使用、修改和分发。
- 详细版权声明请参考随附的`NOTICE`文件。

#### 总结
Apache ActiveMQ Artemis 是一个功能强大、灵活且高性能的消息中间件，适用于需要高可用性和多协议支持的分布式系统。其最新版本（2.32.0）引入了多项重要改进，包括高可用性、安全性增强和性能优化。通过丰富的示例和详细的文档，用户可以快速上手并充分利用其功能。