Cassandra を構成する

このドキュメントでは、Apigee Edge for Private Cloud バージョン 4.54.00 以降に含まれている Cassandra 5.0.X の構成について説明します。このページで説明されている構成の適用について詳しくは、付録をご覧ください。

ガベージ コレクタの構成

G1GC 設定を変更する

デフォルトでは、Apigee は Cassandra に G1 ガベージ コレクタ（G1GC）を同梱し、デフォルトの G1GC パラメータを提供します。Cassandra 5.0.X は Java 17 で実行されるため、Concurrent Mark Sweep（CMS）ガベージ コレクタ（conf_jvm_options_gc_type=cms と conf_jvm_options_cms_gc_setting_lines）はサポートされなくなりました。G1GC パラメータを変更するには、conf_jvm_options_g1_gc_setting_lines プロパティを 1 行に設定し、各 JVM パラメータを \n で区切ります。

例:

conf_jvm_options_g1_gc_setting_lines=-XX:+UseG1GC\n-XX:G1RSetUpdatingPauseTimePercent=5\n-XX:MaxGCPauseMillis=500\n-XX:InitiatingHeapOccupancyPercent=50\n-XX:ParallelGCThreads=8\n-XX:ConcGCThreads=8\n-XX:+ParallelRefProcEnabled\n-XX:MaxTenuringThreshold=1\n-XX:G1HeapRegionSize=32m\n-XX:G1ReservePercent=15

独自の GC 設定を使用する

G1GC の Apigee のプリセットを無視するには、次の構成を設定します。

conf_jvm_options_gc_type=custom

JVM のすべての GC 設定を conf_jvm_options_custom_settings で指定し、各設定を \n で区切ります。

例:

conf_jvm_options_gc_type=custom
conf_jvm_options_custom_settings=-XX:+UseParallelGC\n-XX:GCTimeRatio=19

ヒープサイズを構成する

Apigee では、8 GB 以下のヒープ容量で Cassandra を運用することを強くおすすめします。ヒープサイズを 8 GB に制限するチェックは $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh にあります。

チェックを手動で無効にせずに独自のヒープサイズを指定するには、構成 conf_jvm_options_custom_settings を使用します。各設定は \n で区切ります。

例:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

JVM の全般設定を構成する

JVM パラメータを Cassandra に追加するには、構成 conf_jvm_options_custom_settings の 1 行に \n で区切ってすべての JVM 構成を指定します。

例:

conf_jvm_options_custom_settings=-Dcassandra.start_rpc=true\n-Dcassandra.expiration_date_overflow_policy=CAP\n-XX:+FlightRecorder\n-XX:+UnlockCommercialFeatures

付録

Cassandra の構成を設定する方法

  1. Cassandra 構成オーバーライド ファイルを作成または編集します。
    vi $APIGEE_ROOT/customer/application/cassandra.properties
  2. 必要に応じて、構成行を追加、削除、変更します。
  3. ファイルを保存し、apigee ユーザーが所有し、読み取り可能であることを確認します。
    chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
  4. ノードで Cassandra サービスを再起動します。
    apigee-service apigee-cassandra restart
  5. 各 Cassandra ノードで、上記の手順を 1 つずつ繰り返します。

さまざまなタイプの構成

構成 conf_jvm_options_custom_settings は、Cassandra JVM にさまざまなパラメータを渡すことができます。さまざまな Java パラメータを 1 つの構成に結合し、「\n」で区切ります。

例:

conf_jvm_options_custom_settings=-XX:+FlightRecorder\n-XX:+UnlockCommercialFeatures\n-Xmx8G\n-Xms8G