Qpid サーバーでのヒープメモリ サイズの構成

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動
情報

Apigee Edge の Qpid サーバーは Java ベースのコンポーネントで、デフォルトのヒープメモリ サイズである 512 MB を使用します。ただし、Apigee Edge のすべてのユースケースに対して、デフォルトのヒープメモリ サイズで十分であるとは限りません。トラフィックと処理の要件に応じて Qpid サーバーのヒープメモリ サイズを調整したり、メモリ関連の問題に対処したりする必要があります。

Java アプリケーションのヒープメモリ サイズは、Java コマンドライン パラメータ -Xms(最小ヒープサイズ)と -Xmx(最大ヒープサイズ)で制御されます。Apigee Edge Qpid サーバーでは、これらは bin_setenv_min_mem プロパティと bin_setenv_max_mem プロパティによって制御されます。これらのプロパティの詳細については、 Java メモリ設定の変更をご覧ください。

このドキュメントでは、Apigee Edge の Qpid サーバーでヒープメモリ サイズを構成する方法について説明します。

始める前に

  • Edge for Private Cloud でのプロパティの構成に慣れていない場合は、Edge の構成方法をご覧ください。
  • Java メモリのデフォルト設定と推奨設定については、Java メモリ設定の変更をご覧ください。

Qpid サーバーのヒープメモリの変更

このセクションでは、Qpid サーバーでヒープメモリ サイズを変更する方法について説明します。最小と最大ヒープメモリは、Qpid サーバー コンポーネントのプロパティ bin_setenv_min_membin_setenv_max_mem で設定できます。

Qpid サーバーでヒープメモリ サイズを変更するには、次の手順を行います。

  1. Qpid サーバーマシンの /opt/apigee/customer/application/qpid-server.properties ファイルをエディタで開きます。ファイルが存在しない場合は作成します。次に例を示します。
    vi /opt/apigee/customer/application/qpid-server.properties
    
  2. このファイルに次の行を追加します。
  3. bin_setenv_min_mem=minimum_heap_in_megabytes
    bin_setenv_max_mem=maximum_heap_in_megabytes
    

    たとえば、Qpid サーバーの最小ヒープと最大ヒープをそれぞれ 1 GB と 2 GB に変更する場合は、このファイルに次の行を追加します。

    bin_setenv_min_mem=1024m
    bin_setenv_max_mem=2048m
    
  4. 変更を保存します。
  5. このプロパティ ファイルの所有者を apigee ユーザーにします。次に例を示します。
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
    
  6. 次のコマンドを使用して Qpid サーバーを再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    
  7. 複数の Qpid サーバーがある場合は、すべての Qpid サーバーでこの手順を繰り返します。

Qpid サーバーのヒープメモリ構成の確認

このセクションでは、Qpid サーバーでヒープメモリの変更が正常に変更されたかどうかを確認する方法について説明します。

bin_setenv_min_mem プロパティと bin_setenv_max_mem プロパティを使用して Qpid サーバーのヒープメモリ サイズを変更した場合でも、実際の Java コマンドライン パラメータ -Xms-Xmx が次のように新しい値に設定されていることを確認する必要があります。

  1. 次のコマンドを使用して、コマンドライン パラメータ -Xms-Xmx に Qpid サーバーの新しい値が設定されているかどうかを確認します。
    ps -ef | grep qpid-server | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
    
  2. Qpid サーバーでヒープメモリの最小値と最大値が変更された場合、上記のコマンドにより、-Xms-Xmx. に新しい値がリスト表示されます。

    Qpid サーバーの最小ヒープと最大ヒープを変更した後の前のコマンドのサンプル結果は次のようになります。

    Xms1024m
    Xmx2048m
    

    出力例では、ヒープの最小値と最大値の新しい値が設定されています。

  3. -Xms-Xmx に古い値がまだ表示される場合は、 Qpid サーバーでヒープメモリ サイズを変更するに記載されているすべての手順に正しく従ったことを確認します。失敗した手順がある場合は、すべての手順を正しく繰り返します。
  4. それでもヒープメモリを変更できない場合は、Apigee サポートにお問い合わせください。

次のステップ

Message Processor のヒープメモリ サイズの構成