Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

17.6. 配置

17.6.1. 配置 JMS 服务器
复制链接

要为 HornetQ 配置 JMS 服务器，请编辑服务器配置文件。对于域服务器，服务器配置包含在 EAP_HOME/domain/configuration/domain.xml 里；而对于独立服务器，则位于 EAP_HOME/standalone/configuration/standalone.xml 文件里。
<subsystem xmlns="urn:jboss:domain:messaging:1.3"> 元素包含了所有的 JMS 配置。按需要为 JNDI 添加任何 JMS ConnectionFactory、Queue 或 Topic 实例。

  1. 启用 JBoss EAP 6 里的 JMS 子系统。

    在 <extensions> 元素里，检查是否有下面一行且没被注释： 
    <extension module="org.jboss.as.messaging"/>

  2. 添加基本的 JMS 子系统。

    如果 Messaging 子系统没有出现在你的配置文件里，请添加它。
    1. 查找对应你所使用的配置集的 <profile>，并定位它的 <subsystems> 标签。
    2. 在 <subsystems> 标签下添加一新行，并粘贴下列内容： 
      <subsystem xmlns="urn:jboss:domain:messaging:1.3">

</subsystem>
      所有进一步的配置都将添加到空行的上方。

  3. 添加基本的 JMS 配置。

    <journal-file-size>102400</journal-file-size>
<journal-min-files>2</journal-min-files>
<journal-type>NIO</journal-type>
<!-- disable messaging persistence -->
<persistence-enabled>false</persistence-enabled>
    定制上面的值以满足你的需要。

    警告

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

  4. 在 HornetQ 里添加连接工厂实例

    客户使用 JMS ConnectionFactory 对象来创建到服务器的连接。要添加 JMS 连接工厂对象到 HornetQ 里，请为每个连接工厂包含一个 <jms-connection-factories> 标签和 <connection-factory> 元素： 
    <subsystem xmlns="urn:jboss:domain:messaging:1.3">
  ...
  <jms-connection-factories>
    <connection-factory name="myConnectionFactory">
      <connectors>
        <connector-ref connector-name="netty"/>
      </connectors>
      <entries>
        <entry name="/ConnectionFactory"/>           
      </entries>
    </connection-factory>
  </jms-connection-factories>
  ...
</subsystem>

  5. 配置 netty 连接器

    这个 JMS 连接工厂使用一个 netty 连接器。这是一个对部署在服务器配置文件里的连接器对象的引用。这个连接器对象定义了实际用来连接服务器的传输协议和参数。
    要配置 netty 连接器，请包含下列设置： 
    <subsystem xmlns="urn:jboss:domain:messaging:1.3">
  ...
  <connectors>
    <netty-connector name="netty" socket-binding="messaging"/>
    <netty-connector name="netty-throughput" socket-binding="messaging-throughput">
      <param key="batch-delay" value="50"/>
    </netty-connector>
    <in-vm-connector name="in-vm" server-id="0"/>
  </connectors>
  ...
</subsystem>
    这个连接器引用了 messaging 和 messaging-throughput 套接字绑定。messaging 套接字绑定使用端口 5445，而 messaging-throughput 套接字绑定使用端口 5455。 请确保下列套接字绑定出现在 <socket-binding-groups> 元素里： 
    <socket-binding-groups>
  ...
  <socket-binding-group ... >
    <socket-binding name="messaging" port="5445"/>
    <socket-binding name="messaging-throughput" port="5455"/>
    ...
  </socket-binding-group>
  ...
</socket-binding-groups>

  6. 可选：添加 queue 实例到 HornetQ 里

    有四种方法可设置 HornetQ 的队列实例（或 JMS 目的地）。
    • 使用管理控制台
      要使用管理控制台，服务器必须已经以 Message-Enabled 模式启动。您可以用 -c 选项并强制使用 standalone-full.xml（对于独立服务器）配置文件来做到这一点。例如，在独立模式下，下列命令将以 message-enabled 模式启动服务器： 
      ./standalone.sh -c standalone-full.xml
      服务器启动后，登录管理控制台并导航至：Profile Messaging Destinations default View，然后点击 Add 按钮来输入 JMS 目的地的细节。
    • 使用管理 CLI：
      首先，连接至管理 CLI： 
       bin/jboss-cli.sh --connect
      然后，进入消息子系统： 
      cd /subsystem=messaging/hornetq-server=default
      最后，执行 add 操作，用自己的内容替换下例里的值： 
      ./jms-queue=testQueue:add(durable=false,entries=["java:jboss/exported/jms/queue/test"])
    • 创建一个 JMS 配置文件并将其添加至 deployments 文件夹
      从创建 JMS 配置文件 example-jms.xml 开始。添加下列条目，用自己的设置替换相关的值： 
      <?xml version="1.0" encoding="UTF-8"?>				  	  <messaging-deployment xmlns="urn:jboss:messaging-deployment:1.0">
    <hornetq-server>
        <jms-destinations>
            <jms-queue name="testQueue">
                <entry name="queue/test"/>
                <entry name="java:jboss/exported/jms/queue/test"/>
            </jms-queue>
            <jms-topic name="testTopic">
                <entry name="topic/test"/>
                <entry name="java:jboss/exported/jms/topic/test"/>
            </jms-topic>
        </jms-destinations>
    </hornetq-server>
</messaging-deployment>
      保存文件到 deployments 文件夹并进行部署。
    • 在 JBoss EAP 6 配置文件里添加条目。
      以 standalone-full.xml 为例子，找到里面的消息子系统。 
      <subsystem xmlns="urn:jboss:domain:messaging:1.3">
      添加下列条目，并用自己的设置替换相关的值。您需要在 </jms-connection-factories> 标签后但在 </hornetq-server> 元素前添加这些内容： 
      <jms-destinations>
        <jms-queue name="testQueue">
            <entry name="queue/test"/>
            <entry name="java:jboss/exported/jms/queue/test"/>
        </jms-queue>
        <jms-topic name="testTopic">
            <entry name="topic/test"/>
            <entry name="java:jboss/exported/jms/topic/test"/>
        </jms-topic>
    </jms-destinations>

  7. 执行其他的配置

    如果您需要其他的设置，请复查 EAP_HOME/docs/schema/jboss-messaging_1_3.xsd 里的 DTD。
提交 bug 报告
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat返回顶部