手順38.1 ライブサーバープロファイルの作成

1. $JBOSS_HOME/server/ に移動します。
2. production プロファイルをコピーして、HornetQ_Colocated に名前を変更します。

手順38.2 共有ストアとジャーナリングの設定

1. $JBOSS_HOME/server/HornetQ_Colocated/deploy/hornetq/ に移動します。
2. オープンします。
3. <shared-store> element 要素を <configuration> 要素の子として追加します。

   <shared-store>true</shared-store>

4. バインディング、ジャーナル、および大きなメッセージパスの場所がライブバックアップグループがアクセスできる場所に設定されていることを確認します。
   例で示されたように絶対パスを設定したり、設定ファイルに存在する JBoss パラメーターを使用したりできます。
   パラメーターオプションを選択し、これらのパラメーターが解決されるデフォルトのパスを使用しない場合は、サーバーを起動する度にバインディング、ジャーナル、および大きなメッセージが存在するパスを指定する必要があります。

   <large-messages-directory>/media/shared/data/serverA/large-messages</large-messages-directory>
   
   <bindings-directory>/media/shared/data/serverA/bindings</bindings-directory>
   
   <journal-directory>/media/shared/data/serverA/journal</journal-directory>
   
   <paging-directory>/media/shared/data/ServerA/paging</paging-directory>

   注記

   ネットワークのライブバックアップグループにアクセス可能なパスを指定してください。

   注記

   ServerA をサーバーインスタンスに適切な名前に変更します。

手順38.3 JMS クライアントの正常シャットダウンの設定

1. $JBOSS_HOME/server/HornetQ_Colocated/deploy/hornetq/ に移動します。
2. hornetq-configuration.xml を開きます。
3. 手順38.2「共有ストアとジャーナリングの設定」 で記述されたようにジャーナルディレクトリ設定付近の領域に <fail-over-on-shutdown> 要素を指定します。

   <failover-on-shutdown>true</failover-on-shutdown>

   注記

   hornetq-configuration.xml ファイルに要素を置く場所の制限はありません。ただし、ファイルの上部に詳細レベルが低い設定があると、見つけやすくなります。
4. ファイルを保存し、閉じます。

手順38.4 HA 接続ファクトリーの設定

1. $JBOSS_HOME/server/HornetQ_Colocated/deploy/hornetq/ に移動します。
2. hornetq-jms.xml を開きます。
3. 以下で示されたように以下の属性と値を追加します。

   <ha>true</ha>

   クライアントが高可用性をサポートし、フェイルオーバーを実行するために常に true になるように指定します。

   <retry-interval>1000</retry-interval>

   クライアントがサーバーに再接続するまでクライアントが待機する時間 (ミリ秒単位) を指定します。

   <retry-interval-multiplier>1.0</retry-interval-multiplier>

   以降の各再接続の一時停止に対して使用される乗数 <retry-interval> を指定します。この値を 1.0 に設定すると、再試行間隔が各クライアント再接続要求で同じになります。

   <reconnect-attempts>-1</reconnect-attempts>

   クライアントが失敗する前に行う再接続試行の回数を指定します。-1 と設定すると、再接続が無制限で試行されます。

   <?xml version='1.0' encoding='UTF-8'?>
   <configuration xmlns="urn:hornetq" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:hornetq /schema/hornetq-jms.xsd">
   
      <connection-factory name="NettyConnectionFactory">
         <xa>true</xa>
         <connectors>
            <connector-ref connector-name="netty"/>
         </connectors>
         <entries>
            <entry name="/ConnectionFactory"/>
            <entry name="/XAConnectionFactory"/>
         </entries>
         <ha>true</ha>
   
         <!-- Pause 1 second between connect attempts -->
   
         <retry-interval>1000</retry-interval>
   
         <!-- Multiply subsequent reconnect pauses by this multiplier. This can be used 
          to implement an exponential back-off. For our purposes we just set to 1.0 so 
          each reconnect pause is the same length -->
   
         <retry-interval-multiplier>1.0</retry-interval-multiplier>
   
         <!-- Try reconnecting an unlimited number of times (-1 means unlimited) -->
   
         <reconnect-attempts>-1</reconnect-attempts>
      </connection-factory>
   
   </configuration>
   

