A.36. modcluster 하위 시스템 속성

modcluster 하위 시스템에는 다음과 같은 구조가 있습니다.

load-provider=dynamic 리소스를 사용하면 CPU, 세션, 힙, 메모리 및 가중치와 같은 요소를 구성하여 부하 분산 동작을 확인할 수 있습니다.

load-provider=simple 리소스를 사용하면 요소 특성으로 정적 상수만 설정할 수 있습니다. 이를 통해 사용자는 들어오는 HTTP 요청을 부하 분산하는 데 동적 또는 복잡한 규칙이 필요하지 않은 경우 유용합니다.

참고

이러한 테이블의 특성 이름은 관리 CLI를 사용하는 경우와 같이 관리 모델에 표시되는 대로 나열됩니다. 관리 모델과 다를 수 있으므로 EAP_HOME/docs/schema/jboss-as-mod-cluster_3_0.xsd 에 있는 스키마 정의 파일을 참조하여 XML에 표시되는 요소를 확인합니다.

표 A.134. 프록시 구성 옵션

속성Default설명

advertise

true

멀티캐스트 기반 광고 메커니즘을 사용할지 여부입니다.

advertise-security-key

 

httpd 인스턴스에서 알림을 수신 대기하는 httpd 인스턴스와 JBoss EAP 서버 간의 공유 비밀입니다.

advertise-socket

 

역방향 프록시에서 등록할 밸런서의 이름입니다.

auto-enable-contexts

true

false로 설정하면 컨텍스트가 비활성화된 역방향 프록시에 등록됩니다. enable-context 작업을 사용하거나 mod_cluster_manager 콘솔을 사용하여 컨텍스트를 활성화할 수 있습니다.

밸런서

 

역방향 프록시에서 등록할 밸런서의 이름입니다. 설정되지 않은 경우 기본값은 myclusterManagerBalancerName 지시문을 사용하여 Apache HTTP Server측에 구성됩니다.

커넥터

 

mod_cluster 역방향 프록시가 연결할 Undertow 리스너의 이름입니다.

제외된 컨텍스트

 

역방향 프록시와의 등록에서 제외할 컨텍스트 목록입니다. 호스트가 표시되지 않으면 호스트는 localhost 로 간주됩니다. ROOT 는 웹 애플리케이션의 루트 컨텍스트를 나타냅니다.

flush-packets

false

웹 서버에 대한 패킷 플러시 활성화 여부.

flush-wait

-1

httpd에서 패킷을 플러시하기 전에 대기하는 시간입니다. 최대 값은 2,147,483,647 입니다.

리스너

 

역방향 프록시에 등록할 Undertow 리스너의 이름입니다.

load-balancing-group

 

설정된 경우 요청이 로드 밸런서의 지정된 로드 밸런싱 그룹으로 전송됩니다.

max-attempts

1

역방향 프록시가 포기하기 전에 지정된 요청을 작업자로 보내는 횟수입니다.

node-timeout

-1

작업자에 대한 프록시 연결의 제한 시간(초)입니다. 이제 mod_cluster가 오류를 반환하기 전에 백엔드 응답을 기다리는 시간입니다. node-timeout 특성이 정의되지 않은 경우 httpd ProxyTimeout 지시문이 사용됩니다. ProxyTimeout 이 정의되지 않은 경우 httpd Timeout 지시문이 사용되며 기본값은 300초입니다.

Ping

10

Pong 응답이 ping에 대기할 시간(초)입니다.

프록시

 

socket-binding-group 의 outbound -socket-binding 에서 정의한 을 등록하기 위한 mod_cluster의 프록시 목록입니다.

proxy-list

 

프록시 목록. 형식은 HOST_NAME:PORT 이며 쉼표로 구분되어 있습니다. 더 이상 사용되지 않는 프록시 를 사용합니다.

proxy-url

/

MCMP 요청에 대한 기본 URL입니다.

session-draining-strategy

기본값

웹 애플리케이션 배포 취소 중에 사용되는 세션 드레이닝 전략. 유효한 값은 DEFAULT,ALWAYS 또는 NEVER 입니다.

