第7章 アドレスのメモリー使用量の設定

手順

1. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

2. core 要素内に paging-directory 要素を追加します。ファイルシステムのページングディレクトリーの場所を指定します。

   <configuration ...>
     <core ...>
       ...
       <paging-directory>/path/to/paging-directory</paging-directory>
       ...
     </core>
   </configuration>

   Copy to Clipboard

   その後ページング用に設定するアドレスごとに、ブローカーは指定したページングディレクトリーに専用のディレクトリーを追加します。

手順

1. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

2. 一致するアドレスまたはアドレス セット 用に設定した address-setting 要素の場合は、設定要素を追加して最大メモリー使用量を指定し、ページング動作を定義します。以下に例を示します。

   <address-settings>
       <address-setting match="my.paged.address">
           ...
           <max-size-bytes>104857600</max-size-bytes>
           <max-size-messages>20000</max-size-messages>
           <page-size-bytes>10485760</page-size-bytes>
           <address-full-policy>PAGE</address-full-policy>
           ...
       </address-setting>
   </address-settings>

   Copy to Clipboard

   max-size-bytes

   ブローカーが address-full-policy 属性に指定されたアクションを実行する前に、アドレスに許可されるメモリーの最大サイズ (バイト単位)。デフォルト値は -1 で、制限がないことを意味します。指定する値は、K、MB、GB などのバイト表記もサポートします。

   max-size-messages

   ブローカーが address-full-policy 属性に指定されたアクションを実行する前に、アドレスに許可されるメッセージの最大数。デフォルト値は -1 で、メッセージ制限がないことを意味します。

   page-size-bytes

   ページングシステムで使用される各ページファイルのサイズ ( バイト単位 )。デフォルト値は 10485760 ( つまり 10 MiB ) です。指定する値は、K、MB、GB などのバイト表記もサポートします。

   address-full-policy

   アドレスの最大サイズに達したときにブローカーが実行するアクション。デフォルト値は PAGE です。有効な値は以下のとおりです。

   PAGE

   ブローカーは、追加のメッセージをディスクにページングします。

   DROP

   ブローカーは追加のメッセージを通知せずに破棄します。

   FAIL

   ブローカーは、クライアントメッセージプロデューサーに対して追加のメッセージおよび例外をドロップします。

   BLOCK

   追加のメッセージを送信しようとすると、クライアントメッセージプロデューサーがブロックされます。

   max-size-bytes 属性と max-size-message 属性に制限を設定した場合、いずれかの制限に達すると、ブローカーは address-full-policy 属性に指定されたアクションを実行します。前の例の設定では、メモリー内のアドレスのメッセージの合計が 20,000 を超えるか、使用可能なメモリーを 104857600 バイト使用すると、ブローカーは my.paged.address アドレスのメッセージのページングを開始します。

   前述の例に示されて いない 追加のページング設定要素は以下のとおりです。

   page-sync-timeout

   定期的なページ同期の間隔 ( ナノ秒単位 )。非同期 IO ジャーナルを使用している場合 ( つまり、journal-type が broker.xml 設定ファイルで ASYNCIO に設定されている場合 )、デフォルト値は 3333333 です。標準の Java NIO ジャーナルを使用している場合 ( journal-type が NIO に設定されている場合 )、デフォルト値は journal-buffer-timeout パラメーターの設定済みの値です。

手順

1. ブローカーを停止します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

      Copy to Clipboard

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe stop

      Copy to Clipboard
2. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

