Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

18.8. 設定

18.8.1. JMS サーバーの設定
リンクのコピー

HornetQ に JMS サーバーを設定するには、サーバー設定ファイルを編集します。サーバー設定は、ドメインサーバーの EAP_HOME/domain/configuration/domain.xml ファイル、スタンドアロンサーバーの EAP_HOME/standalone/configuration/standalone-full.xml ファイルに含まれます。
サーバー設定ファイルの < subsystem xmlns="urn:jboss:domain:messaging:1.4 "> 要素にはすべての JMS 設定が含まれます。JNDI に必要な JMS ConnectionFactory、Queue、または Topic インスタンスを追加します。

  1. JBoss EAP 6 で JMS サブシステムを有効にします。

    要素内に <extensions> 以下の行が存在し、コメントアウトされていないことを確認します。 
    <extension module="org.jboss.as.messaging"/>
    Copy to Clipboard Toggle word wrap

  2. 基本の JMS サブシステムを追加します。

    メッセージングサブシステムが設定ファイルに存在しない場合は、追加します。
    1. 使用する プロファイルに対応する &lt;profile> を検索し、その < subsystems> タグを 見つけます。
    2. < profile> タグの直後に以下の XML を 貼り付けます。 
      <subsystem xmlns="urn:jboss:domain:messaging:1.4">
    <hornetq-server>
    <!-- ALL XML CONFIGURATION IS ADDED HERE -->
    </hornetq-server>
</subsystem>
      Copy to Clipboard Toggle word wrap
      その他の設定はすべて、その上の空いている行に追加します。

  3. JMS の基本設定を追加します。

    < subsystem xmlns="urn:jboss:domain:messaging:1.4"> <hornetq-server > タグの後に空の行に以下の XML を追加します。 
    <journal-min-files>2</journal-min-files>
<journal-type>NIO</journal-type>
<persistence-enabled>true</persistence-enabled>
    Copy to Clipboard Toggle word wrap
    ニーズに合わせて上記の値を変更します。
    警告
    journal-file-size の値は min-large-message-size （デフォルトでは 100KiB）以上の値である必要があります。そうでないと、サーバーはメッセージを保存できません。

  4. HornetQ に接続ファクトリーインスタンスを追加します。

    クライアントは JMS ConnectionFactory オブジェクトを使用してサーバーに接続します。JMS 接続ファクトリーオブジェクトを HornetQ に追加するには、以下のように各接続ファクトリーに単一の < jms-connection-factories > タグと < connection-factory > 要素が含まれます。 
      <jms-connection-factories>
    <connection-factory name="InVmConnectionFactory">
        <connectors>
            <connector-ref connector-name="in-vm"/>
        </connectors>
        <entries>
            <entry name="java:/ConnectionFactory"/>
        </entries>
    </connection-factory>
    <connection-factory name="RemoteConnectionFactory">
        <connectors>
            <connector-ref connector-name="netty"/>
        </connectors>
        <entries>
            <entry name="java:jboss/exported/jms/RemoteConnectionFactory"/>
        </entries>
    </connection-factory>
    <pooled-connection-factory name="hornetq-ra">
        <transaction mode="xa"/>
        <connectors>
            <connector-ref connector-name="in-vm"/>
        </connectors>
        <entries>
            <entry name="java:/JmsXA"/>
        </entries>
    </pooled-connection-factory>
</jms-connection-factories>
    Copy to Clipboard Toggle word wrap

  5. netty コネクターおよびアクセプターの設定

    この JMS 接続ファクトリーは netty アクセプターおよびコネクターを使用します。これらは、サーバー設定ファイルにデプロイされたコネクターおよびアクセプターオブジェクトへの参照です。コネクターオブジェクトは、HornetQ サーバーへの接続に使用されるトランスポートとパラメーターを定義します。アクセプターオブジェクトは、HornetQ サーバーが受け入れる接続タイプを識別します。
    Netty コネクターを設定する に は、以下の設定を追加します。 
    <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>
    Copy to Clipboard Toggle word wrap
    netty アクセプターを設定するには、以下の設定を追加します。 
    <acceptors>
    <netty-acceptor name="netty" socket-binding="messaging"/>
    <netty-acceptor name="netty-throughput" socket-binding="messaging-throughput">
        <param key="batch-delay" value="50"/>
        <param key="direct-deliver" value="false"/>
    </netty-acceptor>
    <in-vm-acceptor name="in-vm" server-id="0"/>
