Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

14.3. jca Cryostat 구성

jca 하위 시스템은 Jakarta Connectors 컨테이너 및 리소스 어댑터 배포의 일반 설정을 제어합니다. 관리 콘솔 또는 관리 CLI를 사용하여 jca 하위 시스템을 구성할 수 있습니다.

구성할 주요 jca 하위 시스템 요소는 다음과 같습니다.

14.3.1. 관리 콘솔의 JCA 하위 시스템 설정
링크 복사

구성 Cryostat JCA 로 이동하고 보기를 클릭하여 관리 콘솔에서 jca 하위 시스템을 구성할 수 있습니다. 그런 다음 적절한 탭을 선택합니다.

  • 설정

    캐시된 연결 관리자, 아카이브 유효성 검사 및 빈 유효성 검사에 대한 설정이 포함되어 있습니다. 적절한 탭을 열고 편집 링크를 클릭하여 이러한 설정을 수정합니다.

  • 부트스트랩 컨텍스트

    구성된 부트스트랩 컨텍스트 목록을 포함합니다. 새 부트스트랩 컨텍스트 오브젝트를 추가, 제거 및 구성할 수 있습니다. 각 부트스트랩 컨텍스트는 작업 관리자를 할당해야 합니다.

  • WorkManager

    구성된 작업 관리자 목록을 포함합니다. 새로운 작업 관리자는 여기에 구성된 해당 스레드 풀을 추가, 제거, 제거할 수 있습니다. 각 작업 관리자는 하나의 단기 실행 스레드 풀과 선택적인 장기 실행 스레드 풀을 가질 수 있습니다.

선택한 작업 관리자에서 스레드 풀 을 클릭하여 스레드 풀 속성을 구성할 수 있습니다.

14.3.2. 관리 CLI의 JCA 하위 시스템 설정
링크 복사

이 절차의 단계에 따라 관리 CLI를 사용하여 jca 하위 시스템을 구성할 수 있습니다.

프로세스

  1. 관리 CLI를 사용하여 jca 하위 시스템을 구성합니다. 
/subsystem=jca

  1. 관리형 도메인에서 명령 앞에 다음을 붙여야 합니다. 

    /profile=PROFILE_NAME
참고

다음 섹션의 표의 특성 이름은 관리 모델(예: 관리 CLI 사용 시)에 표시되는 대로 나열됩니다. 관리 모델의 차이가 있을 수 있으므로 EAP_HOME/docs/schema/wildfly-jca_5_0.xsd 에 있는 스키마 정의 파일을 참조하십시오.

14.3.3. 아카이브 검증
링크 복사

배포 단위에서 아카이브 유효성 검사를 수행할지 여부를 결정합니다. 다음 표에서는 아카이브 검증을 위해 설정할 수 있는 특성에 대해 설명합니다.

Expand
표 14.1. 아카이브 검증 속성
속성기본값설명

enabled

true

아카이브 유효성 검사가 활성화되었는지 여부를 지정합니다.

fail-on-error

true

아카이브 검증 오류 보고서가 배포에 실패하는지 여부를 지정합니다.

fail-on-warn

false

아카이브 검증 경고 보고서가 배포에 실패하는지 여부를 지정합니다.

아카이브 유효성 검사를 지정하지 않으면 존재하는 것으로 간주되며 enabled 속성은 기본적으로 true 로 설정됩니다.

배포 중 오류 메시지 예

Severity: ERROR
Section: 19.4.2
Description: A ResourceAdapter must implement a "public int hashCode()" method.
Code: com.mycompany.myproject.ResourceAdapterImpl

Severity: ERROR
Section: 19.4.2
Description: A ResourceAdapter must implement a "public boolean equals(Object)" method.
Code: com.mycompany.myproject.ResourceAdapterImpl

14.3.4. Cryostat 검증
링크 복사

Cryostat 유효성 검사에 따라 metrics 유효성 검사가 수행되는지 여부를 결정합니다. 사양에 대한 자세한 내용은 Jakarta Cryostat Validation 사양 을 참조하십시오.

Expand
표 14.2. Cryostat 검증 속성
속성기본값설명

enabled

true

Cryostat 유효성 검사가 활성화되었는지 여부를 지정합니다.

Cryostat 유효성 검사를 지정하지 않으면 존재하는 것으로 간주되며 enabled 속성은 기본적으로 true 로 설정됩니다.

14.3.5. 작업 관리자
링크 복사

