Edge for Private Cloud v4.19.01
トラフィック要件や処理要件に応じて、Java ベースの Private Cloud コンポーネントを稼働させるノードのヒープメモリ サイズやクラス メタデータ サイズを変更する必要があります。
このセクションでは、デフォルトと推奨の Java のヒープメモリ サイズに加えて、デフォルトを変更するプロセスについて説明します。最後には、プロパティ ファイルを使用して他の JVM 設定を変更する方法について説明します。
デフォルトと推奨のヒープメモリ サイズ
次の表に、Java ベースの Private Cloud コンポーネントのデフォルトと推奨の Java ヒープメモリ サイズを示します。
| コンポーネント | プロパティのファイル名 | デフォルト ヒープサイズ |
推奨 ヒープサイズ |
|---|---|---|---|
| ランタイム | |||
| Cassandra | なし | 自動的に構成される1 | 自動的に構成される1 |
| Message Processor | message‑processor.properties |
512 MB | 搭載している RAM の 1/2 |
| Router | router.properties |
512 MB | 512 MB |
| 分析 | |||
| Postgres Server | postgres‑server.properties |
512 MB | 512 MB |
| Qpid Server | qpid‑server.properties |
512 MB | 2 GB～4 GB |
| 管理 | |||
| Management Server | management‑server.properties |
512 MB | 512 MB |
| UI | ui.properties |
512 MB | 512 MB |
| OpenLDAP | なし | ネイティブ アプリ2 | ネイティブ アプリ2 |
| Zookeeper | zookeeper.properties |
2,048 MB | 2,048 MB |
| 注 | |||
1 Cassandra は、起動時に最大ヒープサイズを動的に計算します。現在、これは合計システムメモリの半分で、最大 8,192 MB です。 |
|||
| 2 すべての Private Cloud コンポーネントが Java で実装されているわけではありません。ホスト プラットフォームでネイティブに実行されるアプリは、Java ベースではないため、構成可能な Java ヒープサイズがありません。代わりに、ホストシステムでメモリ管理を行っています。 | |||
ノード上の Java ベースのコンポーネントに割り当てる、Apigee で推奨される合計メモリ量を決定するには、そのノードにある各コンポーネントに上記の値を追加します。たとえば、Postgres サーバーと Qpid サーバーの両方をホストしているノードの場合、Apigee では合計メモリ割り当てを 2.5 GB～4.5 GB にすることをおすすめします。
必要なハードウェア（RAM など）のリストについては、インストール要件をご覧ください。
ヒープメモリ サイズを変更する
ヒープメモリ設定を変更するには、コンポーネントのプロパティ ファイルを編集します。たとえば、Message Processor の場合、/opt/apigee/customer/application/message-processor.properties ファイルを編集します。
message-processor.properties ファイルが存在しない場合、または Edge コンポーネントに対応する .properties ファイルが存在しない場合は、次の例に示すように、ファイルを作成して所有権を「apigee」ユーザーに変更します。
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
コンポーネント（たとえば、Message Processor）が複数のマシンにインストールされている場合、そのコンポーネントをホストするすべてのマシンでプロパティ ファイルを編集してください。
次の表に、ヒープサイズを変更するために編集するプロパティを示します。
| プロパティ | 説明 |
|---|---|
bin_setenv_min_mem |
最小ヒープサイズを設定します。デフォルトは、デフォルトと推奨のヒープメモリ サイズに示されている値に基づいています。 この設定は、Java |
bin_setenv_max_mem |
最大ヒープサイズを設定します。デフォルトは、デフォルトと推奨のヒープメモリ サイズに示されている値に基づいています。 この設定は、Java |
bin_setenv_meta_space_size |
デフォルトのクラス メタデータ サイズを設定します。このデフォルト値は この設定は、Java |
上記のプロパティをマシン上のコンポーネントごとに設定し、メガバイトを表す接尾辞「m」を付けます。次に例を示します。
bin_setenv_min_mem=512m
bin_setenv_max_mem=1024m
bin_setenv_meta_space_size=1024m
プロパティ ファイルで値を設定したら、コンポーネントを再起動します。
/opt/apigee/apigee-service/bin/apigee-service component restart
例:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
他の JVM プロパティを変更する
上記に示したプロパティで制御されない Java 設定については、該当する Edge コンポーネントに対応するプロパティ ファイルで以下を設定することもできます。
bin_setenv_ext_jvm_opts: 他のプロパティによって指定されない Java プロパティを設定します。次に例を示します。bin_setenv_ext_jvm_opts=-XX:MaxGCPauseMillis=500
ただし、
-Xms、-Xmx、-XX:MetaspaceSizeについては、値が上記のプロパティによって制御されるため、bin_setenv_ext_jvm_optsを使用して設定しないでください。
Private Cloud コンポーネントのメモリ構成に関する追加のヒントについては、Edge フォーラムのこの記事をご覧ください。