Configura Cassandra

En este documento, se aborda la configuración de Cassandra 5.0.X, que se incluye en Apigee Edge para nube privada versión 4.54.00 o versiones posteriores. Consulta la sección Apéndice para obtener detalles sobre cómo aplicar las configuraciones que se describen en esta página.

Configuración del recolector de elementos no utilizados

Modifica la configuración de G1GC

De forma predeterminada, Apigee envía Cassandra con el recolector de elementos no utilizados G1 (G1GC) y proporciona parámetros predeterminados de G1GC. Debido a que Cassandra 5.0.X se ejecuta en Java 17, el recolector de elementos no utilizados Concurrent Mark Sweep (CMS) (conf_jvm_options_gc_type=cms y conf_jvm_options_cms_gc_setting_lines) ya no es compatible. Para cambiar los parámetros de G1GC, establece la propiedad conf_jvm_options_g1_gc_setting_lines en una sola línea con cada parámetro de JVM separado por \n.

Ejemplo:

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

Usa tu propia configuración de GC

Para ignorar los valores preestablecidos de Apigee para G1GC, establece la siguiente configuración:

conf_jvm_options_gc_type=custom

Especifica todos los parámetros de configuración de GC para la JVM en conf_jvm_options_custom_settings y separa cada parámetro de configuración con \n.

Ejemplo:

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

Configura los tamaños de montón

Apigee recomienda usar Cassandra con no más de 8 GB de espacio de montón. Las verificaciones para limitar el tamaño del montón a 8 GB están en $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

Para especificar tu propio tamaño de montón sin inhabilitar las verificaciones de forma manual, usa la configuración conf_jvm_options_custom_settings. Separa cada parámetro de configuración con \n.

Ejemplo:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

Configura los parámetros generales de JVM

Para agregar parámetros de JVM a Cassandra, especifica todas las configuraciones de JVM en una sola línea separada por \n para la configuración conf_jvm_options_custom_settings.

Ejemplo:

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

Apéndice

Cómo establecer cualquier configuración de Cassandra

  1. Crea o edita el archivo de anulación de configuración de Cassandra:
    vi $APIGEE_ROOT/customer/application/cassandra.properties
  2. Agrega, quita o modifica la línea de configuración según sea necesario.
  3. Guarda el archivo y asegúrate de que el usuario “apigee” sea el propietario y pueda leerlo:
    chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
  4. Reinicia el servicio de Cassandra en el nodo:
    apigee-service apigee-cassandra restart
  5. Repite estos pasos en cada nodo de Cassandra, uno por uno.

Tipos variados de configuración

La configuración conf_jvm_options_custom_settings puede pasar diferentes parámetros a la JVM de Cassandra. Combina varios parámetros de Java en una sola configuración y sepáralos con “\n”.

Ejemplo:

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