작업 관리자는 Jakarta Connectors 하위 시스템 내에서 작업 인스턴스를 관리합니다. 작업 관리자는 다음 두 가지 유형이 있습니다.

  • 기본 작업 관리자

    기본 작업 관리자 및 해당 스레드 풀입니다.

  • 사용자 정의 작업 관리자

    사용자 지정 작업 관리자 정의 및 해당 스레드 풀.

Expand
표 14.3. 작업 관리자 속성
속성설명

name

작업 관리자의 이름을 지정합니다.

Elytron-enabled

작업 관리자를 위한 Elytron 보안을 활성화합니다.

또한 작업 관리자에는 다음과 같은 하위 요소가 있습니다.

Expand
표 14.4. 작업 관리자 하위 요소
하위 요소설명

short-running-threads

표준 작업 인스턴스의 스레드 풀입니다. 각 작업 관리자에게는 하나의 단기 실행 스레드 풀이 있습니다.

long-running-threads

Jakarta Connectors 1.7 Work 인스턴스의 스레드 풀은 LONG_RUNNING 힌트를 설정합니다. 각 작업 관리자에게는 선택적 장기 실행 스레드 풀이 하나만 있을 수 있습니다.

다음 표에서는 작업 관리자 스레드 풀에 설정할 수 있는 특성에 대해 설명합니다.

Expand
표 14.5. 스레드 풀 속성
속성설명

allow-core-timeout

코어 스레드가 시간 초과될 수 있는지 여부를 결정하는 부울 설정입니다. 기본값은 false입니다.

core-threads

코어 스레드 풀 크기입니다. 이는 최대 스레드 풀 크기보다 크거나 같아야 합니다.

handoff-executor

작업을 수락할 수 없는 경우 작업을 위임하는 executor입니다. 지정하지 않으면 수락할 수 없는 작업이 자동으로 삭제됩니다.

keepalive-time

작업을 수행한 후 풀 스레드를 유지해야 하는 시간을 지정합니다.

max-threads

최대 스레드 풀 크기입니다.

name

스레드 풀의 이름을 지정합니다.

queue-length

최대 큐 길이입니다.

thread-factory

스레드 팩토리에 대한 참조입니다.

14.3.6. 분산 작업 관리자
링크 복사

분산 작업 관리자는 다른 작업 관리자 인스턴스에서 작업 실행을 다시 예약할 수 있는 작업 관리자 인스턴스입니다.

다음 예제 관리 CLI 명령은 분산 작업 관리자를 구성합니다. 독립 실행형 서버의 standalone-ha.xml 또는 standalone-full-ha.xml 구성 파일과 같은 고가용성 기능을 제공하는 구성을 사용해야 합니다.

예: 분산 작업 관리자 구성

batch
/subsystem=jca/distributed-workmanager=myDistWorkMgr:add(name=myDistWorkMgr)
/subsystem=jca/distributed-workmanager=myDistWorkMgr/short-running-threads=myDistWorkMgr:add(queue-length=10,max-threads=10)
/subsystem=jca/bootstrap-context=myCustomContext:add(name=myCustomContext,workmanager=myDistWorkMgr)
run-batch

참고

short-running-threads 요소의 이름은 distributed-workmanager 요소의 이름과 동일해야 합니다.

다음 표에서는 분산 작업 관리자를 위해 구성할 수 있는 특성에 대해 설명합니다.

Expand
표 14.6. 분산 작업 관리자 속성
속성설명

Elytron-enabled

작업 관리자를 위한 Elytron 보안을 활성화합니다.

name

분산 작업 관리자의 이름입니다.

policy

정책은 작업 인스턴스를 재배포할 시기를 결정합니다. 허용되는 값은 다음과 같습니다.

  • NEVER - 작업 인스턴스를 다른 노드에 배포해서는 안 됩니다.
  • 항상 - 항상 작업 인스턴스를 다른 노드에 배포합니다.
  • WATERMARK - 현재 노드에서 사용 가능한 사용 가능한 작업자 스레드 수에 따라 작업 인스턴스를 다른 노드에 분산합니다.

policy-options

정책의 키/값 쌍 옵션 목록입니다. WATERMARK 정책을 사용하는 경우 워터마크 정책 옵션을 사용하여 작동하는 사용 가능한 스레드 수를 배포할 수 있습니다. 예를 들면 다음과 같습니다. 

/subsystem=jca/distributed-workmanager=myDistWorkMgr:write-attribute(name=policy-options,value={watermark=3})

선택기

선택기는 네트워크에서 work 인스턴스를 재배포할 노드를 결정합니다. 허용되는 값은 다음과 같습니다.

  • FIRST_AVAILABLE - 목록에서 사용 가능한 첫 번째 노드를 선택합니다.
  • PING_TIME - ping 시간이 가장 낮은 노드를 선택합니다.
  • MAX_FREE_THREADS - 사용 가능한 작업자 스레드 수가 가장 많은 노드를 선택합니다.

