Configura Cassandra

Questo documento illustra la configurazione di Cassandra 5.0.X, incluso in Apigee Edge for Private Cloud versione 4.54.00 o successive. Per informazioni dettagliate sull'applicazione delle configurazioni descritte in questa pagina, consulta la sezione Appendice.

Configurazione del garbage collector

Modificare le impostazioni di G1GC

Per impostazione predefinita, Apigee fornisce Cassandra con il garbage collector G1 (G1GC) e fornisce i parametri G1GC predefiniti. Poiché Cassandra 5.0.X viene eseguito su Java 17, il garbage collector Concurrent Mark Sweep (CMS) (conf_jvm_options_gc_type=cms e conf_jvm_options_cms_gc_setting_lines) non è più supportato. Per modificare i parametri G1GC, imposta la proprietà conf_jvm_options_g1_gc_setting_lines in una singola riga con ogni parametro JVM separato da \n.

Esempio:

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

Utilizzare le proprie impostazioni GC

Per ignorare le impostazioni predefinite di Apigee per G1GC, imposta la seguente configurazione:

conf_jvm_options_gc_type=custom

Specifica tutte le impostazioni GC per la JVM in conf_jvm_options_custom_settings, separando ogni impostazione con \n.

Esempio:

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

Configurare le dimensioni dell'heap

Apigee consiglia vivamente di utilizzare Cassandra con non più di 8 GB di spazio heap. I controlli per limitare la dimensione dell'heap a 8 GB sono in $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

Per specificare le dimensioni dell'heap senza disattivare manualmente i controlli, utilizza la configurazione conf_jvm_options_custom_settings. Separa ogni impostazione con \n.

Esempio:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

Configurare le impostazioni JVM generali

Per aggiungere parametri JVM a Cassandra, specifica tutte le configurazioni JVM in una singola riga separata da \n per la configurazione conf_jvm_options_custom_settings.

Esempio:

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

Appendice

Come impostare qualsiasi configurazione di Cassandra

  1. Crea o modifica il file di override della configurazione di Cassandra:
    vi $APIGEE_ROOT/customer/application/cassandra.properties
  2. Aggiungi, rimuovi o modifica la riga di configurazione in base alle esigenze.
  3. Salva il file e assicurati che sia di proprietà dell'utente "apigee" e che sia leggibile da quest'ultimo:
    chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
  4. Riavvia il servizio Cassandra sul nodo:
    apigee-service apigee-cassandra restart
  5. Ripeti questi passaggi su ogni nodo Cassandra, uno alla volta.

Tipi di configurazione diversi

La configurazione conf_jvm_options_custom_settings può passare parametri diversi alla JVM di Cassandra. Combina vari parametri Java in una singola configurazione e separali con "\n".

Esempio:

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