Apache ActiveMQ Artemis 2.36.0 User Manual

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

摘要

文档详细介绍了Apache ActiveMQ Artemis 2.36.0的功能、安装、配置和升级方法。主要内容包括：ActiveMQ Artemis是一个多协议、高性能的消息中间件系统；介绍了broker实例的创建和管理；提供了不同协议（如AMQP、MQTT、STOMP）的支持信息；详细说明了升级过程中的注意事项，包括配置文件的更新和数据库的调整；还提到了与Apache Karaf的集成配置。

AI总结

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

#### 1. 项目概述
- **Apache ActiveMQ Artemis** 是一个开源的多协议、嵌入式、高性能、集群式、异步的消息中间件（MoM）。
- 官方文档和下载地址：[项目主页](https://activemq.apache.org/components/artemis/)、[下载](https://activemq.apache.org/components/artemis/download/)、[Git 仓库](https://github.com/apache/activemq-artemis)。

#### 2. 安装与运行
- **安装**：从下载页面获取最新版本，解压后主要目录包括：
- `bin`：运行脚本。
- `lib`：依赖库。
- `schema`：配置文件的 XML 模式。
- `web`：Web 上下文加载目录。
- **运行**：通过 `./bin/activemq run` 启动。

#### 3. 创建 Broker 实例
- **Broker 实例**：包含配置和运行时数据的目录，建议不要将其创建在主目录下，以方便升级。
- **创建命令**：`./bin/artemis create /path/to/myBrokerInstance`。

#### 4. 升级 Broker
- **升级步骤**：
1. 导航到实例的 `etc` 文件夹。
2. 修改 `artemis.profile` 或 `artemis.profile.cmd` 中的 `ARTEMIS_HOME` 属性。
3. 对于 Windows 服务，修改 `artemis-service.xml` 中的 `ARTEMIS_HOME` 属性。
- **注意事项**：升级时需注意 XML 模式的更改和数据库表结构的调整。

#### 5. 协议支持
- 支持多种协议，包括 OpenWire、AMQP 1.0、MQTT 5.0 和 STOMP。
- **AMQP 支持**：
- 默认监听端口：61616 和 5672。
- 支持的客户端：Qpid、.NET、NodeJS、RHEA 等。

#### 6. 配置与管理
- **配置文件**：通过 `artemis.xml` 和 `logging.properties` 进行配置。
- **日志管理**：提供审计日志功能，可调整日志级别和输出格式。

#### 7. 性能与优化
- **性能工具**：提供性能测试工具，用于评估吞吐量和响应时间。
- **新功能**：
- MQTT 5 支持。
- 多地址 diverted 支持。
- 运行时配置重新加载支持。
- 消息计数器分页配置。

#### 8. 其他功能
- **Karaf 集成**：支持在 Apache Karaf OSGi 容器中安装和配置 Broker。
- **升级注意事项**：
- 更新 `bootstrap.xml` 和 `management.xml` 中的 XML 命名空间。
- 数据库字段类型变更（如 `HOLDER_EXPIRATION_TIME` 从 `TIMESTAMP` 更改为 `BIGINT`）。
- JGroups 配置更新。

#### 9. 重要更新
- **2.36.0 版本亮点**：
- 支持 SOCKS 代理。
- 改进大消息支持。
- 自动创建过期和死信资源。

通过以上内容，用户可以快速了解 Apache ActiveMQ Artemis 2.36.0 的核心功能、安装配置、协议支持及升级方法。