Apache ActiveMQ Artemis 1.5.0 User Manual

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

摘要

文档详细介绍了Apache ActiveMQ Artemis服务器的使用方法，包括安装、目录结构、创建代理实例、配置选项、协议支持（如JMS、AMQP、MQTT、STOMP、OPENWIRE）以及安全配置。文档还提供了使用JAAS进行身份验证的配置示例，并介绍了如何处理大消息、SSL加密传输和用户认证等功能。

AI总结

《Apache ActiveMQ Artemis 1.5.0 用户手册》提供了关于如何使用和配置 Apache ActiveMQ Artemis 服务器的详细指南。以下是文档的核心内容总结：

### 1. 使用服务器
- **启动与停止**：文档介绍了如何启动和停止 Apache ActiveMQ Artemis 服务器。
- **目录布局**：服务器运行时的目录结构包括 `bin`（二进制文件和脚本）、`web`（网络上下文）、`user-manual`（用户手册）、`api`（API 文档）、`examples`（示例）、`core`（核心模块）、`javaee`（Java EE 模块）、`jms`（JMS 模块）、`lib`（依赖库）、`schema`（配置文件模式）等。

### 2. 安装
- 下载分发包后，关键目录包括：
- `bin`：用于运行 ActiveMQ Artemis 的二进制文件和脚本。
- `web`：网络上下文加载目录。
- `user-manual`：用户手册的位置。
- `api`：API 文档的位置。
- `examples`：JMS 和 Java EE 示例。
- `lib`：运行 ActiveMQ Artemis 所需的 JAR 和库。
- `schema`：用于验证配置文件的 XML 模式。

### 3. 创建代理实例
- 代理实例目录包含运行时数据，如日志和数据文件。
- 建议将实例目录与主目录分离，以便于升级。
- 示例命令：将实例创建在 `/var/lib/mybroker`：

  cd /var/lib
  ${ARTEMIS_HOME}/bin/artemis create mybroker

- 实例目录包含以下子目录：
- `bin`：执行脚本。
- `etc`：配置文件。
- `data`：持久化消息数据。
- `log`：日志文件。
- `tmp`：临时文件。

### 4. JMS 功能
- **JMS Bridge**：展示了如何在两个独立的 ActiveMQ Artemis 服务器之间建立桥接。
- **JMS Context**：使用 JMS 2.0 上下文接口发送和接收消息。
- **JMS Shared Consumer**：展示了如何使用共享消费者在主题上共享订阅，解决了 JMS 1.1 的可扩展性问题。
- **JMX 管理**：通过 JMX 管理 ActiveMQ Artemis 服务器。

### 5. 大消息支持
- 支持发送和接收非常大的消息，消息大小仅受服务器磁盘空间限制。
- 大消息会持久化到服务器，确保服务器重启后仍可访问。

### 6. 最后值队列
- 最后值队列是一种特殊队列，当新消息具有相同的“最后值”属性时，会丢弃旧消息。

### 7. 安全
- **用户凭证**：ActiveMQ Artemis 提供两种安全管理器：
- `ActiveMQSecurityManager`：基于属性文件（`artemis-users.properties` 和 `artemis-roles.properties`）验证用户凭证。
- `ActiveMQJAASSecurityManager`：支持任何标准 JAAS 登录模块，默认使用。
- **SSL 传输**：通过 SSL 加密在不安全的网络中传输消息。

### 8. 日志与配置
- 启动服务器时，日志信息显示协议模块和绑定地址：

  server-out:17:30:25,120 INFO [org.apache.activemq.artemis.core.server] AMQ221000: live Message Broker is starting with configuration Broker Configuration (clustered=false, journalDirectory=/data/journal, bindingsDirectory=/data/bindings, largeMessagesDirectory=/data/large-messages, pagingDirectory=/data/paging)

### 9. 其他功能
- **持久化**：确保消息在服务器重启后仍可访问。
- **传输配置**：支持多种协议（CORE、AMQP、HORNETQ、STOMP、OPENWIRE、MQTT）。
- **性能调优**：文档提供了故障排除和性能调优的指导。

### 10. 配置参考
- 提供了详细的配置选项和参数说明，便于用户根据需求调整服务器行为。

### 总结
《Apache ActiveMQ Artemis 1.5.0 用户手册》全面涵盖了 ActiveMQ Artemis 的安装、配置、使用和管理，适合开发人员和系统管理员参考。文档结构清晰，内容详实，适合快速上手和深入使用 ActiveMQ Artemis 服务器。