4. 指定されたファイルに以下のいずれかの設定ブロックを追加することにより、マスターノードとバックアップノードの両方で新しいキューを定義します。
   production/deploy/hornetq/hornetq-jms.xml の場合

   <queue name="testQueue">
      <entry name="/queue/testQueue"/>
      <durable>true</durable>
   </queue>

   production/deploy/customName-hornetq-jms.xml の場合

   注記

   XML ネームスペースが存在し、指定されたようにファイルで正しいことを確認して、XML 検証の観点からファイルの形式が適切であることを確認します。

   <configuration xmlns="urn:hornetq"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xsi:schemaLocation="urn:hornetq /schema/hornetq-jms.xsd">
   
      <queue name="testQueue">
         <entry name="/queue/testQueue"/>
         <durable>true</durable>
      </queue>
   
   </configuration>

手順38.5 バックアップサーバーの作成

1. $JBOSS_HOME/server/HornetQ_Colocated/deploy/ に移動します。
2. hornetq-backup1 という名前の新しいディレクトリを作成します。このディレクトリに移動します。
3. テキストエディターを開き、hornetq-jboss-beans.xml という名前の新しいファイルを hornetq-backup1 ディレクトリに作成します。
4. 以下の設定を hornetq-jboss-beans.xml にコピーします。

   <?xml version="1.0" encoding="UTF-8"?>
      <deployment xmlns="urn:jboss:bean-deployer:2.0">
         <!-- The core configuration -->
         <bean name="BackupConfiguration" class="org.hornetq.core.config.impl.FileConfiguration">
            <property name="configurationUrl">${jboss.server.home.url}/deploy/hornetq-backup1/hornetq-configuration.xml</property>
         </bean>
         <!-- The core server -->
         <bean name="BackupHornetQServer" class="org.hornetq.core.server.impl.HornetQServerImpl">
            <constructor>
               <parameter>
                  <inject bean="BackupConfiguration"/>
               </parameter>
               <parameter>
                  <inject bean="MBeanServer"/>
               </parameter>
               <parameter>
                  <inject bean="HornetQSecurityManager"/>
               </parameter>
            </constructor>
            <start ignored="true"/>
            <stop ignored="true"/>
         </bean>
   
         <!-- The JMS server -->
         <bean name="BackupJMSServerManager" class="org.hornetq.jms.server.impl.JMSServerManagerImpl">
            <constructor>
               <parameter>
                  <inject bean="BackupHornetQServer"/>
               </parameter>
            </constructor>
         </bean>
   
   </deployment>
   

5. ファイルを保存し、閉じます。

手順38.6 バックアップサーバー設定ファイルの作成

1. $JBOSS_HOME/server/HornetQ_Colocated/deploy/hornetq-backup1 に移動します。
2. テキストエディターを開き、hornetq-configuration.xml という名前の新しいファイルを hornetq-backup1 ディレクトリに作成します。
3. 以下の設定を hornetq-configuration.xml にコピーします。

   <?xml version="1.0" encoding="UTF-8"?>
   <configuration xmlns="urn:hornetq" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:hornetq /schema/hornetq-configuration.xsd">
   
      <jmx-domain>org.hornetq.backup1</jmx-domain>
   
      <clustered>true</clustered>
   
      <backup>true</backup>
   
      <shared-store>true</shared-store>
   
      <allow-failback>true</allow-failback>
   
      <file-deployment-enabled>true</file-deployment-enabled>
   
      <log-delegate-factory-class-name>
       org.hornetq.integration.logging.Log4jLogDelegateFactory
      </log-delegate-factory-class-name>
   
      <bindings-directory>
       /media/shared/data/hornetq-backup/bindings
      </bindings-directory>
   
      <journal-directory>/media/shared/data/hornetq-backup/journal</journal-directory>
   
      <journal-min-files>10</journal-min-files>
   
      <large-messages-directory>
       /media/shared/data/hornetq-backup/largemessages
      </large-messages-directory>
   
      <paging-directory>/media/shared/data/hornetq-backup/paging</paging-directory>
   
      <connectors>
         <connector name="netty-connector">
            <factory-class>
             org.hornetq.core.remoting.impl.netty.NettyConnectorFactory
            </factory-class>
            <param key="host" value="${jboss.bind.address:localhost}"/>
            <param key="port" value="${hornetq.remoting.netty.backup.port:5446}"/>
         </connector>
   
         <connector name="in-vm">
            <factory-class>
             org.hornetq.core.remoting.impl.invm.InVMConnectorFactory
            </factory-class>
            <param key="server-id" value="${hornetq.server-id:0}"/>
         </connector>
      </connectors>
   
      <acceptors>
         <acceptor name="netty">
            <factory-class>
             org.hornetq.core.remoting.impl.netty.NettyAcceptorFactory
            </factory-class>
            <param key="host" value="${jboss.bind.address:localhost}"/>
            <param key="port" value="${hornetq.remoting.netty.backup.port:5446}"/>
         </acceptor>
      </acceptors>
   
      <broadcast-groups>
         <broadcast-group name="bg-group1">
            <group-address>231.7.7.7</group-address>
            <group-port>9876</group-port>
            <broadcast-period>1000</broadcast-period>
            <connector-ref>netty-connector</connector-ref>
         </broadcast-group>
      </broadcast-groups>
   
      <discovery-groups>
         <discovery-group name="dg-group1">
            <group-address>231.7.7.7</group-address>
            <group-port>9876</group-port>
            <refresh-timeout>60000</refresh-timeout>
         </discovery-group>
      </discovery-groups>
   
      <cluster-connections>
         <cluster-connection name="my-cluster">
            <address>jms</address>
            <connector-ref>netty-connector</connector-ref>
            <discovery-group-ref discovery-group-name="dg-group1"/>
         </cluster-connection>
      </cluster-connections>
   
      <security-settings>
         <security-setting match="#">
            <permission type="createNonDurableQueue" roles="guest"/>
            <permission type="deleteNonDurableQueue" roles="guest"/>
            <permission type="consume" roles="guest"/>
            <permission type="send" roles="guest"/>
         </security-setting>
      </security-settings>
   
      <address-settings>
      <!--default for catch all-->
         <address-setting match="#">
            <dead-letter-address>jms.queue.DLQ</dead-letter-address>
            <expiry-address>jms.queue.ExpiryQueue</expiry-address>
            <redelivery-delay>0</redelivery-delay>
            <max-size-bytes>10485760</max-size-bytes>
            <message-counter-history-day-limit>10</message-counter-history-day-limit>
            <address-full-policy>BLOCK</address-full-policy>
         </address-setting>
      </address-settings>
   
   </configuration>
   

4. ファイルを保存し、閉じます。

手順38.7 専用ライブサーバープロファイルの作成

1. $JBOSS_HOME/server/ に移動します。
2. production プロファイルをコピーして、HornetQ_Dedicated に名前を変更します。

手順38.8 共有ストアとジャーナリングの設定

1. $JBOSS_HOME/server/HornetQ_Dedicated/deploy/hornetq/ に移動します。
2. hornetq-configuration.xml を開きます。
3. <shared-store> element 要素を <configuration> 要素の子として追加します。

   <shared-store>true</shared-store>

