กำหนดค่า Cassandra

เอกสารนี้ครอบคลุมการกำหนดค่า Cassandra 5.0.X ซึ่งรวมอยู่ใน Apigee Edge for Private Cloud เวอร์ชัน 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

ใช้การตั้งค่า 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 โดยมีพื้นที่ฮีปไม่เกิน 8 GB การตรวจสอบเพื่อจำกัดขนาดฮีปไว้ที่ 8 GB จะอยู่ใน $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