پیکربندی Cassandra

این سند پیکربندی Cassandra 5.0.X را پوشش می‌دهد که با Apigee Edge برای Private Cloud نسخه 4.54.00 یا جدیدتر ارائه می‌شود. برای جزئیات مربوط به اعمال پیکربندی‌های شرح‌داده‌شده در این صفحه، به بخش پیوست مراجعه کنید.

پیکربندی زباله‌روب

تغییر تنظیمات G1GC

به‌طور پیش‌فرض، Apigee با «جمع‌آوری‌کننده زباله G1» (G1GC) همراه با Cassandra ارائه می‌شود و پارامترهای پیش‌فرض 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 را با حداکثر ۸ گیگابایت فضای پشته اجرا کنید. بررسی‌هایی برای محدود کردن اندازه پشته به ۸ گیگابایت در $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