4. バインディング、ジャーナル、および大きなメッセージパスの場所がライブバックアップグループがアクセスできる場所に設定されていることを確認します。
   例で示されたように絶対パスを設定したり、設定ファイルに存在する JBoss パラメーターを使用したりできます。
   パラメーターオプションを選択し、これらのパラメーターが解決されるデフォルトのパスを使用しない場合は、サーバーを起動する度にバインディング、ジャーナル、および大きなメッセージが存在するパスを指定する必要があります。

   <large-messages-directory>/media/shared/data/large-messages</large-messages-directory>
   
   <bindings-directory>/media/shared/data/bindings</bindings-directory>
   
   <journal-directory>/media/shared/data/journal</journal-directory>
   
   <paging-directory>/media/shared/data/paging</paging-directory>

   注記

   ネットワークのライブバックアップグループにアクセス可能なパスを指定してください。

手順38.9 JMS クライアントの正常シャットダウンの設定

1. $JBOSS_HOME/server/HornetQ_Dedicated/deploy/hornetq/ に移動します。
2. hornetq-configuration.xml を開きます。
3. 手順38.2「共有ストアとジャーナリングの設定」 で記述されたようにジャーナルディレクトリ設定付近の領域に <fail over-on-shutdown> 要素を指定します。

   <failover-on-shutdown>true</failover-on-shutdown>

   注記

   hornetq-configuration.xml ファイルに要素を置く場所の制限はありません。ただし、ファイルの上部に詳細レベルが低い設定があると、見つけやすくなります。
4. ファイルを保存し、閉じます。

手順38.10 HA 接続ファクトリーの設定

1. $JBOSS_HOME/server/HornetQ_Dedicated/deploy/hornetq/ に移動します。
2. hornetq-jms.xml を開きます。
3. 以下で示されたように以下の属性と値を追加します。

   <ha>true</ha>

   クライアントが高可用性をサポートし、フェイルオーバーを実行するために常に true になるように指定します。

   <retry-interval>1000</retry-interval>

   クライアントがサーバーに再接続するまでクライアントが待機する時間 (ミリ秒単位) を指定します。

   <retry-interval-multiplier>1.0</retry-interval-multiplier>

   以降の各再接続の一時停止に対して使用される乗数 <retry-interval> を指定します。この値を 1.0 に設定すると、再試行間隔が各クライアント再接続要求で同じになります。

   <reconnect-attempts>-1</reconnect-attempts>

   クライアントが失敗する前に行う再接続試行の回数を指定します。-1 と設定すると、再接続が無制限で試行されます。

   <?xml version='1.0' encoding='UTF-8'?>
   <configuration xmlns="urn:hornetq" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:hornetq /schema/hornetq-jms.xsd">
   
      <connection-factory name="NettyConnectionFactory">
         <xa>true</xa>
         <connectors>
            <connector-ref connector-name="netty"/>
         </connectors>
         <entries>
            <entry name="/ConnectionFactory"/>
            <entry name="/XAConnectionFactory"/>
         </entries>
         <ha>true</ha>
   
         <!-- Pause 1 second between connect attempts -->
   
         <retry-interval>1000</retry-interval>
   
         <!-- Multiply subsequent reconnect pauses by this multiplier. This can be used 
          to implement an exponential back-off. For our purposes we just set to 1.0 so 
          each reconnect pause is the same length -->
   
         <retry-interval-multiplier>1.0</retry-interval-multiplier>
   
         <!-- Try reconnecting an unlimited number of times (-1 means unlimited) -->
   
         <reconnect-attempts>-1</reconnect-attempts>
      </connection-factory>
   
   </configuration>
   