</acceptors>
    Copy to Clipboard Toggle word wrap

  6. 設定を確認します。

    これまでの手順に従った場合、メッセージサブシステムは以下のようになるはずです。 
    <subsystem xmlns="urn:jboss:domain:messaging:1.4">
    <hornetq-server>
        <journal-min-files>2</journal-min-files>
        <journal-type>NIO</journal-type>
        <persistence-enabled>true</persistence-enabled>
        <jms-connection-factories>
            <connection-factory name="InVmConnectionFactory">
                <connectors>
                    <connector-ref connector-name="in-vm"/>
                </connectors>
                <entries>
                    <entry name="java:/ConnectionFactory"/>
                </entries>
            </connection-factory>
            <connection-factory name="RemoteConnectionFactory">
                <connectors>
                    <connector-ref connector-name="netty"/>
                </connectors>
                <entries>
                    <entry name="java:jboss/exported/jms/RemoteConnectionFactory"/>
                </entries>
            </connection-factory>
            <pooled-connection-factory name="hornetq-ra">
                <transaction mode="xa"/>
                <connectors>
                    <connector-ref connector-name="in-vm"/>
                </connectors>
                <entries>
                    <entry name="java:/JmsXA"/>
                </entries>
            </pooled-connection-factory>
        </jms-connection-factories>
        <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>	
        <acceptors>
            <netty-acceptor name="netty" socket-binding="messaging"/>
            <netty-acceptor name="netty-throughput" socket-binding="messaging-throughput">
                <param key="batch-delay" value="50"/>
                <param key="direct-deliver" value="false"/>
            </netty-acceptor>
            <in-vm-acceptor name="in-vm" server-id="0"/>
        </acceptors>
    </hornetq-server>
</subsystem>
    Copy to Clipboard Toggle word wrap

  7. ソケットバインディンググループを設定します。

    Netty コネクターはメッセージングおよび messaging -throughput ソケットバインディングを参照します。メッセージング ソケットバインディングはポート 5445 を使用し、messaging-throughput ソケットバインディングはポート 5455 を使用します。 & lt;socket-binding-group&gt; タグはサーバー設定ファイルの個別のセクションにあります。<socket -binding-groups> 要素に以下のソケットバインディングがあることを確認 します。 
    <socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
    ...
    <socket-binding name="messaging" port="5445"/>
    <socket-binding name="messaging-throughput" port="5455"/>
    ...
  </socket-binding-group>
    Copy to Clipboard Toggle word wrap

  8. キューインスタンスを HornetQ への追加します。

    HornetQ 向けにキューインスタンス (または JMS 宛先) を設定する方法は 4 つあります。
    • 管理コンソールの使用
      管理コンソールを使用するには、Message-Enabled モードでサーバーを起動している必要があります。これは、-c オプションを使用して、standalone-full.xml （スタンドアロンサーバーの場合）設定ファイルの使用を強制することで実行できます。たとえば、スタンドアロンモードでは、以下はメッセージ enabled モードでサーバーを起動します。 
      ./standalone.sh -c standalone-full.xml
      Copy to Clipboard Toggle word wrap
      サーバーが起動したら、管理コンソールにログインして Configuration タブを選択します。Subsystems メニューを展開し、Messaging メニューを展開し、Destinations をクリックします。JMS Messaging Provider テーブルの Default の横にある 表示 をクリックし、Add をクリックして JMS 宛先の詳細を入力します。
    • 管理 CLI の使用:
      最初に、管理 CLI へ接続します。 
       bin/jboss-cli.sh --connect
      Copy to Clipboard Toggle word wrap
      次に、メッセージングサブシステムに移動します。 
      cd /subsystem=messaging/hornetq-server=default
      Copy to Clipboard Toggle word wrap
      最後に、add 操作を実行します。以下の例の値は独自の値に置き換えてください。 
      ./jms-queue=testQueue:add(durable=false,entries=["java:jboss/exported/jms/queue/test"])
      Copy to Clipboard Toggle word wrap
    • 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>
      Copy to Clipboard Toggle word wrap
      このファイルを deployments フォルダーに保存し、デプロイメントを実行します。
    • JBoss EAP 6 の設定ファイルにエントリーを追加します。
      キュー属性は 2 つの方法で設定できます。
      • JMS レベルの設定
        以下は、standalone.xml または domain.xml 設定ファイルで事前定義されたキューを示しています。 
        <jms-queue name="selectorQueue">
	<entry name="/queue/selectorQueue"/>
	<selector string="color='red'"/>
	<durable>true</durable>
</jms-queue>
        Copy to Clipboard Toggle word wrap
        queue のこの name 属性はキューの名前を定義します。jms レベルでこれを行う場合、コアキューの実際の名前が jms.queue.selectorQueue になるように命名規則に従います。
        entry 要素は、キューを JNDI にバインドするために使用される名前を設定します。これは必須要素であり、キューには複数のものを含めることができ、同じキューを異なる名前にバインドできます。
        selector 要素は、事前定義されたキューが持つ JMS メッセージセレクターを定義します。セレクターに一致するメッセージのみがキューに追加されます。これは、省略した場合のデフォルト null を持つオプションの要素です。
        durable 要素はキューを永続化するかどうかを指定します。これは再度オプションであり、省略されている場合はデフォルトで true に設定されます。
      • コアレベルでの設定
        キューは、standalone.xml または domain.xml ファイルのコアレベルで事前定義できます。以下に例を示します。 
        <core-queues>
	<queue name="jms.queue.selectorQueue">
		<address>jms.queue.selectorQueue</address>
		<filter string="color='red'"/>
		<durable>true</durable>
	</queue>
</core-queues>
        Copy to Clipboard Toggle word wrap

  9. 追加の設定を実行します。

    追加の設定が必要な場合は、EAP_HOME/docs/schema/jboss-as-messaging_1_4.xsd の DTD を確認します。
バグの報告
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る