Apache ActiveMQ Artemis 2.34.0 User Manual

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

摘要

The document provides an in-depth guide to Apache ActiveMQ Artemis 2.34.0, covering its architecture, installation, configuration, management, and upgrade procedures. It highlights key features such as high performance, multi-protocol support, clustering, and resiliency. The document also includes detailed instructions for creating broker instances, managing resources through various APIs, and upgrading from previous versions. Key updates include improvements in mirroring, performance optimizations, and enhanced security metrics.

AI总结

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

#### 1. 项目概述
- Apache ActiveMQ Artemis 是一个开源的多协议、嵌入式、高性能、集群化、异步的消息系统。
- 它属于消息中间件（MoM）的一种，支持多种协议（如 OpenWire、AMQP 1.0、MQTT 等）。
- 项目主页：[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/)
- 代码仓库：[https://github.com/apache/activemq-artemis](https://github.com/apache/activemq-artemis)

#### 2. 2.34.0 版本亮点
- **高可用性增强**：镜像核心消息的性能和稳定性得到提升。
- **网络隔离与分裂脑问题**：文档进行了重构，提升了清晰度和全面性。
- ** MQTT 支持**：会话过期自动删除订阅队列。
- **语言包容性**：更新为更包容的语言定义。
- **性能工具**：新增了性能评估工具，支持通过负载测试评估吞吐量和响应能力。
- **多地址支持**：Diverts 现在支持多个地址。
- **配置热重载**：支持动态重新加载桥梁配置。
- **分页优化**：支持按消息数量配置分页。

#### 3. 升级注意事项
- **从 2.33.0 升级**：
- **LDAP 登录模块**：连接池功能不再支持，建议使用 `defaultMqttSessionExpiryInterval` 配置。
- **Web 控制台**：新增对内部对象的报告功能，管理员需重新评估授权策略。
- **CLI 工具输出**：`./artemis queue stat` 的输出格式发生变化，建议使用 Jolokia 调用。
- **从 2.31.x 升级**：
- MQTT 订阅队列自动删除机制调整，不再依赖 `auto-delete-$*` 设置。

#### 4. 管理 API
- **管理接口**：
- **JMX**：标准 Java 管理接口。
- **Jolokia**：通过 HTTP 接口暴露 JMX。
- **Core Client**：通过 Core 客户端发送管理消息。
- **JMS Client**：通过 JMS 客户端发送管理消息。
- **Web Console**：提供图形化界面。
- **管理功能**：
- 操作包括创建、删除、监控队列和地址。
- 支持订阅管理通知。

#### 5. 使用服务器
- **安装目录结构**：
- `bin`：包含运行脚本。
- `lib`：包含依赖库。
- `schema`：包含 XML 模式文件。
- `web`：Web 上下文加载目录。
- **创建 Broker 实例**：
- 建议将实例目录与主目录分离，便于升级和管理。
- 示例路径：`/var/lib/mybroker`。

#### 6. 升级步骤
- **一般升级流程**：
1. 进入 Broker 实例的 `etc` 目录。
2. 更新 `artemis.profile` 或 `artemis.profile.cmd` 中的 `ARTEMIS_HOME` 属性。
3. 对于 Windows 服务，更新 `artemis-service.xml` 中的 `ARTEMIS_HOME`。
- **特殊情况处理**：
- **JDBC 持久化**：列 `HOLDER_EXPIRATION_TIME` 从 `TIMESTAMP` 更改为 `BIGINT`。
- **JGroups 配置**：从 3.x 升级到 5.x 需手动调整配置。

#### 7. Apache Karaf 部署
- **安装**：
- 添加 Artemis 特性仓库：`feature:repo-add mvn:org.apache.activemq/artemis-features/1.3.0-SNAPSHOT/xml/features`
- 安装 Artemis 特性：`feature:install artemis`
- **配置**：
- 配置文件路径：`$KARAF_BASE/etc/org.apache.activemq.artemis.cfg`
- 示例配置：`config=file:etc/artemis.xml name=local domain=karaf`

#### 8. 核心功能
- **协议支持**：包括 OpenWire、AMQP 1.0、MQTT 5 等。
- **高可用性**：支持集群、镜像和分布式锁管理。
- **性能优化**：包括分页性能提升和资源利用率优化。

总结：Apache ActiveMQ Artemis 2.34.0 在性能、高可用性、协议支持和管理功能上均有显著提升，适合需要高性能消息服务的企业级应用。