Apache ActiveMQ Artemis 2.16.0 User Manual

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

摘要

The document provides an in-depth guide on configuring, installing, and managing Apache ActiveMQ Artemis, a high-performance messaging system. It covers setting up the server on Windows, managing dependencies, tuning JVM settings for optimal performance, and upgrading from previous versions. Key features include support for regular expressions in client certificates, SASL_EXTERNAL for AMQP, and enhanced metrics for queues. The manual also details how to adjust transport settings, manage file handles, and optimize memory usage for better performance.

AI总结

# Apache ActiveMQ Artemis 2.16.0 用户手册总结

## 1. 安装与配置
- **Windows 服务器**：可作为服务运行，使用命令 `./artemis-service.exe install` 安装。
- **配置文件**：`broker.xml` 是主要配置文件，几乎所有配置都可以通过默认值完成。文件中只需包含一个空的配置元素即可视为有效配置。
- **启动参数**：通过 `artemis.profile` 文件中的 `JAVA_ARGS` 变量设置启动参数，例如 `-Xbootclasspath/a` 用于添加启动类路径。

## 2. 依赖管理
- **启动引导依赖**：如日志处理程序，需在启动时可访问。将依赖打包为 JAR 文件，并添加到启动类路径。
- **运行时依赖**：如转换器、插件等，需在运行时可访问。将 JAR 文件置于 Broker 的 `lib` 目录或实例目录中。

## 3. 版本更新
- **2.16.0**：修复了多个问题，无重大新功能。
- **2.6.0**：支持正则表达式匹配客户端证书、SASL_EXTERNAL 支持等。
- **2.5.0**：支持排除消费者、虚拟主题命名能力等。
- **2.4.0**：新增 JMX 配置、STOMP WebSocket 最大帧负载长度配置等。
- **升级注意事项**：
- 从 2.4.0 升级需配置 `anycastPrefix` 和 `multicastPrefix`。
- 从 2.3.0 升级需创建 `management.xml` 文件。

## 4. 性能调优
- **TCP 参数**：避免手动设置 TCP 缓冲区大小，因其可能影响自动调优功能。
- **文件句柄**：确保服务器用户有足够的文件句柄权限，例如在 Linux 系统中修改 `/etc/security/limits.conf`。
- **垃圾回收**：建议使用并行垃圾回收算法（如 `-XX:+UseParallelOldGC`）。
- **内存设置**：使用 `-Xms` 和 `-Xmx` 设置内存，建议大小一致。

## 5. 日志与监控
- **审计日志**：默认情况下审计日志级别为 INFO，需在 `logging.properties` 中调整以避免冗余输出。
- **性能指标**：新增地址内存使用百分比和地址大小等指标。

## 6. 系统属性与配置
- **JVM 设置**：默认内存为 1GiB，可通过脚本调整。
- **日志配置**：可通过系统属性配置日志，具体方法详见日志章节。

## 7. 版本历史
- **2.14.0**：新增管理方法更新转接器、禁用队列功能等。
- **2.13.0**：支持 SOCKS 代理、改进审计日志等。
- **2.12.0**：支持大消息处理、自动创建死亡消息资源等。

## 8. 其他注意事项
- **依赖处理**：启动引导依赖和运行时依赖需分别处理。
- **性能优化**：通过调整 JVM 参数和网络设置提升性能。

以上总结涵盖了文档的核心内容，重点突出了配置、性能调优、版本更新及关键功能。