6.2. 默认 address-setting
开箱即用,JBoss EAP 包含了单一 address-setting 元素,作为 messaging-activemq 子系统配置的一部分:
对 name 属性使用单个 # 使此默认 address-setting 的配置用于所有目的地,因为 # 匹配任何地址。您可以继续将此概括性配置应用到所有地址,或者您可以为每个需要设置自己配置的地址组添加新 address-setting。
使用管理 CLI 配置地址设置
配置地址设置可使用管理 CLI 或管理控制台进行,但管理 CLI 会公开更多用于编辑的配置属性。有关 属性的完整列表,请参阅本指南附录中的地址设置 属性。
添加新 address-setting
如果需要,使用 add 操作创建新的地址设置。您可以从管理 CLI 会话的根目录运行此命令,以下示例中创建名为 的新模式。您可以包含 address-setting 的配置属性。下面是创建一个新的 address-setting 匹配 news.europe.#,其 dead-letter-address 属性设置为队列 DLQ.news,该属性是提前创建的。单机服务器和受管域都使用 full 配置文件的示例分别显示。
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:add(dead-letter-address=DLQ.news)
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:add(dead-letter-address=DLQ.news)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:add(dead-letter-address=DLQ.news)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:add(dead-letter-address=DLQ.news)
编辑 address-setting 属性
使用 write-attribute 操作,将新值写入到属性。您可以使用 Tab 补全来帮助完成键入的命令字符串,以及公开可用的属性。以下示例将 max-delivery-attempts 值更新为 10。
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:write-attribute(name=max-delivery-attempts,value=10)
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:write-attribute(name=max-delivery-attempts,value=10)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:write-attribute(name=max-delivery-attempts,value=10)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:write-attribute(name=max-delivery-attempts,value=10)
读取 address-setting 属性
使用 include- runtime=true 参数运行 read-resource 操作来公开服务器模式中的所有当前值,以确认值已更改。
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:read-resource(include-runtime=true)
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:read-resource(include-runtime=true)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:read-resource(include-runtime=true)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:read-resource(include-runtime=true)
使用管理控制台配置地址设置
您可以按照以下步骤使用管理控制台创建和查看地址设置:
- 登录管理控制台。
- 选择屏幕顶部的 Configuration 选项卡。运行受管域时,选择要更新的配置集。
-
选择 Messaging(ActiveMQ)
Server。 -
选择消息传递服务器。在默认配置中,仅显示一个名为
default的服务器。 - 选择 Destinations 并单击 View。
- 选择 地址设置 选项卡来配置地址设置。
请记住,添加新模式时,如 news.europe.#,Pattern 字段引用 address-setting 元素的 name 属性。在使用管理 CLI 读取或写入属性时,您可以输入这个值。
在使用管理控制台时,您只能编辑 dead-letter- address、redelivery 属性。其他属性必须通过管理 CLI 进行配置。
-delay 和 max-delivery-attempts
为消息传递服务器配置全局资源使用量
address-setting 元素中的三个 属性可帮助您控制消息传递服务器的全局资源使用情况:
| 属性 | 描述 |
|---|---|
|
|
控制 Artemis 在将消息视为满之前用于存储其地址的最大内存量,并且其 |
|
|
控制 Artemis 可用于在文件系统中存储数据的最大空间。达到限制时,任何新消息都会被阻断。此属性以磁盘上可用空间的百分比表示。最小值为 |
|
|
控制 Artemis 检查文件系统中可用空间的频率。默认值为 |