第6章 メッセージデータの永続化

手順

1. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。
2. core 要素内に、journal-retention-directory 属性を追加します。ジャーナルファイルの保持を制御するために、period または storage-limit、あるいはその両方を指定します。さらに、ジャーナルファイルコピー用のファイルシステムの場所を指定します。次の例では、AMQ Broker が、ジャーナルファイルコピーを data/retention ディレクトリーに 7 日間、またはファイルが 10GB のストレージを使用するまで保持するように設定します。

手順

1. AMQ Management Console にログインします。詳細は、AMQ 管理コンソールへのアクセス を参照してください。
2. メインメニューの Artemis をクリックします。
3. フォルダーツリーで、addresses をクリックすると、アドレスの一覧が表示されます。
4. Addresses タブをクリックします。
5. メッセージを再生するアドレスの Action 列で、operations をクリックします。

6. 再生操作を選択します。

   • 再生操作で、すべてのジャーナルファイルコピーで再生するメッセージを検索する場合は、replay(String,String) 操作をクリックしてください。
   • 再生操作で、特定の期間内に作成されたジャーナルファイルコピーでのみ再生するメッセージを検索する場合は、replay(String,String, String,String) 操作を選択します。startScanDate および endScanDate フィールドで、期間を指定します。

7. 再生オプションを指定します。

   1. target フィールドで、再生されたメッセージを送信するブローカー上のアドレスを指定します。このフィールドを空白にすると、メッセージはブローカー上の元のアドレスに再生されます。
   2. (オプション) filter フィールドで、フィルター文字列に一致するメッセージのみを再生する文字列を指定します。たとえば、メッセージに storeID プロパティーがある場合、storeID="1000" のフィルターを使用して、ストア ID 値が 1000 のすべてのメッセージを再生できます。フィルターを指定しない場合、スキャンされたジャーナルファイルコピーのすべてのメッセージが AMQ Broker に再生されます。
8. Execute をクリックします。

手順

1. AMQ Management Console にログインします。詳細は、AMQ 管理コンソールへのアクセス を参照してください。
2. メインメニューの Artemis をクリックします。
3. フォルダーツリーで、トップレベルのサーバーをクリックします。
4. Operations タブをクリックします。

5. 再生操作を選択します。

   • 再生操作で、すべてのジャーナルファイルコピーで再生するメッセージを検索する場合は、replay(String,String,String) 操作をクリックしてください。
   • 再生操作で、特定期間内に作成されたジャーナルファイルコピーでのみ再生するメッセージを検索する場合は、replay(String,String, String,String,String) 操作を選択してください。startScanDate および endScanDate フィールドで、期間を指定します。

6. 再生オプションを指定します。

   1. アドレス フィールドには、再生するメッセージのアドレスを指定します。
   2. target フィールドで、再生されたメッセージを送信するブローカー上のアドレスを指定します。
   3. (オプション) filter フィールドで、フィルター文字列に一致するメッセージのみを再生する文字列を指定します。たとえば、メッセージに storeID プロパティーがある場合、storeID="1000" のフィルターを使用して、ストア ID 値が 1000 のすべてのメッセージを再生できます。フィルターを指定しない場合、スキャンされたジャーナルファイルコピーのすべてのメッセージが AMQ Broker に再生されます。
7. Execute をクリックします。

手順

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

2. core 要素内に journal-compact-min-files パラメーターおよび journal-compact-percentage パラメーターを追加し、値を指定します。以下に例を示します。

   <configuration>
     <core>
       ...
       <journal-compact-min-files>15</journal-compact-min-files>
       <journal-compact-percentage>25</journal-compact-percentage>
       ...
     </core>
   </configuration>

   journal-compact-min-files

   圧縮の開始前にブローカーが最小限作成する必要のあるジャーナルファイル数。デフォルト値は 10 です。値を 0 に設定すると、圧縮が無効になります。ジャーナルのサイズが無限に増加する可能性があるため、コンパクションの無効化に注意する必要があります。

   journal-compact-percentage

   ジャーナルファイルのライブデータの割合。このパーセンテージ未満のデータがライブデータとみなされ (journal-compact-min-files の設定値にも達している場合)、圧縮が開始されます。デフォルト値は 30 です。

手順

1. <broker_instance_dir> ディレクトリーの所有者として、ブローカーを停止します。以下の例は、ユーザー amq-broker を示しています。

   su - amq-broker
   cd <broker_instance_dir>/bin
   $ ./artemis stop

2. (オプション) 以下の CLI コマンドを実行して、データツールのパラメーターの全リストを取得します。デフォルトでは、このツールは <broker_instance_dir>/etc/broker.xml にある設定を使用します。

   $ ./artemis help data compact.

3. 以下の CLI コマンドを実行して、データを圧縮します。

   $ ./artemis data compact.

4. ツールがデータを正常に圧縮したら、ブローカーを再起動します。

   $ ./artemis run