A.37. mod_jk 작업자 속성


workers.properties 파일은 mod_jk가 클라이언트 요청을 전달하는 작업자의 동작을 정의합니다. workers.properties 파일은 다양한 애플리케이션 서버가 있는 위치와 워크로드의 균형을 유지하는 방법을 정의합니다.

속성의 일반 구조는 worker입니다.WORKER_NAME.DIRECTIVE. WORKER_NAMEJBoss EAP undertow 하위 시스템에서 구성된 instance-id 와 일치해야 하는 고유한 이름입니다. DIRECTIVE 는 작업자에 적용할 설정입니다.

Apache mod_jk Load Balancers에 대한 설정 참조

템플릿은 로드 밸런서마다 기본 설정을 지정합니다. 로드 밸런서 설정 자체 내에서 템플릿을 재정의할 수 있습니다.

Expand
표 A.139. 글로벌 속성
속성설명

worker.list

mod_jk 에서 사용할 작업자 이름의 쉼표로 구분된 목록입니다.

Expand
표 A.140. 필수 지시문
속성설명

type

작업자 유형입니다. 기본 유형은 ajp13 입니다. 기타 가능한 값은 ajp14,lb,status 입니다. 이러한 지시문에 대한 자세한 내용은 https://tomcat.apache.org/connectors-doc/reference/workers.html 의 Apache Tomcat 커넥터 참조를 참조하십시오.

Expand
표 A.141. 로드 밸런싱 지시문
속성설명

balance_workers

로드 밸런서에서 관리해야 하는 작업자 노드를 지정합니다. 동일한 로드 밸런서에 지시문을 여러 번 사용할 수 있습니다. 이는 쉼표로 구분된 작업자 노드 이름 목록으로 구성됩니다.

sticky_session

동일한 세션의 요청이 항상 동일한 작업자로 라우팅되는지 여부를 지정합니다. 기본값은 1 입니다. 즉, 고정 세션이 활성화됩니다. 고정 세션을 비활성화하려면 0 으로 설정합니다. 모든 요청이 진정한 상태 비저장인 경우가 아니면 고정 세션을 활성화해야 합니다.

Expand
표 A.142. 연결 지시문
속성설명

호스트

백엔드 서버의 호스트 이름 또는 IP 주소입니다. 백엔드 서버는 ajp 프로토콜 스택을 지원해야 합니다. 기본값은 localhost 입니다.

port

정의된 프로토콜 요청을 수신 대기하는 백엔드 서버 인스턴스의 포트 번호입니다. 기본값은 AJP13 작업자의 기본 수신 대기 포트인 8009 입니다. AJP14 작업자의 기본값은 8011 입니다.

ping_mode

네트워크 상태에 대해 연결을 조사하는 조건입니다. 프로브는 CPing에 빈 AJP13 패킷을 사용하고, CPong이 응답해야 합니다. 지시문 플래그의 조합을 사용하여 조건을 지정합니다. 플래그는 쉼표 또는 공백으로 구분되지 않습니다. ping_mode는 C, P, I 및 A의 조합일 수 있습니다.

  • C - 연결. 서버에 연결한 후 한 번 연결을 확인합니다. connect_timeout 값을 사용하여 시간 제한을 지정합니다. 그렇지 않으면 ping_timeout 값이 사용됩니다.
  • P - Prepost. 각 요청을 서버로 전송하기 전에 연결을 조사합니다. prepost_timeout 지시문을 사용하여 시간 제한을 지정합니다. 그렇지 않으면 ping_timeout 값이 사용됩니다.
  • i - 간격. connection_ping_interval로 지정된 간격으로 연결을 검색합니다(있는 경우). 그렇지 않으면 ping_timeout 값이 사용됩니다.
  • A - 모두. 모든 연결 프로브를 사용하도록 지정하는 CPI의 바로 가기입니다.

ping_timeout, connect_timeout, prepost_timeout, connection_ping_interval

위의 연결 프로브 설정에 대한 시간 제한 값입니다. 값은 밀리초 단위로 지정되며 ping_timeout 의 기본값은 10000 입니다.

lbfactor

개별 백엔드 서버 인스턴스에 대한 로드 밸런싱 인수를 지정합니다. 이 기능은 보다 강력한 서버를 더 많은 워크로드를 제공하는 데 유용합니다. 작업자에게 기본 로드의 3배를 제공하려면 이를 3 으로 설정합니다 :worker.my_worker.lbfactor=3

아래 예제에서는 포트 8009 에서 수신 대기하는 두 개의 작업자 노드인 node1node2 간에 고정 세션을 사용한 로드 밸런싱을 보여줍니다.

예: workers.properties 파일

# Define list of workers that will be used for mapping requests
worker.list=loadbalancer,status

# Define Node1
# modify the host as your host IP or DNS name.
worker.node1.port=8009
worker.node1.host=node1.mydomain.com
worker.node1.type=ajp13
worker.node1.ping_mode=A
worker.node1.lbfactor=1

# Define Node2
# modify the host as your host IP or DNS name.
worker.node2.port=8009
worker.node2.host= node2.mydomain.com
worker.node2.type=ajp13
worker.node2.ping_mode=A
worker.node2.lbfactor=1

# Load-balancing behavior
worker.loadbalancer.type=lb
worker.loadbalancer.balance_workers=node1,node2
worker.loadbalancer.sticky_session=1

# Status worker for managing load balancer
worker.status.type=status

Apache mod_jk에 대한 추가 구성 세부 정보는 이 문서의 범위를 벗어나며 Apache 설명서에서 확인할 수 있습니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동