הגדרת Cassandra

המסמך הזה עוסק בהגדרה של Cassandra 5.0.X, שכלולה ב-Apigee Edge for Private Cloud בגרסה 4.54.00 ואילך. בנספח מוסבר איך להחיל את ההגדרות שמתוארות בדף הזה.

הגדרת מנגנון איסוף הזבל

שינוי ההגדרות של G1GC

כברירת מחדל, Apigee מספקת את Cassandra עם G1 Garbage Collector ‏ (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

שימוש בהגדרות GC משלכם

כדי להתעלם מההגדרות הקבועות מראש של Apigee ל-G1GC, צריך להגדיר את ההגדרה הבאה:

conf_jvm_options_gc_type=custom

מציינים את כל הגדרות ה-GC של ה-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 עם שטח ערימה של עד 8GB. הבדיקות להגבלת גודל הערימה ל-8GB נמצאות ב-$APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

כדי לציין גודל משלכם ל-heap בלי להשבית את הבדיקות באופן ידני, השתמשו בהגדרה 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 יכולה להעביר פרמטרים שונים ל-JVM של Cassandra. אפשר לשלב פרמטרים שונים של Java בהגדרה אחת ולהפריד ביניהם באמצעות ‎\n.

דוגמה:

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