Định cấu hình Cassandra

Tài liệu này trình bày cách định cấu hình Cassandra 5.0.X, được cung cấp kèm theo Apigee Edge cho Cloud riêng tư phiên bản 4.54.00 trở lên. Hãy tham khảo phần Phụ lục để biết thông tin chi tiết về cách áp dụng các cấu hình được mô tả trên trang này.

Cấu hình bộ thu gom rác

Sửa đổi chế độ cài đặt G1GC

Theo mặc định, Apigee cung cấp Cassandra kèm theo Bộ thu gom rác G1 (G1GC) và các tham số G1GC mặc định. Vì Cassandra 5.0.X chạy trên Java 17, nên bộ thu gom rác Concurrent Mark Sweep (CMS) (conf_jvm_options_gc_type=cms và conf_jvm_options_cms_gc_setting_lines) không còn được hỗ trợ. Để thay đổi các tham số G1GC, hãy đặt thuộc tính conf_jvm_options_g1_gc_setting_lines trong một dòng duy nhất với mỗi tham số JVM được phân tách bằng \n.

Ví dụ:

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

Sử dụng chế độ cài đặt GC của riêng bạn

Để bỏ qua các giá trị đặt sẵn của Apigee cho G1GC, hãy đặt cấu hình sau:

conf_jvm_options_gc_type=custom

Chỉ định tất cả chế độ cài đặt GC cho JVM trong conf_jvm_options_custom_settings, phân tách từng chế độ cài đặt bằng \n.

Ví dụ:

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

Định cấu hình kích thước vùng nhớ khối xếp

Apigee đặc biệt khuyên bạn nên vận hành Cassandra với không quá 8 GB dung lượng vùng nhớ khối xếp. Các lượt kiểm tra để giới hạn kích thước vùng nhớ khối xếp ở mức 8 GB nằm trong $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh.

Để chỉ định kích thước vùng nhớ khối xếp của riêng bạn mà không cần tắt các lượt kiểm tra theo cách thủ công, hãy sử dụng cấu hình conf_jvm_options_custom_settings. Phân tách từng chế độ cài đặt bằng \n.

Ví dụ:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

Định cấu hình chế độ cài đặt JVM chung

Để thêm các tham số JVM vào Cassandra, hãy chỉ định tất cả cấu hình JVM trong một dòng duy nhất được phân tách bằng \n cho cấu hình conf_jvm_options_custom_settings.

Ví dụ:

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

Phụ lục

Cách đặt mọi cấu hình Cassandra

  1. Tạo hoặc chỉnh sửa tệp ghi đè cấu hình Cassandra:
    vi $APIGEE_ROOT/customer/application/cassandra.properties
  2. Thêm, xoá hoặc sửa đổi dòng cấu hình theo yêu cầu.
  3. Lưu tệp và đảm bảo rằng tệp đó thuộc sở hữu của người dùng "apigee" và người dùng này có thể đọc tệp đó:
    chown apigee:apigee $APIGEE_ROOT/customer/application/cassandra.properties
  4. Khởi động lại dịch vụ Cassandra trên nút:
    apigee-service apigee-cassandra restart
  5. Lặp lại các bước này trên từng nút Cassandra, từng nút một.

Các loại cấu hình

Cấu hình conf_jvm_options_custom_settings có thể truyền các tham số khác nhau đến Cassandra JVM. Kết hợp nhiều tham số Java vào một cấu hình duy nhất và phân tách bằng "\n".

Ví dụ:

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