Apache ActiveMQ Artemis 2.30.0 User Manual

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

摘要

The document provides a comprehensive guide on using Apache ActiveMQ Artemis 2.30.0, including installation, configuration, and management. It covers creating broker instances, adjusting default configurations, and upgrading from older versions. Key highlights include support for new features, bug fixes, and performance improvements. The document also details specific steps for upgrading, such as updating XML schemas, JDBC persistence configurations, and JGroups settings. Additionally, it includes information on performance tools, CLI improvements, and logging configuration.

AI总结

# Apache ActiveMQ Artemis 2.30.0 用户指南总结

## 1. 安装
- **下载**：从下载页面获取最新版本。
- **目录结构**：
- `bin`：运行 ActiveMQ Artemis 所需的二进制文件和脚本。
- `examples`：各种示例，参考示例章节了解如何运行。
- `lib`：运行 ActiveMQ Artemis 所需的 JAR 和库文件。
- `web`：Web 上下文加载的目录。
- `api`：API 文档。
- `user-manual`：用户指南。

## 2. 创建 Broker 实例
- Broker 实例目录包含配置和运行时数据（如日志和消息日记）。
- **推荐位置**：不要将实例目录放在主目录 (`$ARTEMIS_HOME`) 下，建议放在 `/var/lib` 目录下（例如 `/var/lib/mybroker`）。
- **创建命令**：

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

- **目录结构**：
- `bin`：包含与实例相关的执行脚本。
- `data`：存储持久消息的数据文件。
- `etc`：包含实例的配置文件。
- `log`：存储轮转日志文件。
- `tmp`：存储安全删除的临时文件。

## 3. 升级注意事项
- **从旧版本升级**：
1. **XML 模式更改**：更新 `bootstrap.xml` 和 `management.xml` 文件中的 XML 命名空间。
2. **JDBC 持久化**：由于列 `HOLDER_EXPIRATION_TIME` 类型更改，需要更新数据库。
3. **JGroups 配置**：从 3.x 升级到 5.x，参考 JGroups 文档更新配置。

## 4. 版本亮点
### 2.30.0
- 主要是 bug 修复和少量改进，包括依赖项升级。

### 2.29.0
- 重点改进了大消息（Large Messages）的支持。

### 2.20.0
- 引入了对 Java 11 的支持。

### 1.0.0
- **初始版本**：捐赠的代码基础作为 ActiveMQ Artemis 发布。
- **主要功能**：
- OpenWire 支持。
- AMQP 1.0 支持。
- 基于 URL 的连接。
- 自动创建地址/队列。
- Jolokia 集成。

### 其他版本
- **2.8.0**：支持 `JMSXGroupFirstForConsumer` 和其他改进。
- **2.7.0**：支持高级目标选项、延迟删除队列和地址、日志记录 HTTP 访问等。
- **2.6.0**：支持正则表达式匹配客户端证书、SASL 外部认证等。

## 5. 其他注意事项
- **Windows**：调整 `JAVA_ARGS` 参数以支持日志管理器。
- **性能工具**：提供了新的性能工具来评估吞吐量和响应性能。
- **配置参考**：包括地址设置、消费者优先级、日志配置等。

## 6. 总结
Apache ActiveMQ Artemis 是一个高性能的消息中间件，支持多种协议和高级功能。用户应根据文档正确安装、配置和升级以确保最佳性能和安全性。