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

手順

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

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

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

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

手順

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>
           <page-size-bytes>10485760</page-size-bytes>
           <address-full-policy>PAGE</address-full-policy>
           ...
       </address-setting>
   </address-settings>

   max-size-bytes

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

   page-size-bytes

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

   address-full-policy

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

   PAGE

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

   DROP

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

   FAIL

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

   BLOCK

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

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

   page-max-cache-size

   ページングナビゲーション中に IO を最適化するためにブローカーがメモリーに保持するページファイルの数。デフォルト値は 5 です。

   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

   2. Windows の場合:

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

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

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

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

   global-max-size

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

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

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

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

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

   2. Windows の場合:

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

手順

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

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

   2. Windows の場合:

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

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

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

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

   max-disk-usage

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

   上記の例では、ブローカーはメッセージをページングする際にディスク領域の fifty パーセントの使用に制限されます。

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

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

   2. Windows の場合:

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