Mengonfigurasi Cassandra

Dokumen ini membahas konfigurasi Cassandra 5.0.X, yang disertakan dengan Apigee Edge untuk Private Cloud versi 4.54.00 atau yang lebih baru. Lihat bagian Lampiran untuk mengetahui detail tentang penerapan konfigurasi yang dijelaskan di halaman ini.

Konfigurasi pengumpul sampah memori

Mengubah setelan G1GC

Secara default, Apigee mengirimkan Cassandra dengan Pengumpul Sampah Memori G1 (G1GC) dan menyediakan parameter G1GC default. Karena Cassandra 5.0.X berjalan di Java 17, pengumpul sampah memori Concurrent Mark Sweep (CMS) (conf_jvm_options_gc_type=cms dan conf_jvm_options_cms_gc_setting_lines) tidak lagi didukung. Untuk mengubah parameter G1GC, tetapkan properti conf_jvm_options_g1_gc_setting_lines dalam satu baris dengan setiap parameter JVM yang dipisahkan oleh \n.

Contoh:

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

Menggunakan setelan GC Anda sendiri

Untuk mengabaikan preset Apigee untuk G1GC, tetapkan konfigurasi berikut:

conf_jvm_options_gc_type=custom

Tentukan semua setelan GC untuk JVM di conf_jvm_options_custom_settings, dengan memisahkan setiap setelan dengan \n.

Contoh:

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

Mengonfigurasi ukuran heap

Apigee sangat merekomendasikan pengoperasian Cassandra dengan ruang heap tidak lebih dari 8 GB. Pemeriksaan untuk membatasi ukuran heap hingga 8 GB berada di $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

Untuk menentukan ukuran heap Anda sendiri tanpa menonaktifkan pemeriksaan secara manual, gunakan konfigurasi conf_jvm_options_custom_settings. Pisahkan setiap setelan dengan \n.

Contoh:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

Mengonfigurasi setelan JVM umum

Untuk menambahkan parameter JVM ke Cassandra, tentukan semua konfigurasi JVM dalam satu baris yang dipisahkan oleh \n untuk konfigurasi conf_jvm_options_custom_settings.

Contoh:

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

Lampiran

Cara menetapkan konfigurasi Cassandra

  1. Buat atau edit file penggantian konfigurasi Cassandra:
    vi $APIGEE_ROOT/customer/application/cassandra.properties
  2. Tambahkan, hapus, atau ubah baris konfigurasi sesuai kebutuhan.
  3. Simpan file dan pastikan file tersebut dimiliki dan dapat dibaca oleh pengguna “apigee”:
    chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
  4. Mulai ulang layanan Cassandra di node:
    apigee-service apigee-cassandra restart
  5. Ulangi langkah-langkah ini di setiap node Cassandra, satu per satu.

Berbagai jenis konfigurasi

Konfigurasi conf_jvm_options_custom_settings dapat meneruskan parameter yang berbeda ke Cassandra JVM. Gabungkan berbagai parameter Java ke dalam satu konfigurasi dan pisahkan dengan “\n”.

Contoh:

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