6.2. 默认 address-setting


开箱即用,JBoss EAP 包含了单一 address-setting 元素,作为 messaging-activemq 子系统配置的一部分:

<subsystem xmlns="urn:jboss:domain:messaging-activemq:4.0">
  <server name="default">
      ...
      <address-setting
        name="#"
        dead-letter-address="jms.queue.DLQ"
        expiry-address="jms.queue.ExpiryQueue"
        max-size-bytes="10485760"
        page-size-bytes="2097152"
        message-counter-history-day-limit="10" />
      ...
  </server>
</subsystem>
Copy to Clipboard Toggle word wrap
注意

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)
Copy to Clipboard Toggle word wrap
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:add(dead-letter-address=DLQ.news)
Copy to Clipboard Toggle word wrap

编辑 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)
Copy to Clipboard Toggle word wrap
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:write-attribute(name=max-delivery-attempts,value=10)
Copy to Clipboard Toggle word wrap

读取 address-setting 属性

使用 include- runtime=true 参数运行 read-resource 操作来公开服务器模式中的所有当前值,以确认值已更改。

/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:read-resource(include-runtime=true)
Copy to Clipboard Toggle word wrap
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:read-resource(include-runtime=true)
Copy to Clipboard Toggle word wrap

使用管理控制台配置地址设置

您可以按照以下步骤使用管理控制台创建和查看地址设置:

  1. 登录管理控制台。
  2. 选择屏幕顶部的 Configuration 选项卡。运行受管域时,选择要更新的配置集。
  3. 选择 Messaging(ActiveMQ) Server
  4. 选择消息传递服务器。在默认配置中,仅显示一个名为 default 的服务器。
  5. 选择 Destinations 并单击 View
  6. 选择地址设置选项卡来配置地址设置

请记住,添加新模式时,如 news.europe.#Pattern 字段引用 address-setting 元素的 name 属性。在使用管理 CLI 读取或写入属性时,您可以输入这个值。

在使用管理控制台时,您只能编辑 dead-letter- address、redelivery -delay 和 max-delivery-attempts 属性。其他属性必须通过管理 CLI 进行配置。

为消息传递服务器配置全局资源使用量

address-setting 元素中的三个 属性可帮助您控制消息传递服务器的全局资源使用情况:

Expand
属性描述

global-max-memory-size

控制 Artemis 在将消息视为满之前用于存储其地址的最大内存量,并且其 address-full-policy 开始应用。默认值为 -1,这表示没有限制。

global-max-disk-usage

控制 Artemis 可用于在文件系统中存储数据的最大空间。达到限制时,任何新消息都会被阻断。此属性以磁盘上可用空间的百分比表示。最小值为 0%,最大值为 100%。默认值为 100%

disk-scan-period

控制 Artemis 检查文件系统中可用空间的频率。默认值为 5000 毫秒

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat