Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Configurer Cassandra

Ce document traite de la configuration de Cassandra 5.0.X, inclus dans Apigee Edge pour le cloud privé version 4.54.00 ou ultérieure. Pour en savoir plus sur l'application des configurations décrites sur cette page, consultez la section Annexe.

Configuration du récupérateur de mémoire

Modifier les paramètres G1GC

Par défaut, Apigee fournit Cassandra avec le récupérateur de mémoire G1 (G1GC) et des paramètres G1GC par défaut. Étant donné que Cassandra 5.0.X s'exécute sur Java 17, le récupérateur de mémoire Concurrent Mark Sweep (CMS) (conf_jvm_options_gc_type=cms et conf_jvm_options_cms_gc_setting_lines) n'est plus compatible. Pour modifier les paramètres G1GC, définissez la propriété conf_jvm_options_g1_gc_setting_lines sur une seule ligne, chaque paramètre JVM étant séparé par \n.

Exemple :

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

Utiliser vos propres paramètres GC

Pour ignorer les préréglages d'Apigee pour G1GC, définissez la configuration suivante :

conf_jvm_options_gc_type=custom

Spécifiez tous les paramètres GC pour la JVM dans conf_jvm_options_custom_settings, en séparant chaque paramètre par \n.

Exemple :

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

Remarque : Le paramètre conf_jvm_options_gc_type=custom est une configuration avancée qu'Apigee ne recommande pas. En cas de problème dans Cassandra, Apigee recommande de revenir aux paramètres G1GC prédéfinis avant de résoudre le problème.

Configurer la taille des tas de mémoire

Apigee recommande vivement d'utiliser Cassandra avec un espace de tas de mémoire ne dépassant pas 8 Go. Les vérifications permettant de limiter la taille du tas de mémoire à 8 Go se trouvent dans $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

Pour spécifier votre propre dimensionnement de tas de mémoire sans désactiver manuellement les vérifications, utilisez la configuration conf_jvm_options_custom_settings. Séparez chaque paramètre par \n.

Exemple :

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

Configurer les paramètres JVM généraux

Pour ajouter des paramètres JVM à Cassandra, spécifiez toutes les configurations JVM sur une seule ligne, séparées par \n pour la configuration conf_jvm_options_custom_settings.

Exemple :

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

Annexe

Définir une configuration Cassandra

Créez ou modifiez le fichier de remplacement de la configuration Cassandra :
```
vi $APIGEE_ROOT/customer/application/cassandra.properties
```
Ajoutez, supprimez ou modifiez la ligne de configuration selon vos besoins.
Enregistrez le fichier et assurez-vous qu'il appartient à l'utilisateur "apigee" et qu'il est lisible par celui-ci :
```
chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
```
Redémarrez le service Cassandra sur le nœud :
```
apigee-service apigee-cassandra restart
```
Répétez ces étapes sur chaque nœud Cassandra, un par un.

Différents types de configuration

La configuration conf_jvm_options_custom_settings peut transmettre différents paramètres à la JVM Cassandra. Combinez différents paramètres Java dans une seule configuration et séparez-les par "\n".

Exemple :

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