Apache ActiveMQ Artemis 2.10.0 User Manual

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

摘要

The document provides a comprehensive guide on using Apache ActiveMQ Artemis, including installation, creating broker instances, configuring acceptors for different protocols, and managing server configurations. It covers supported protocols such as AMQP, OpenWire, MQTT, STOMP, and HornetQ, and details how to configure transports and acceptors. The document also includes release notes, upgrade instructions, and management features like address and queue management, transaction handling, and message counters.

AI总结

《Apache ActiveMQ Artemis 2.10.0 用户手册》主要内容总结如下：

### 1. 服务器使用基础
- **启动与停止**：介绍了如何启动和停止 Apache ActiveMQ Artemis 服务器，并说明了默认配置下的运行模式。
- **目录结构**：默认情况下，服务器的运行数据和配置文件位于 `${ARTEMIS_HOME}` 目录，建议将实例目录 (`broker instance`) 独立于主目录，便于升级和维护。

### 2. 安装与配置
- **重要文件夹**：
- `bin`：包含运行 ActiveMQ Artemis 所需的二进制文件和脚本。
- `examples`：提供多种示例，帮助用户快速上手。
- `lib`：存放运行 ActiveMQ Artemis 所需的 JAR 和库文件。
- `schema`：包含用于验证配置文件的 XML 模式。
- `web`：Web 应用程序的上下文加载目录，包括 API 文档和用户手册。

### 3. 协议与互操作性
- **支持的协议**：
- AMQP OpenWire
- MQTT
- STOMP
- HornetQ
- **API 支持**：
- JMS 2.0 API：基于核心协议实现，支持客户端通过 JNDI 进行连接。
- REST 消息接口：提供基于 HTTP 的消息管理能力。

### 4. 配置与管理
- **配置接受器**：
- 通过配置接受器 URL 启用特定协议，支持按端口启用多个协议。
- 示例：
- 启用 MQTT：`tcp://localhost:1883?protocols=MQTT`
- 启用 MQTT 和 AMQP：`tcp://localhost:5672?protocols=MQTT,AMQP`
- 启用所有协议：`tcp://localhost:61616`

- **管理功能**：
- **地址管理**：支持修改地址的权限和角色。
- **队列管理**：提供创建、删除、查询队列功能，支持按过滤条件清理消息。
- **事务管理**：支持处理未决事务，包括提交、回滚和查询 heuristic 事务。
- **消息计数器**：可启用车消息计数器，并支持重置计数器和历史数据。

### 5. 版本更新与升级
- **2.10.0 主要特性**：
- 支持更多协议和插件。
- 提升性能和稳定性。
- 增强安全性，支持 SSL 证书撤销列表。
- 支持虚拟主题命名和队列管理。

- **升级注意事项**：
- 从旧版本升级时需注意配置文件的兼容性。
- 特别是从 2.4.0 升级到 2.5.0 时，需调整 JMX 配置和 HornetQ 兼容性设置。

### 6. 其他重要功能
- **管理控制接口**：
- 提供 `ActiveMQServerControl` 接口，用于获取服务器版本、配置和状态信息。
- 支持远程连接管理、核心桥接和中继功能的创建与销毁。

- **Web 管理控制台**：
- 提供基于 Web 的管理界面，集成 Jolokia REST 接口，便于监控和管理。

### 总结
Apache ActiveMQ Artemis 2.10.0 是一个功能强大、高度可定制的消息中间件，支持多种协议和插件扩展，适合分布式系统中的消息传递和事务管理。文档详细介绍了服务器的使用、配置、管理和升级方法，同时提供了丰富的示例和工具，帮助用户快速上手并高效使用该产品。