Apache ActiveMQ Artemis 2.32.0 User Manual

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

摘要

《Apache ActiveMQ Artemis 2.32.0 User Manual》详细介绍了Apache ActiveMQ Artemis 2.32.0，包括其作为消息中间件的功能、管理API的使用、安装配置步骤、升级指南以及在Apache Karaf上的集成。文档还提供了命令行接口的使用方法，帮助用户进行broker实例的创建和管理。

AI总结

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

#### 1. 项目信息
- **Apache ActiveMQ Artemis** 是一个开源的多协议、嵌入式、高性能、集群式、异步消息系统。
- 它是一个消息导向中间件（MoM）的示例，适用于需要高性能和可靠消息传递的场景。
- **官方资源**：
- 项目页面：[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/)
- Git 仓库：[https://github.com/apache/activemq-artemis](https://github.com/apache/activemq-artemis)

#### 2. 管理 API
- 提供了统一的管理 API，支持多种访问方式：
- **JMX**：用于管理 Java 应用的标准方式。
- **Jolokia**：通过 HTTP 接口暴露 JMX API。
- **Core Client**：通过 Core 客户端发送管理操作。
- **JMS Client**：通过 JMS 客户端发送管理操作。
- **Web Console**：提供图形化管理界面。
- **核心功能**：
- 修改服务器配置。
- 创建、部署和删除队列。
- 检查队列状态（如消息数量）。
- 订阅管理通知。

#### 3. 使用服务器
- **安装**：
- 下载后解压，主目录包含 `bin`、`lib`、`schema` 和 `web` 等关键目录。
- **创建 Broker 实例**：
- 实例目录应独立于主目录，便于升级。
- 建议将实例存放在 `/var/lib` 目录下。
- 使用命令 `./bin/artemis create /path/to/myBrokerInstance` 创建实例。

#### 4. 版本信息
- **2.32.0 高亮功能**：
- Mirrored Core Messages 支持原生格式传输。
- MQTT 会话自动删除（基于客户端会话过期时间）。
- 语言定义更加包容。
- 示例代码独立于主仓库，存放于 [https://github.com/apache/activemq-artemis-examples/](https://github.com/apache/activemq-artemis-examples/)。

#### 5. 升级指南
- **升级步骤**：
1. 修改 `artemis.profile` 或 `artemis.profile.cmd` 文件中的 `ARTEMIS_HOME` 属性。
2. 对于 Windows 服务，修改 `artemis-service.xml` 中的 `ARTEMIS_HOME` 属性。
- **注意事项**：
- 升级前需备份实例数据。
- 参考版本文档中的具体升级说明。

#### 6. 在 Apache Karaf 上安装
- **安装步骤**：
1. 添加 Artemis 特性仓库：`feature:repo-add mvn:org.apache.activemq/artemis-features/1.3.0-SNAPSHOT/xml/features`。
2. 安装 Artemis 特性：`feature:install artemis`。
- **配置文件**：
- 配置文件位于 `$KARAF_BASE/etc/org.apache.activemq.artemis.cfg`。

#### 7. 命令行界面（CLI）
- 提供两种使用方式：
- **传统 CLI**：直接执行命令，如 `./artemis [COMMAND] [PARAMETERS]`。
- **Shell 模式**：通过 `./artemis shell` 进入交互式界面。
- **主要命令**：
- `help`：查看命令列表。
- `producer`：发送消息。
- `consumer`：消费消息。
- `browser`：浏览队列消息。
- `upgrade`：升级实例。

#### 8. 文档结构
- 该手册涵盖从安装、配置、管理到高级功能（如高可用性和集群）的各个方面，旨在帮助用户全面了解和使用 Apache ActiveMQ Artemis 2.32.0。

通过以上总结，可以快速了解 Apache ActiveMQ Artemis 2.32.0 的核心功能、使用方法和管理技巧。