إعداد Cassandra

يتناول هذا المستند إعداد Cassandra 5.0.X، المضمّن في Apigee Edge للسحابة الإلكترونية الخاصة الإصدار 4.54.00 أو الإصدارات الأحدث. يُرجى الرجوع إلى قسم الملحق للحصول على تفاصيل حول تطبيق عمليات الضبط الموضّحة في هذه الصفحة.

ضبط مجمِّع البيانات غير الضرورية

تعديل إعدادات G1GC

توفّر Apigee Cassandra تلقائيًا مع مجمِّع البيانات غير الضرورية G1 (G1GC) وتوفّر مَعلمات G1GC تلقائية. بما أنّ Cassandra 5.0.X يعمل على Java 17، لم يعُد مجمِّع البيانات غير الضرورية Concurrent Mark Sweep (CMS) (conf_jvm_options_gc_type=cms وconf_jvm_options_cms_gc_setting_lines) متاحًا. لتغيير مَعلمات G1GC، اضبط السمة conf_jvm_options_g1_gc_setting_lines في سطر واحد مع فصل كل مَعلمة من مَعلمات JVM عن الأخرى باستخدام \n.

مثال:

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

استخدام إعدادات مجمِّع البيانات غير الضرورية الخاصة بك

لتجاهل الإعدادات المسبقة التي توفّرها Apigee لـ G1GC، اضبط الإعدادات التالية:

conf_jvm_options_gc_type=custom

حدِّد جميع إعدادات مجمِّع البيانات غير الضرورية لـ JVM في conf_jvm_options_custom_settings، مع فصل كل إعداد عن الآخر باستخدام \n.

مثال:

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

ضبط أحجام الذاكرة المؤقتة

تنصحك Apigee بشدة بتشغيل Cassandra بدون استخدام أكثر من 8 غيغابايت من مساحة الذاكرة المؤقتة. تتوفّر عمليات التحقّق للحدّ من حجم الذاكرة المؤقتة إلى 8 غيغابايت في $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

لتحديد حجم الذاكرة المؤقتة بدون إيقاف عمليات التحقّق يدويًا، استخدِم الإعداد conf_jvm_options_custom_settings. افصل كل إعداد عن الآخر باستخدام \n.

مثال:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

ضبط إعدادات JVM العامة

لإضافة مَعلمات JVM إلى Cassandra، حدِّد جميع إعدادات JVM في سطر واحد مفصول عن الآخر باستخدام \n للإعداد conf_jvm_options_custom_settings.

مثال:

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

الملحق

كيفية ضبط أي إعداد من إعدادات Cassandra

  1. أنشئ ملفًا لتجاوز إعدادات Cassandra أو عدِّله: 
    vi $APIGEE_ROOT/customer/application/cassandra.properties
  2. أضِف سطر الإعداد أو أزِله أو عدِّله حسب الحاجة.
  3. احفظ الملف وتأكَّد من أنّ المستخدم "apigee" هو مالكه ويمكنه قراءته: 
    chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
  4. أعِد تشغيل خدمة Cassandra على العقدة: 
    apigee-service apigee-cassandra restart
  5. كرِّر هذه الخطوات على كل عقدة من عقد Cassandra، واحدة تلو الأخرى.

أنواع الإعدادات المختلفة

يمكن للإعداد conf_jvm_options_custom_settings تمرير مَعلمات مختلفة إلى Cassandra JVM. اجمِع مَعلمات Java المختلفة في إعداد واحد وافصل بينها باستخدام "\n".

مثال:

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