20.6.10. 对 HornetQ 配置属性的引用

HornetQ 的 JBoss EAP 6 实现开放了下列可配置的属性。你可以使用管理 CLI 通过 read-resource 操作开放可配置或可查看的属性。

例 20.5. 实例

[standalone@localhost:9999 /] /subsystem=messaging/hornetq-server=default:read-resource

表 20.10. HornetQ 属性

属性 默认值 类型 描述
allow-failback true BOOLEAN 如果原来的在线服务器重新上线，是否自动关闭这个服务器。
async-connection-execution-enabled true BOOLEAN 服务器上的转入数据包是否必须移交线程池里的线程进行处理。
address-setting 地址设置定义了按照地址通配符而不是专有队列定义的一些属性。
acceptor 接收器（Acceptor）定义 HornetQ 服务器接受哪些连接的方式。
backup-group-name STRING 一系列必须彼此复制的 live/backup 服务器的名称
backup false BOOLEAN 服务器是否是备份（backup）服务器
check-for-live-server false BOOLEAN 被复制的在线服务器是否必须检查当前的群集来查看是否已有具有相同节点 ID 的在线服务器。
clustered false BOOLEAN [已舍弃] 服务器是否加入群集
cluster-password CHANGE ME!! STRING 群集连接用来在群集节点间通讯的密码
cluster-user HORNETQ.CLUSTER.ADMIN.USER STRING 群集连接用来在群集节点间通讯的用户
cluster-connection 群集连接将服务器分组为群集，这样消息就可以在群集节点间实现负载平衡。
create-bindings-dir true BOOLEAN 服务器在启动时是否必须创建 bindings 目录
create-journal-dir true BOOLEAN 服务器在启动时是否必须创建 journal 目录
connection-ttl-override -1L LONG 如果设置，它将覆盖连接保持在线而无需要接收 ping 的时间（毫秒）。
connection-factory 定义一个连接工厂
connector 客户用来定义如何连接服务器的连接器
connector-service
divert 这是一个消息资源，它允许您将路由至某个地址的消息透明地转移到其他地址，而无需修改任何客户应用程序逻辑。
discovery-group 通过侦听从声明连接器的其他服务器接收广播信息的多点传送组
failback-delay 5000 LONG 在线服务器重启时发生故障恢复前等待的时间
failover-on-shutdown false BOOLEAN 在普通的服务器关闭时，这个备份服务器（如果是）是否必须在线。
grouping-handler 决定群集里的哪个节点必须处理带有分配的组 ID 的消息
id-cache-size 20000 INT 用于预先创建消息 ID 的缓存的大小
in-vm-acceptor 定义 HornetQ 服务器接受哪些 in-VM 连接的方式
in-vm-connector in-VM 客户用来定义如何连接服务器
jmx-domain org.hornetq STRING 用来在 MBeanServer 里注册内部 HornetQ MBean 的 JMX 域
jmx-management-enabled false BOOLEAN HornetQ 是否必须通过 JMX 开放其内部的管理 API。这不是我们推荐的做法，因为访问这些 MBean 可能导致不一致的配置。
journal-buffer-size 501760 (490KiB) LONG 日志上的内部缓冲的大小
journal-buffer-timeout 对于 ASYNCIO 日志，500000（0.5 毫秒），对于 NIO 日志， 3333333（3.33 毫秒） LONG 用于冲刷日志内部缓冲的间隔（纳秒）
journal-compact-min-files 10 INT 在可以开始压缩前最少的日志数据文件数目
journal-compact-percentage 30 INT 我们考虑压缩日志前活动数据所占的百分比
journal-file-size 10485760 LONG 每个日志文件的大小（字节）
journal-max-io 1 INT 任一时刻 AIO 队列里写请求的最大数量。当使用 ASYNCIO 日志时默认值修改为 500。
journal-min-files 2 INT 要预先创建的日志文件的数量
journal-sync-non-transactional true BOOLEAN 在向客户返回响应之前是否等待非事务数据同步至日志
journal-sync-transactional true BOOLEAN 在向客户返回响应之前是否等待事务数据同步至日志
journal-type ASYNCIO 字符串 要使用的日志的类型。这个属性的值可以是 "ASYNCIO" 或 "NIO"。
jms-topic 定义 JMS 主题
live-connector-ref reference STRING [已舍弃] 用来连接在线服务的连接器的名称。如果这个服务器不是使用共享 HA 的备份服务器，它的值为"undefined"
log-journal-write-rate false BOOLEAN 是否定期记录日志的写速率和冲刷速率
mask-password true BOOLEAN  
management-address jms.queue.hornetq.management STRING 管理消息送往的地址
management-notification-address hornetq.notifications STRING 消费者绑定以接收管理通知的地址的名称
max-saved-replicated-journal-size 2 INT 在故障恢复发生后保持的日志备份的最大数量
memory-measure-interval -1 LONG JVM 内存取样的频率（毫秒，-1 表示禁用内存取样）
memory-warning-threshold 25 INT 超过就会记录警告日志的可用内存的百分比
message-counter-enabled false BOOLEAN 是否启用消息计数
message-counter-max-day-history 10 INT 保持消息计数历史的天数
message-counter-sample-period 10000 LONG 用于消息计数的样本周期（毫秒）
message-expiry-scan-period 30000 LONG 扫描过期消息的频率（毫秒）
message-expiry-thread-priority 3 INT 线程过期消息的优先级
page-max-concurrent-io 5 INT 分页允许的并发读取的最大数量
perf-blast-pages -1 INT  
persist-delivery-count-before-delivery false BOOLEAN 是否在递送前持久化递送计数。False 表示这只有在取消消息后才会发生。
persist-id-cache true BOOLEAN 是否将 ID 持久化到日志
persistence-enabled true BOOLEAN 服务器是否将使用基于文件的日志进行持久化
pooled-connection-factory 定义受管连接工厂
remoting-interceptors undefined LIST [已舍弃] 这个服务器使用的拦截器类列表
remoting-incoming-interceptors undefined LIST 服务器使用的转入拦截器类的列表
remoting-outgoing-interceptors undefined LIST 服务器使用的转出拦截器类的列表
run-sync-speed-test false BOOLEAN 是否在启动时执行关于磁盘同步速度的诊断测试。当确认性能问题时这很有用。
replication-clustername STRING 如果配置了多个群集连接，将复制的群集连接的名称。
runtime-queue Runtime 队列
remote-connector 远程客户用它来定义如何连接服务器
remote-acceptor 定义 HornetQ 服务器接受哪些远程连接的方式
scheduled-thread-pool-max-size 5 INT 主调度线程池拥有的线程数量
security-domain other STRING 用来检验用户和角色信息的安全域
security-enabled true BOOLEAN 是否启用安全性
security-setting 这是一个安全设置，它允许根据基于地址的队列定义权限集。
security-invalidation-interval 10000 LONG 子安全缓存失效前等待的时间（毫秒）
server-dump-interval -1 LONG 将运行时信息转储至服务器日志的频率。小于 1 的值表示禁用这个功能。
shared store true BOOLEAN 服务器是否将共享存储用于失效切换
thread-pool-max-size 30 INT 主线程池拥有的线程数量。-1 表示无限制。
transaction-timeout 300000 LONG 在创建后多久事务可以从资源管理者删除
transaction-timeout-scan-period 1000 LONG 扫描超时事务的频率（毫秒）
wild-card-routing-enabled true BOOLEAN 服务器是否支持通配符路由

警告

journal-file-size 的值必须比发往服务器的消息大小要大，否则服务器无法存储这个消息。
提交 bug 报告