3. core 要素内に global-max-size 要素を追加し、値を指定します。以下に例を示します。

   <configuration>
     <core>
       ...
       <global-max-size>1GB</global-max-size>
       <global-max-messages>900000</global-max-messages>
       ...
     </core>
   </configuration>

   Copy to Clipboard

   global-max-size

   ブローカーがすべてのアドレスに使用できるメモリーの合計量 ( バイト単位 )。この制限に達すると、ブローカーは各受信メッセージに関連付けられたアドレスの address-full-policy 属性に指定されたアクションを実行します。global-max-size のデフォルト値は、ブローカーをホストする Java 仮想マシン (JVM) で利用可能な最大メモリーの半分です。

   global-max-size の値はバイト単位ですが、バイト表記にも対応します ( 例 : "K"、"Mb"、"GB")。

   上記の例では、ブローカーはメッセージの処理時に利用可能な最大 1 ギガバイトのメモリーを使用するように設定されています。

   global-max-messages

   すべてのアドレスに許可されるメッセージの合計数。この制限に達すると、ブローカーは各受信メッセージに関連付けられたアドレスの address-full-policy 属性に指定されたアクションを実行します。デフォルト値は -1 で、メッセージ制限がないことを意味します。

   global-max-size 属性と global-max-messages 属性に制限を設定した場合、いずれかの制限に達すると、ブローカーは address-full-policy 属性に指定されたアクションを実行します。前の例の設定では、メモリー内のメッセージ数が 900,000 を超えるか、使用可能なメモリーが 1 GB を使用すると、ブローカはすべてのアドレスに対してメッセージのページングを開始します。

   注記

   max-size-bytes 属性または max-size-message 属性を使用して個々のアドレスに設定された制限が、global-max-size 属性または global-max-messages 属性に設定された制限よりも先に達した場合、ブローカーはそのアドレスの address-full-policy 属性に指定されたアクションを実行します。

4. ブローカーを起動します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

      Copy to Clipboard

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe start

      Copy to Clipboard

手順

1. ブローカーを停止します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

      Copy to Clipboard

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe stop

      Copy to Clipboard
2. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

3. core 要素内に属性を追加して、ディスク使用量またはメッセージ数、あるいはその両方に基づいてページング制限を指定し、いずれかの制限に達した場合に実行するアクションを指定します。以下に例を示します。

   <address-settings>
      <address-setting match="match="my.paged.address"">
       ...
       <page-limit-bytes>10G</page-limit-bytes>
       <page-limit-messages>1000000</page-limit-messages>
       <page-full-policy>FAIL</page-full-policy>
       ...
      </address-setting>
   </address-settings>

   Copy to Clipboard

   page-limit-bytes

   ブローカーが page-full-policy 属性に指定されたアクションを実行する前に、アドレスの受信メッセージをページングするために許可されるディスク領域の最大サイズ (バイト単位)。指定する値は、K、MB、GB などのバイト表記をサポートしています。デフォルト値は -1 で、制限がないことを意味します。

   page-limit-messages

   ブローカーが page-full-policy 属性に指定されたアクションを実行する前に、アドレスに対してページングできる受信メッセージの最大数。デフォルト値は -1 で、メッセージ制限がないことを意味します。

   page-full-policy

   アドレスが page-limit-bytes 属性または page-limit-messages 属性で設定された制限に達したときにブローカーが実行するアクション。有効な値は以下のとおりです。

   DROP ブローカーは、それ以降のメッセージをサイレントにドロップします。

   FAIL ブローカーはそれ以上のメッセージを削除し、送信側クライアントに通知します。

   前述の例では、ページングで 10GB のディスク領域が使用されるか、合計 100 万個のメッセージがページングされるまで、ブローカーは my.paged.address アドレスのメッセージをページングします。

4. ブローカーを起動します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

      Copy to Clipboard

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe start

      Copy to Clipboard

手順

1. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。
2. 一致するアドレスまたはアドレスのセットに対して設定した address-settings 要素については、ページングされたメッセージのメモリーへの転送に対する制限を指定します。以下に例を示します。

手順

1. ブローカーを停止します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

      Copy to Clipboard

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe stop

      Copy to Clipboard
2. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

3. core 要素内に max-disk-usage 設定要素を追加し、値を指定します。以下に例を示します。

   <configuration>
     <core>
       ...
       <max-disk-usage>80</max-disk-usage>
       ...
     </core>
   </configuration>

   Copy to Clipboard

   max-disk-usage

   ブローカーが使用できる利用可能なディスク領域の最大パーセンテージ。この制限に達すると、ブローカーは受信メッセージをブロックします。デフォルト値は 90 です。

   前述の例では、ブローカーは利用可能なディスク領域の 80 パーセントの使用に制限されています。

4. ブローカーを起動します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

      Copy to Clipboard

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe start

      Copy to Clipboard