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=15Usar 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=customEspecifique 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=19Configurar 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-Xms8GConfigurar 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:+UnlockCommercialFeaturesApêndice
Como definir qualquer configuração do Cassandra
- Crie ou edite o arquivo de substituição de configuração do Cassandra:
vi $APIGEE_ROOT/customer/application/cassandra.properties - Adicione, remova ou modifique a linha de configuração conforme necessário.
- 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 - Reinicie o serviço do Cassandra no nó:
apigee-service apigee-cassandra restart - 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