Apache ActiveMQ Artemis 2.37.0 User Manual

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

摘要

The document provides a comprehensive guide to Apache ActiveMQ Artemis 2.37.0, detailing its features, installation, configuration, and usage. It covers various aspects including Message Oriented Middleware (MoM), security configurations using JAAS, and management through JMX. The manual also includes examples of different messaging protocols like JMS and explains how to interact with the broker using the command line interface.

AI总结

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

#### 1. 项目概述
- Apache ActiveMQ Artemis 是一个开源的高性能、多协议、异步的消息中间件。
- 它支持集群、嵌入式部署，并提供多种协议（如 OpenWire、AMQP、STOMP、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. 核心功能
- **多协议支持**：支持多种消息协议，适用于不同应用场景。
- **高性能**：设计为高性能、低延迟的消息系统。
- **集群能力**：支持分布式部署和高可用性。
- **异步通信**：通过异步机制实现高效的消息传递。
- **可扩展性**：支持大规模消息吞吐量和高并发场景。

#### 3. 示例功能
文档提供了多个示例，展示了 Artemis 的功能：
- **MQTT 拦截器**：演示如何使用 MQTT 拦截器。
- **JAAS 安全配置**：通过 JAAS 实现用户认证和授权。
- **JMS 自动关闭**：演示 JMS 资源的自动关闭功能。
- **JMS 完成监听器**：通过 CompletionListener 监听消息的处理状态。
- **JMS 桥接**：搭建两个 Artemis 服务器之间的消息桥接。
- **JMS 上下文**：使用 JMS 2.0 的 Context 接口发送和接收消息。
- **共享消费者**：在主题上共享订阅，提升可扩展性。
- **大消息支持**：支持传输远大于内存容量的大消息，受限于磁盘空间。

#### 4. 服务器使用
- **安装**：从下载页面获取最新版本，解压后即可使用。
- **目录结构**：
- `bin`：包含运行 Artemis 的脚本。
- `lib`：包含运行所需的 JAR 和库文件。
- `schema`：用于验证配置文件的 XML 模式。
- `web`：Web 上下文加载的文件夹。
- **创建实例**：实例目录应与 Artemis 家目录分离，推荐存放在 `/var/lib` 目录下。例如：

  ./bin/artemis create /var/lib/mybroker

- **启动与停止**：通过脚本启动和停止broker，支持多种协议连接。

#### 5. 升级指南
- **升级步骤**：
1. 进入实例的 `etc` 目录。
2. 修改 `artemis.profile` 和 `artemis-utility.profile` 文件中的 `ARTEMIS_HOME` 属性。
3. 对于 Windows 服务，修改 `artemis-service.xml` 中的 `ARTEMIS_HOME` 属性。
- **注意事项**：升级前备份数据，确保新版本与旧版本兼容。

#### 6. 命令行接口（CLI）
- **功能**：支持创建实例、用户管理、队列和地址管理等基本操作。
- **使用方式**：
- 传统命令行：`./artemis [COMMAND] [PARAMETERS]`
- Shell 模式：通过 `./artemis shell` 进入交互式界面，支持命令复用。
- **命令示例**：
- `./artemis help`：显示所有可用命令。
- `./artemis queue stat`：查看队列状态。
- `./artemis user add`：添加用户。

#### 7. Artemis on Apache Karaf
- **安装**：
1. 添加特征仓库：

     karaf@root> feature:repo-add mvn:org.apache.activemq/artemis-features/1.3.0-SNAPSHOT/xml/features

2. 安装特征：

     karaf@root> feature:install artemis

- **配置**：通过 `$KARAF_BASE/etc/org.apache.activemq.artemis.cfg` 文件进行配置。
- **用户管理**：支持通过 CLI 或管理接口添加、删除用户和角色。

#### 8. 安全机制
- **JAAS 登录模块**：支持通过 JAAS 进行用户认证和授权。
- **LDAP 登录模块**：支持与 LDAP 服务器集成，实现基于目录服务的安全管理。
- **用户管理**：通过 CLI 或管理接口（如 JMX、Web 控制台）管理用户和角色。

#### 9. 其他注意事项
- **性能优化**：支持大消息传输，仅受限于磁盘空间。
- **兼容性**：支持与 Apache ActiveMQ（Classic 版本）的兼容性。
- **日志与监控**：提供详细的日志记录和监控功能，便于排查问题。

以上为《Apache ActiveMQ Artemis 2.37.0 User Manual》的核心内容总结。