selector-options

선택기의 키/값 쌍 옵션 목록입니다.

분산 작업 관리자에는 다음과 같은 하위 요소가 있습니다.

Expand
표 14.7. 분산 작업 관리자 하위 요소
하위 요소설명

long-running-threads

LONG_RUNNING 힌트를 설정하는 작업 인스턴스의 스레드 풀입니다. 각 분산 작업 관리자는 선택적으로 장기 실행 스레드 풀이 있을 수 있습니다.

short-running-threads

표준 작업 인스턴스의 스레드 풀입니다. 각 분산 작업 관리자는 짧은 실행 스레드 풀이 있어야 합니다.

14.3.7. 부트스트랩 컨텍스트
링크 복사

이는 사용자 지정 부트스트랩 컨텍스트를 정의하는 데 사용됩니다. 다음 표에서는 부트스트랩 컨텍스트에 대해 설정할 수 있는 특성을 설명합니다.

Expand
표 14.8. 부트스트랩 컨텍스트 속성
속성설명

name

부트스트랩 컨텍스트의 이름을 지정합니다.

WorkManager

이 컨텍스트에 사용할 작업 관리자의 이름을 지정합니다.

14.3.8. 캐시된 연결 관리자
링크 복사

캐시된 연결 관리자는 연결을 디버깅하고 트랜잭션에서 연결 지연을 지원하는 데 사용되며 애플리케이션에서 올바르게 사용 및 릴리스되는지 여부를 추적합니다. 다음 표에서는 캐시된 연결 관리자에 대해 설정할 수 있는 특성에 대해 설명합니다.

Expand
표 14.9. 캐시된 연결 관리자 속성
속성기본값설명

debug

false

연결을 명시적으로 종료하지 못한 경우 경고를 출력합니다.

error

false

연결을 명시적으로 닫지 못하는 경우 예외를 throw합니다.

ignore-unknown-connections

false

알 수 없는 연결이 캐시되지 않도록 지정합니다.

설치

false

캐시된 연결 관리자 구성 및 인터셉터를 활성화하거나 비활성화합니다.

14.3.9. 관리 CLI를 사용하여 리소스 어댑터 배포
링크 복사

관리 CLI를 사용하여 리소스 어댑터를 배포합니다.

사전 요구 사항

  • 관리 CLI에 액세스합니다.

프로세스

  1. 독립 실행형 서버에 리소스 어댑터를 배포합니다. 

       ----
   deploy /path/to/resource-adapter.rar
   ----

  2. 관리형 도메인의 모든 서버 그룹에 리소스 어댑터를 배포합니다. 

       ----
   deploy /path/to/resource-adapter.rar --all-server-groups
   ----

14.3.10. 관리 콘솔을 사용하여 리소스 어댑터 배포
링크 복사

관리 콘솔을 사용하여 리소스 어댑터를 배포합니다.

사전 요구 사항

  • 관리 콘솔에 액세스합니다.

프로세스

  1. 관리 콘솔에 로그인합니다.
  2. Deployments 탭으로 이동합니다.

  3. Add (+) 버튼을 클릭합니다.

    • 관리형 도메인에서 먼저 Content Repository 를 선택해야 합니다.
  4. Upload Deployment 옵션을 선택합니다.
  5. 리소스 어댑터 아카이브로 이동하여 다음을 클릭합니다.
  6. 업로드를 확인한 다음 완료 를 클릭합니다.
  7. 관리형 도메인에서 배포를 적절한 서버 그룹에 배포하고 배포를 활성화합니다.

14.3.11. 배포 스캐너를 사용하여 리소스 어댑터 배포
링크 복사

독립 실행형 서버에서 배포 스캐너를 사용하여 리소스 어댑터를 배포합니다.

사전 요구 사항

  • 서버의 파일 시스템에 액세스합니다.

프로세스

  • 독립 실행형 서버에 리소스 어댑터를 수동으로 배포하려면 리소스 어댑터 아카이브를 서버 배포 디렉터리(예: EAP_HOME/standalone/deployments/ )에 복사합니다. 이는 배포 스캐너에 의해 선택 및 배포됩니다.
참고

이 옵션은 관리형 도메인에서 사용할 수 없습니다. 관리 콘솔 또는 관리 CLI를 사용하여 리소스 어댑터를 서버 그룹에 배포해야 합니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2026 Red Hat맨 위로 이동