Cassandra 구성

이 문서에서는 Apigee 프라이빗 클라우드용 Edge 버전 4.54.00 이상에 포함된 Cassandra 5.0.X의 구성을 다룹니다. 이 페이지에 설명된 구성을 적용하는 방법에 관한 자세한 내용은 부록 섹션을 참고하세요.

가비지 컬렉터 구성

G1GC 설정 수정

기본적으로 Apigee는 G1 가비지 컬렉터 (G1GC)와 함께 Cassandra를 제공하고 기본 G1GC 매개변수를 제공합니다. Cassandra 5.0.X는 Java 17에서 실행되므로 동시 표시 및 스윕 (CMS) 가비지 컬렉터 (conf_jvm_options_gc_type=cms 및 conf_jvm_options_cms_gc_setting_lines)는 더 이상 지원되지 않습니다. G1GC 매개변수를 변경하려면 각 JVM 매개변수가 \n으로 구분된 단일 행에 conf_jvm_options_g1_gc_setting_lines 속성을 설정합니다.

예:

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 설정 사용

G1GC의 Apigee 사전 설정을 무시하려면 다음 구성을 설정합니다.

conf_jvm_options_gc_type=custom

conf_jvm_options_custom_settings에서 JVM의 모든 GC 설정을 지정하고 각 설정을 \n으로 구분합니다.

예:

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

힙 크기 구성

Apigee는 힙 공간이 8GB 이하인 Cassandra를 운영하는 것이 좋습니다. 힙 크기를 8GB로 제한하는 검사는 $APIGEE_ROOT/apigee-cassandra/conf/cassandra-env.sh에 있습니다.

검사를 수동으로 사용 중지하지 않고 자체 힙 크기를 지정하려면 구성 conf_jvm_options_custom_settings를 사용합니다. 각 설정을 \n으로 구분합니다.

예:

conf_jvm_options_custom_settings=-Xmx8G\n-Xms8G

일반 JVM 설정 구성

Cassandra에 JVM 매개변수를 추가하려면 구성 conf_jvm_options_custom_settings에 대해 \n으로 구분된 단일 행에 모든 JVM 구성을 지정합니다.

예:

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