기본값
웹 애플리케이션이 배포 불가능한 경우에만 웹 애플리케이션을 배포 취소하기 전에 세션을 드레이닝합니다.
ALWAYS
배포 가능한 웹 애플리케이션에 대해서도 웹 애플리케이션을 배포 취소하기 전에 항상 세션을 드레인합니다.
NEVER
웹 애플리케이션을 배포 취소하기 전에 세션을 드레이닝하지 마십시오.

load-provider=simple

 

동적 로드 프로바이더가 없는 경우 사용할 로드 프로바이더입니다. 각 클러스터 구성원에게 부하 계수 1을 할당하고 부하 분산 알고리즘을 적용하지 않고 작업을 균등하게 배포합니다.

smax

-1

httpd의 소프트 최대 유휴 연결 수.

socket-timeout

20

시간 초과 전에 httpd 프록시에서 MCMP 명령으로 응답할 때까지 대기하는 시간(초) 및 오류와 같이 프록시 플래그를 지정합니다.

ssl-context

 

mod_cluster에서 사용할 SSLContext 에 대한 참조입니다.

status-interval

10

STATUS 메시지가 애플리케이션 서버에서 역방향 프록시로 전송되는 시간(초)입니다. 허용되는 값은 1 에서 2,147,483,647 사이입니다.

sticky-session

true

지정된 세션에 대한 후속 요청이 가능한 경우 동일한 노드로 라우팅해야 하는지 여부입니다.

sticky-session-force

false

밸런서가 정지된 노드로 요청을 라우팅할 수 없는 경우 역방향 프록시에서 오류를 반환해야 하는지 여부입니다. 고정 세션이 비활성화된 경우 이 설정은 무시됩니다.

sticky-session-remove

false

장애 조치(failover)에서 세션 정보를 제거합니다.

stop-context-timeout

10

컨텍스트에서 보류 중인 요청을 처리하거나 배포 가능한 컨텍스트에 대해 활성 세션을 삭제하는 데 대기하는 최대 시간(초)입니다. 배포 불가능한 컨텍스트의 경우 활성 세션을 삭제합니다.

ttl

-1

smax 위의 유휴 연결의 경우 수명(초)입니다. 허용되는 값은 -1 에서 2,147,483,647 사이입니다.

worker-timeout

-1

사용 가능한 작업자가 요청을 처리할 때까지 httpd에서 대기하는 시간 제한입니다. 허용되는 값은 -1 에서 2,147,483,647 사이입니다.

표 A.135. load-provider=동적 설정 옵션

속성Default설명

decay

2

경기 침체.

내역

9

역사.

initial-load

0

노드에서 보고한 초기 부하. 유효한 범위는 0-100 이며, 0 은 최대 부하를 나타냅니다.

이 특성은 클러스터에 가입하는 동안 과부하를 방지하기 위해 새로 참여한 노드의 부하 값을 점진적으로 늘리는 데 도움이 됩니다.

-1 로 값을 설정하여 이 동작을 비활성화할 수 있습니다. 비활성화되면 노드는 클러스터에 결합할 때 부하 값이 없음을 나타내는 부하 값 100 을 보고합니다.

표 A.136. custom-load-metric 속성 옵션

속성Default설명

용량

1.0

지표의 용량입니다.

클래스

 

사용자 지정 지표의 클래스 이름입니다.

속성

 

지표의 속성입니다.

가중치

1

지표의 가중치입니다.

표 A.137. 로드 메트릭 속성 옵션

속성Default설명

용량

1.0

지표의 용량입니다.

속성

 

지표의 속성입니다.

type

 

지표 유형입니다. 유효한 값은 cpu,mem,heap, session, receive-traffic,send-traffic,requests 또는 busyness 입니다.

가중치

1

지표의 가중치입니다.

표 A.138. SSL 속성 옵션

속성Default설명

ca-certificate-file

 

인증 기관.

ca-revocation-url

 

인증 기관 취소 목록.

certificate-key-file

${user.home}/.keystore

인증서의 키 파일입니다.

cipher-suite

 

허용된 암호화 제품군.

key-alias

 

키 별칭.

암호

변경

암호.

프로토콜

TLS

활성화된 SSL 프로토콜입니다.