Cassandra konfigurieren

In diesem Dokument wird die Konfiguration von Cassandra 5.0.X behandelt, das in Apigee Edge für Private Cloud Version 4.54.00 oder höher enthalten ist. Details zum Anwenden der auf dieser Seite beschriebenen Konfigurationen finden Sie im Anhang.

Konfiguration des Garbage Collectors

G1GC-Einstellungen ändern

Standardmäßig wird Cassandra mit dem G1 Garbage Collector (G1GC) ausgeliefert und bietet Standardparameter für G1GC. Da Cassandra 5.0.X unter Java 17 ausgeführt wird, wird der Concurrent Mark Sweep (CMS) Garbage Collector (conf_jvm_options_gc_type=cms und conf_jvm_options_cms_gc_setting_lines) nicht mehr unterstützt. Wenn Sie die G1GC-Parameter ändern möchten, legen Sie die Property conf_jvm_options_g1_gc_setting_lines in einer einzelnen Zeile fest, wobei die einzelnen JVM-Parameter durch \n getrennt sind.

Beispiel:

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

Eigene GC-Einstellungen verwenden

Wenn Sie die Voreinstellungen von Apigee für G1GC ignorieren möchten, legen Sie die folgende Konfiguration fest:

conf_jvm_options_gc_type=custom

Geben Sie alle GC-Einstellungen für die JVM in conf_jvm_options_custom_settings an und trennen Sie die einzelnen Einstellungen durch \n.

Beispiel:

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

Heap-Größen konfigurieren

Apigee empfiehlt dringend, Cassandra mit maximal 8 GB Heap-Speicher zu betreiben. Prüfungen, um die Heap-Größe auf 8 GB zu beschränken, finden Sie in $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

Wenn Sie Ihre eigene Heap-Größe angeben möchten, ohne die Prüfungen manuell zu deaktivieren, verwenden Sie die Konfiguration conf_jvm_options_custom_settings. Trennen Sie die einzelnen Einstellungen durch \n.

Beispiel:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

Allgemeine JVM-Einstellungen konfigurieren

Wenn Sie JVM-Parameter zu Cassandra hinzufügen möchten, geben Sie alle JVM-Konfigurationen in einer einzelnen Zeile an, die durch \n für die Konfiguration conf_jvm_options_custom_settings getrennt sind.

Beispiel:

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

Anhang

Cassandra-Konfiguration festlegen

  1. Erstellen oder bearbeiten Sie die Überschreibungsdatei für die Cassandra-Konfiguration: 
    vi $APIGEE_ROOT/customer/application/cassandra.properties
  2. Fügen Sie die Konfigurationszeile nach Bedarf hinzu, entfernen oder ändern Sie sie.
  3. Speichern Sie die Datei und prüfen Sie, ob sie dem Nutzer „apigee“ gehört und von ihm gelesen werden kann: 
    chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
  4. Starten Sie den Cassandra-Dienst auf dem Knoten neu: 
    apigee-service apigee-cassandra restart
  5. Wiederholen Sie diese Schritte einzeln auf jedem Cassandra-Knoten.

Verschiedene Arten der Konfiguration

Mit der Konfiguration conf_jvm_options_custom_settings können verschiedene Parameter an die Cassandra-JVM übergeben werden. Kombinieren Sie verschiedene Java-Parameter in einer einzelnen Konfiguration und trennen Sie sie durch „\n“.

Beispiel:

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