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=15Menggunakan setelan GC Anda sendiri
Untuk mengabaikan preset Apigee untuk G1GC, tetapkan konfigurasi berikut:
conf_jvm_options_gc_type=customTentukan 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=19Mengonfigurasi 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-Xms8GMengonfigurasi 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:+UnlockCommercialFeaturesLampiran
Cara menetapkan konfigurasi Cassandra
- Buat atau edit file penggantian konfigurasi Cassandra:
vi $APIGEE_ROOT/customer/application/cassandra.properties - Tambahkan, hapus, atau ubah baris konfigurasi sesuai kebutuhan.
- Simpan file dan pastikan file tersebut dimiliki dan dapat dibaca oleh pengguna “apigee”:
chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties - Mulai ulang layanan Cassandra di node:
apigee-service apigee-cassandra restart - 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