Apache ActiveMQ Artemis 2.31.0 User Manual

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

摘要

Apache ActiveMQ Artemis 2.31.0是一个开源、多协议、可嵌入、高性能、集群化、异步消息系统。其管理API支持通过JMX、Jolokia、Core Client、JMS Client和Web Console等方式访问，所有方式功能相同。核心API提供了比JMS更简化的消息概念，包括消息、地址、队列、路由类型、持久性、优先级和过期时间等。OpenWire协议支持使ActiveMQ Classic JMS客户端可与Artemis服务器通信，并包含连接监控参数如maxInactivityDuration和useInactivityMonitor。服务器使用需先创建实例，升级时通过修改ARTEMIS_HOME属性链接到新版本。

AI总结

Apache ActiveMQ Artemis 2.31.0 是一个高性能、多协议、可嵌入的异步消息系统（消息中间件）。该手册核心内容涵盖其管理、核心API、协议支持及升级部署。

**1. 管理（Management）**
提供了丰富的管理API，可通过五种方式操作，功能相同：
- **JMX**：标准Java管理方式。
- **Jolokia**：通过HTTP接口暴露JMX API。
- **Core Client / JMS Client**：通过发送消息进行管理。
- **Web Console**：图形化界面。
- **核心接口**：管理操作基于 `ActiveMQServerControl` 等接口，可列出、创建、销毁队列等。

**2. 核心API（Core API）**
提供比JMS更简洁的API，核心概念包括：
- **消息**：包含主体（缓冲区）、属性（键值对）、地址、路由类型（单播/多播）、持久性、优先级、过期时间等。
- **大消息**：支持发送/消费超过内存容量的超大消息。

**3. 协议支持**
- **OpenWire**：支持与ActiveMQ “Classic” 客户端通信，默认端口61616。
- **连接监控**：通过 `maxInactivityDuration`（默认30秒）、`useInactivityMonitor` 等参数控制连接超时。
- **Advisories**：可禁用默认的 advisory 主题，以减少资源消耗和管理界面混乱。

**4. 升级与部署**
- **架构**：采用“Home”（共享资源）与“Instance”（实例）分离的模式，简化升级。
- **升级步骤**：主要修改实例配置中的 `ARTEMIS_HOME` 属性，指向新版本路径即可。
- **OSGi支持**：可在Apache Karaf容器中通过 `feature:install artemis` 安装和配置。

**5. 其他关键信息**
- **审计日志**：2.13.0版本起新增，默认过滤，需在 `logging.properties` 中配置 `AUDIT_FILE` 处理器。
- **性能优化**：2.13.0版本优化了内部对象 `HierarchicalObjectRepository` 的存储速度。
- **安装**：需先运行 `./bin/artemis create` 创建实例，目录包含 `bin`、`lib`、`schema`、`web` 等文件夹。