4. 指定されたファイルに以下のいずれかの設定ブロックを追加することにより、マスターノードとバックアップノードの両方で新しいキューを定義します。
   production/deploy/hornetq/hornetq-jms.xml の場合

   <queue name="testQueue">
      <entry name="/queue/testQueue"/>
      <durable>true</durable>
   </queue>

   production/deploy/customName-hornetq-jms.xml の場合

   注記

   XML ネームスペースが存在し、指定されたようにファイルで正しいことを確認して、XML 検証の観点からファイルの形式が適切であることを確認します。

   <configuration xmlns="urn:hornetq"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xsi:schemaLocation="urn:hornetq /schema/hornetq-jms.xsd">
   
      <queue name="testQueue">
         <entry name="/queue/testQueue"/>
         <durable>true</durable>
      </queue>
   
   </configuration>

手順38.11 専用バックアップサーバーの設定

1. バックアップサーバーで、コマンドラインを使用して /extras/hornetq/ に移動します。
2. sh ./switch.sh -Dbackup=true を実行します。
   スクリプトが実行され、production-backup サーバープロファイルが $JBOSS_HOME/server/ に作成されます。
3. production-backup サーバープロファイルをコピーして、HornetQ_Dedicated_Backup に名前を変更します。
4. $JBOSS_HOME/server/HornetQ_Dedicated_Backup/hornetq/hornetq-configuration.xml を開きます。
5. <shared-store>true</shared-store> 要素を子要素として <configuration> 要素に追加します。
6. 以下の値に一致するようデータディレクトリの場所を変更します。
   • <large-messages-directory>/media/shared/data/large-messages</large-messages-directory>
   • <bindings-directory>/media/shared/data/bindings</bindings-directory>
   • <journal-directory>/media/shared/data/journal</journal-directory>
   • <paging-directory>/media/shared/data/paging</paging-directory>
7. 更新されたすべてのファイルを保存し、閉じます。

手順38.12 JCA 接続ファクトリーの設定

1. production サーバープロファイルをコピーして、EAP2 に名前を変更します。
2. EAP2 インスタンスで、$JBOSS_HOME/server/EAP2/deploy/hornetq/jms-ds.xml に移動します。
3. デフォルトの jms-ds.xml では、次の <config-property> 設定が <tx-connection-factory> に存在します。

   <?xml version="1.0" encoding="UTF-8"?>
   <connection-factories>
      <!-- JMS Stuff -->
   
      <mbean code="org.jboss.jms.jndi.JMSProviderLoader" 
       name="hornetq:service=JMSProviderLoader,name=JMSProvider">
         <attribute name="ProviderName">DefaultJMSProvider</attribute>
         <attribute name="ProviderAdapterClass">org.jboss.jms.jndi.JNDIProviderAdapter</attribute>
         <attribute name="FactoryRef">java:/XAConnectionFactory</attribute>
         <attribute name="QueueFactoryRef">java:/XAConnectionFactory</attribute>
         <attribute name="TopicFactoryRef">java:/XAConnectionFactory</attribute>
      </mbean>
      
      <!-- JMS XA Resource adapter, use this to get transacted JMS in beans -->
   
      <tx-connection-factory>
         <jndi-name>JmsXA</jndi-name>
         <xa-transaction/>
         <rar-name>jms-ra.rar</rar-name>
         <connection-definition>org.hornetq.ra.HornetQRAConnectionFactory</connection-definition>
         <config-property name="SessionDefaultType" type="java.lang.String">javax.jms.Topic</config-property>
         <config-property name="JmsProviderAdapterJNDI" type="java.lang.String">java:/DefaultJMSProvider</config-property>
         <max-pool-size>20</max-pool-size>
         <security-domain-and-application>JmsXARealm</security-domain-and-application>
      </tx-connection-factory>
   </connection-factories>
   

