Configurar o Cassandra

Este documento aborda a configuração do Cassandra 5.0.X, incluído no Apigee Edge para nuvem privada versão 4.54.00 ou mais recente. Consulte a seção Apêndice para mais detalhes sobre como aplicar as configurações descritas nesta página.

Configuração do coletor de lixo

Modificar as configurações do G1GC

Por padrão, a Apigee envia o Cassandra com o coletor de lixo G1 (G1GC) e fornece parâmetros padrão do G1GC. Como o Cassandra 5.0.X é executado no Java 17, o coletor de lixo Concurrent Mark Sweep (CMS) (conf_jvm_options_gc_type=cms e conf_jvm_options_cms_gc_setting_lines) não é mais compatível. Para mudar os parâmetros do G1GC, defina a propriedade conf_jvm_options_g1_gc_setting_lines em uma única linha com cada parâmetro da JVM separado por \n.

Exemplo:

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

Usar suas próprias configurações de GC

Para ignorar as predefinições da Apigee para G1GC, defina a seguinte configuração:

conf_jvm_options_gc_type=custom

Especifique todas as configurações de GC para a JVM em conf_jvm_options_custom_settings, separando cada configuração por \n.

Exemplo:

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

Configurar tamanhos de heap

A Apigee recomenda operar o Cassandra com no máximo 8 GB de espaço de heap. As verificações para limitar o tamanho do heap a 8 GB estão em $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

Para especificar seu próprio dimensionamento de heap sem desativar as verificações manualmente, use a configuração conf_jvm_options_custom_settings. Separe cada configuração por \n.

Exemplo:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

Configurar as configurações gerais da JVM

Para adicionar parâmetros da JVM ao Cassandra, especifique todas as configurações da JVM em uma única linha separada por \n para a configuração conf_jvm_options_custom_settings.

Exemplo:

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

Apêndice

Como definir qualquer configuração do Cassandra

  1. Crie ou edite o arquivo de substituição de configuração do Cassandra:
    vi $APIGEE_ROOT/customer/application/cassandra.properties
  2. Adicione, remova ou modifique a linha de configuração conforme necessário.
  3. Salve o arquivo e verifique se ele pertence e pode ser lido pelo usuário "apigee":
    chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
  4. Reinicie o serviço do Cassandra no nó:
    apigee-service apigee-cassandra restart
  5. Repita essas etapas em cada nó do Cassandra, um por um.

Tipos variados de configuração

A configuração conf_jvm_options_custom_settings pode transmitir diferentes parâmetros para a JVM do Cassandra. Combine vários parâmetros Java em uma única configuração e separe por "\n".

Exemplo:

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