配置参数索引 本章给出了HornetQ配置参数的索引,以便查阅。点击任意一个配置参数可以转到其所属的章节。
服务器配置
hornetq-configuration.xml HornetQ主要核心服务器配置文件 服务器配置 名称 类型 说明 默认值 backup Boolean true表示本服务器是集群中另一个服务器的备份服务器 false backup-connector-ref String 用于连接备份服务器的连接器 bindings-directory String 保存持久绑定的目录the directory to store the persisted bindings to data/bindings clustered Boolean true表示服务器是集群中的节点 false connection-ttl-override Long 表示在接收到一个ping之前连接保持有效的时间(单位毫秒) -1 create-bindings-dir Boolean true表示服务器在启动时创建绑定的目录 true create-journal-dir Boolean true表示创建日志目录 true file-deployment-enabled Boolean true表示服务器从配置文件中读取配置 true id-cache-size Integer 预先生成的消息id的缓存大小 2000 journal-buffer-size Long 日志内部缓存的大小 128 KiB journal-buffer-timeout Long T将日志缓冲数据刷新的等待时间(纳秒) 20000 journal-compact-min-files Integer 开始整理数据的最小数据文件数。 10 journal-compact-percentage Integer 开始压缩日志时的有效数据百分比。 30 journal-directory String 日志文件所在的位置 data/journal journal-file-size Long 每个日志文件的大小(字节) 128 * 1024 journal-max-io Integer 某一时刻保存在AIO队列中的最大写请求数 500 journal-min-files Integer 预先创建的日志文件数 2 journal-sync-transactional Boolean 如果是true,等事务数据同步到日志后再向客户端返回 true journal-sync-non-transactional Boolean 如果是true,等非事务数据到日志后再向客户端返回 true journal-type ASYNCIO|NIO 日志存取的方式 ASYNCIO jmx-management-enabled Boolean true表示通过JMX可以使用管理接口 true jmx-domain String 用于HornetQ MBean注册到MBeanServer的JMX域名 org.apache.activemq large-messages-directory String 存放大消息的目录 data/largemessages management-address String 管理消息发送的地址 jms.queue.hornetq.management cluster-user String 集群连接的用户名 HORNETQ.CLUSTER.ADMIN.USER cluster-password String 集群连接的用户密码 CHANGE ME!! management-notification-address String 用于接收管理通知的地址 hornetq.notifications message-counter-enabled Boolean true表示使用消息计数器 false message-counter-max-day-history Integer 消息计数器历史保存的天数 10 message-counter-sample-period Long 消息计数器取样的间隔(毫秒) 10000 message-expiry-scan-period Long 过期消息扫描周期(毫秒) 30000 message-expiry-thread-priority Integer 过期消息线程的优先级 3 paging-directory String 分页转存消息的保存目录 data/paging persist-delivery-count-before-delivery Boolean true表示传递计数在传递之前保存。false表示只有当消息被取消时才保存。 false persistence-enabled Boolean true表示服务器使用基于文件的日志做持久化 true persist-id-cache Boolean true表示id被保存到日志中 true scheduled-thread-pool-max-size Integer 可计划线程池的线程数。 5 security-enabled Boolean true表示使用安全功能 true security-invalidation-interval Long 安全缓存的有效时间(毫秒) 10000 thread-pool-max-size Integer 主线程池的线程数。-1表示数量不限 -1 async-connection-execution-enabled Boolean 接收的数据包是否由线程池的线程来处理 true transaction-timeout Long 事务在建立后经过多长时间后可以从资源管理器(resource manager)删除(毫秒) 60000 transaction-timeout-scan-period Long 扫描超时事务的间隔(毫秒) 1000 wild-card-routing-enabled Boolean true表示服务器支持通配符路由 true memory-measure-interval Long 采样JVM内存的周期(毫秒,-1表示不采样) -1 memory-warning-threshold Integer 可用内存达到这个百分比时,给出警告信息 25 connectors Connector 连接器的配置 connector.name (attribute) String 连接器的名字-必需指定的参数 connector.factory-class String 连接工厂的实现类名-必需指定的参数 connector.param 连接器的配置参数 一个键-值对,表示一个连接器的参数配置。一个连接器可以有多个这样的参数 connector.param.key (属性) String 参数的键 - 必需指定的参数 connector.param.value (attribute) String 参数的值 - 必需指定的参数 acceptors Acceptor 一组接收器 acceptor.name (属性) String 接收器的名字 - 可选 acceptor.factory-class String 接收器工厂实现类名 - 必需指定的参数 acceptor.param 一个接收器的配置参数 用来配置接收器的键-值对。一个接收器可以有多个参数。 acceptor.param.key (属性) String 参数的键 - 必需指定的参数 acceptor.param.value (attribute) String 参数的值 - 必需指定的参数 broadcast-groups BroadcastGroup 一组广播组 broadcast-group.name (attribute) String 广播组的名字(必需是唯一的)- 必需指定的参数 broadcast-group.local-bind-address String 数据报文套接字的本地绑定地址 内系统内核选择的IP地址 broadcast-group.local-bind-port Integer 数据报文套接字的本地绑定端口 -1 (匿名端口) broadcast-group.group-address String 广播地址 - 必需指定的参数 broadcast-group.group-port Integer 广播使用的UDP端口 - 必需指定的参数 broadcast-group.broadcast-period Long 广播的时间间隔(毫秒) 2000 broadcast-group.connector-ref 一个连接器对 广播的一个连接器和一个可选的备份连接器。一个广播组可以有多个这样的连接器对 broadcast-group.connector-ref.connector-name (attribute) String 主连接器名 - 必需指定的参数 broadcast-group.connector-ref.backup-connector-name (attribute) String 备份连接器名 - 可选的参数 discovery-groups DiscoveryGroup 一组发现组 discovery-group.name (属性) String 发现组的名字(具有唯一性) - 必需指定的参数 discovery-group.local-bind-address String 发现组所绑定的本地地址 discovery-group.group-address String 发现组监听的广播IP地址 - 必需指定的参数 discovery-group.group-port Integer 广播组监听的UDP端口 - 必需指定的参数 discovery-group.refresh-timeout Integer 发现组等待更新的时间。如果某个服务器上次广播到达后经过这个时间后还没有收到下次广播,那么 该服务器的连接器对将从列表中删除 5000 (毫秒) diverts Divert 一组转发器 divert.name (attribute) String 转发器的名字(必需是唯一的) - 必需指定的参数 divert.routing-name String 转发器的路由名称 - 必需指定的参数 divert.address String 转发器的源地址 - 必需指定的参数 divert.forwarding-address String 转发器的转发地址 - 必需指定的参数 divert.exclusive Boolean 转发器是否是唯一的 false divert.filter String 可选的核心过滤器表达式 null divert.transformer-class-name String 可选的转换器的名字 queues Queue 一组预先配置的队列 queues.name (属性) String 队列独特的名字 queues.address String 队列的地址 - 必需指定的参数 queues.filter String 队列可选的核心过滤器表达式 null queues.durable Boolean 是否持久队列 true bridges Bridge 一组桥 bridges.name (属性) String 桥的独特名字 bridges.queue-name String 桥接收消息的源队列名 - 必需指定的参数 bridges.forwarding-address String 桥要转发的地址。如果没有指定则使用原始的地址 null bridges.filter String 可选的核心过滤器表达式 null bridges.transformer-class-name String 可选的转换器类名 null bridges.retry-interval Long 重试的时间间隔(毫秒) 2000 ms bridges.retry-interval-multiplier Double 重试间隔的递增系数 1.0 bridges.reconnect-attempts Integer 最大重试次数,-1代表无限次 -1 bridges.failover-on-server-shutdown Boolean 如果目标服务器正常关机是否仍进行失效备援 false bridges.use-duplicate-detection Boolean 是否在转发的消息中添加重复检测的头 true bridges.discovery-group-ref String 桥使用的发现组名 null bridges.connector-ref.connector-name (属性) String 主连接的连接器名 bridges.connector-ref.backup-connector-name (属性) String 备份连接的连接器名(可选) null cluster-connections ClusterConnection 一组集群连接 cluster-connections.name (attribute) String 集群连接的独特名字 cluster-connections.address String 集群连接的地址名 cluster-connections.forward-when-no-consumers Boolean 如果目标没有合适的接收者,是否仍然向它分配消息? false cluster-connections.max-hops Integer 集群拓扑中的最大跳数(hops) 1 cluster-connections.retry-interval Long 集群连接重试的间隔(毫秒) 2000 cluster-connections.use-duplicate-detection Boolean 是否在转发的消息中添加重复检测的消息头 true cluster-connections.discovery-group-ref String 桥所使用的发现组的名字 null cluster-connections.connector-ref.connector-name (属性) String 主连接的连接器名字 cluster-connections.connector-ref.backup-connector-name (属性) String 可选的备份连接所使用的连接器名字 null security-settings SecuritySetting 一组安全设置 security-settings.match (属性) String 安全所应用的地址匹配字符串 security-settings.permission 安全许可 地址的一个许可 security-settings.permission.type (attribute) 许可类型 许可的类型 security-settings.permission.roles (attribute) Roles 以逗号分隔的一组角色,这些角色将拥有相应的许可 address-settings AddressSetting 一组地址设置 address-settings.dead-letter-address String 死消息所发往的地址 address-settings.max-delivery-attempts Integer 发往死信地址之前所尝试的传递次数 10 address-settings.expiry-address String 过期消息所发往的地址 address-settings.redelivery-delay Long 重新传递一个取消的消息前所等待的时间(毫秒) 0 address-settings.last-value-queue boolean 队列是否是一个最新值队列 false address-settings.page-size-bytes Long 一个地址的分页的大小(字节) 10 * 1024 * 1024 address-settings.max-size-bytes Long 地址的分页转存的最大值(字节) -1 address-settings.redistribution-delay Long 队列最后一个接收者关闭后需要等待多长时间再将消息重新分配(毫秒) -1
hornetq-jms.xml 该文件是服务器端JMS服务所使用的,用来装载JMS队列,话题和连接工厂。 JMS服务器配置 名称 类型 说明 默认值 connection-factory ConnectionFactory 一组注册到JNDI的连接工厂 connection-factory.signature (属性) String 连接工厂的类型 generic connection-factory.xa Boolean 是否是XA类型的连接工厂 false connection-factory.auto-group Boolean 是否自动使用消息组 false connection-factory.connectors String 一组供连接工厂使用的连接器 connection-factory.connectors.connector-ref.connector-name (属性) String 连接主服务器的连接器名 connection-factory.connectors.connector-ref.backup-connector-name (attribute) String 连接备份服务器的连接器名 connection-factory.discovery-group-ref.discovery-group-name (属性) String 连接工厂的发现组名 connection-factory.discovery-initial-wait-timeout Long 发现组首次等待广播的时间 10000 connection-factory.block-on-acknowledge Boolean 消息是否以同步方式通知 false connection-factory.block-on-non-durable-send Boolean 是否以同步方式发送非持久消息 false connection-factory.block-on-durable-send Boolean 是否以同步方式发送持久消息 true connection-factory.call-timeout Long 远程调用超时时间(毫秒) 30000 connection-factory.client-failure-check-period Long 客户端如果在这个时间内没有收到服务器数据包,将认为连接出现故障。 5000 connection-factory.client-id String 连接工厂预先配置的客户ID null connection-factory.connection-load-balancing-policy-class-name String 负载均衡类名 org.apache.activemq.api.core.client.loadbalance.RoundRobinConnectionLoadBalancingPolicy connection-factory.connection-ttl Long 连接的存活时间(毫秒) 1 * 60000 connection-factory.consumer-max-rate Integer 接收者每秒钟接收消息的最快速度 -1 connection-factory.consumer-window-size Integer 接收者流控制容器大小(字节) 1024 * 1024 connection-factory.dups-ok-batch-size Integer 在DUPS_OK_ACKNOWLEDGE模式下批量通知的大小(字节) 1024 * 1024 connection-factory.failover-on-initial-connection Boolean 如果首次连接主服务器失败是否失效备援连接到备份服务器 false connection-factory.failover-on-server-shutdown Boolean 在服务器停机时是否进行失效备援 false connection-factory.min-large-message-size Integer 大消息的最小值,大小超过该值的按大消息处理 100 * 1024 connection-factory.cache-large-message-client Boolean true表示这个连接工厂会将大消息保存在临时文件中 false connection-factory.pre-acknowledge Boolean 是否在消息发送之前提前通知 false connection-factory.producer-max-rate Integer 发送消息的最大速度 -1 connection-factory.producer-window-size Integer 发送者发送消息的窗口大小 1024 * 1024 connection-factory.confirmation-window-size Integer 会话恢复的确认窗口大小(字节) 1024 * 1024 connection-factory.reconnect-attempts Integer 重试的最大次数, -1 表示无限次 0 connection-factory.retry-interval Long 每次重试的时间间隔(毫秒) 2000 connection-factory.retry-interval-multiplier Double 重试间隔时间的递增系数 1.0 connection-factory.max-retry-interval Integer 最大重试间隔。 2000 connection-factory.scheduled-thread-pool-max-size Integer 可计划线程池的大小 5 connection-factory.thread-pool-max-size Integer 线程池大小 -1 connection-factory.transaction-batch-size Integer 使用事务性会话时发送通知的批量大小(字节) 1024 * 1024 connection-factory.use-global-pools Boolean 是否使用全局线程池 true queue Queue 创建并注册到JNDI的队列 queue.name (属性) String 队列的唯一名字 queue.entry String 队列的JNDI的上下文(context)。一个队列可以有多个JNDI的上下文 queue.durable Boolean 是否持久队列 true queue.filter String 可选的队列过滤器表达式 topic Topic 创建并注册到JNDI的话题 topic.name (属性) String 话题的唯一名 topic.entry String 话题的JNDI上下文(context)。一个话题可以有多个上下文。