4. Outbound JCA コネクターの設定

   以下のコード例で示されたように <config-property> 要素を追加します。

   重要

   [live_server_IP_address] と [live_server_port_number] をライブサーバーのネットワークアドレスの場所と置き換えます。

   IP アドレス/ポートの組み合わせを設定するために検出を使用している場合は、設定されたブロードキャストグループに一致するように、<DiscoveryAddress> と <DiscoveryPort> に適切なパラメーターを設定します。

   <?xml version="1.0" encoding="UTF-8"?>
   <connection-factories>
      <!-- JMS Stuff -->
   
      <mbean code="org.jboss.jms.jndi.JMSProviderLoader" 
       name="hornetq:service=JMSProviderLoader,name=JMSProvider">
         <attribute name="ProviderName">DefaultJMSProvider</attribute>
         <attribute name="ProviderAdapterClass">org.jboss.jms.jndi.JNDIProviderAdapter</attribute>
         <attribute name="FactoryRef">java:/XAConnectionFactory</attribute>
         <attribute name="QueueFactoryRef">java:/XAConnectionFactory</attribute>
         <attribute name="TopicFactoryRef">java:/XAConnectionFactory</attribute>
      </mbean>
      
      <!-- JMS XA Resource adapter, use this to get transacted JMS in beans -->
   
      <tx-connection-factory>
         <jndi-name>JmsXA</jndi-name>
         <xa-transaction/>
         <rar-name>jms-ra.rar</rar-name>
         <connection-definition>org.hornetq.ra.HornetQRAConnectionFactory</connection-definition>
         <config-property name="SessionDefaultType" type="java.lang.String">javax.jms.Topic</config-property>
         <config-property name="JmsProviderAdapterJNDI" type="java.lang.String">java:/DefaultJMSProvider</config-property>
         <config-property name="ConnectorClassName" type="java.lang.String">org.hornetq.core.remoting.impl.netty.NettyConnectorFactory</config-property>
         <config-property name="ConnectionParameters" type="java.lang.String">host=[live_server_IP_address];port=[live_server_port_number]</config-property>
         <max-pool-size>20</max-pool-size>
         <security-domain-and-application>JmsXARealm</security-domain-and-application>
      </tx-connection-factory>
   </connection-factories>
   

5. テキストエディターで $JBOSS_HOME/server/EAP2/deploy/jms-ra.rar/META-INF/ra.xml を開きます。
6. ra.xml で、<resourceadapter> を検索します。

7. Inbound コネクターの設定

   "The transport type" および "The transport configuration..." <config-property> 要素と、その子要素を以下の設定と置き換えます。

   重要

   [live_server_IP_address] と [live_server_port_number] をライブサーバーのネットワークアドレスの場所と置き換えます。

   IP アドレス/ポートの組み合わせを設定するために検出を使用している場合は、設定されたブロードキャストグループに一致するように、<DiscoveryAddress> と <DiscoveryPort> に適切なパラメーターを設定します。

   自動検出を使用している場合は、ConnectorClassName ディレクティブと ConnectionParameters ディレクティブをコメントアウトします。

   <?xml version="1.0" encoding="UTF-8"?>
   
   <!-- Preceeding parts of config file removed for readability -->
   
   <resourceadapter>
      <resourceadapter-class>org.hornetq.ra.HornetQResourceAdapter</resourceadapter-class>
      <config-property>
         <description>The transport type</description>
         <config-property-name>ConnectorClassName</config-property-name>
         <config-property-type>java.lang.String</config-property-type>
         <config-property-value>org.hornetq.core.remoting.impl.netty.NettyConnectorFactory</config-property-value>
      </config-property>
      <config-property>
         <description>The transport configuration. These values must be in the form of key=val;key=val;</description>
         <config-property-name>ConnectionParameters</config-property-name>
         <config-property-type>java.lang.String</config-property-type>
         <config-property-value>host=[live_server_IP_address];port=[live_server_port_number]</config-property-value>
      </config-property>
      <config-property>
         <description>Do we support HA</description>
         <config-property-name>HA</config-property-name>
         <config-property-type>java.lang.Boolean</config-property-type>
         <config-property-value>true</config-property-value>
      </config-property>
   
   <!-- Rest of config file removed for readability -->
   
   <resourceadapter>