| |
| Sun Java System Message Queue 3 2005Q1 관리 설명서 | |
14장
브로커 등록 정보 참조이 장에서는 브로커 구성 등록 정보를 나열하고 설명합니다. 첫 번째 절에서는 전체 설명이 나오는 절에 대한 참조와 함께 모든 브로커 등록 정보를 알파벳 순으로 나열합니다. 모든 다른 절에서는 브로커 등록 정보 집합을 기능별로 그룹화하여 자세히 설명합니다.
이 장은 다음 내용으로 구성되어 있습니다.
설명 테이블에서 등록 정보는 imqcmd update bkr 명령을 사용하여 설정 가능한 경우에 표시됩니다.
알파벳 순 등록 정보 목록표 14-1은 브로커 인스턴스 등록 정보의 알파벳 순 목록입니다. 이 목록에서 등록 정보의 범주를 확인한 다음 범주 설명을 사용하여 이 장의 다른 부분에 있는 전체 등록 정보 설명을 찾을 수 있습니다.
표의 왼쪽 열에는 각 등록 정보가 알파벳 순으로 나열됩니다. 오른쪽 열에는 등록 정보가 속하는 범주와 해당 절에 대한 상호 참조가 표시됩니다.
연결 서비스 등록 정보표 14-2에서는 연결 서비스 등록 정보를 나열합니다. 첫 번째 열에는 등록 정보 이름이 나와 있습니다. 각 등록 정보 이름에 대해 두 번째 열에서는 등록 정보를 설명하고 세 번째 열에서는 등록 정보의 유형을 지정하며 네 번째 열에서는 기본값을 제공합니다.
표 14-2 연결 서비스 등록 정보
등록 정보 이름
설명
유형
기본값
imq.service.activelist
브로커 시작 시 활성화되는 쉼표로 구분된 이름별 연결 서비스 목록입니다. 지원되는 서비스: jms, ssljms, httpjms, httpsjms, admin, ssladmin.
목록
jms,admin
imq.ping.interval
브로커가 연결을 통해 Message Queue 클라이언트 런타임을 연속적으로 핑하는 시도 사이의 간격(초)입니다.
정수
120
imq.hostname
사용 가능한 호스트가 두 개 이상 있는 경우(예: 컴퓨터에 네트워크 인터페이스 카드가 두 개 이상인 경우) 모든 연결 서비스를 바인드할 호스트(호스트 이름 또는 IP 주소)입니다.
문자열
모든 사용 가능한IP 주소
imq.portmapper.port1
브로커의 기본 포트, 즉 포트 매퍼가 위치한 포트입니다. 한 호스트에서 둘 이상의 브로커 인스턴스를 실행하는 경우 각 인스턴스는 고유한 포트 매퍼 포트를 지정 받아야 합니다.
정수
7676
imq.portmapper.hostname
사용 가능한 호스트가 두 개 이상 있는 경우(예: 컴퓨터에 네트워크 인터페이스 카드가 두 개 이상인 경우) 포트 매퍼를 바인드할 호스트(호스트 이름 또는 IP 주소)입니다.
문자열
상속 위치:
imq.hostnameimq.portmapper.backlog
포트 매퍼가 요청 거부 전까지 처리할 수 있는 최대 동시 요청 수입니다. 이 등록 정보는 운영 체제 백로그에 저장되어 포트 매퍼의 처리를 대기할 수 있는 요청 수를 설정합니다.
정수
50
imq.service_name.
protocol_type2.portjms, ssljms, admin 및 ssladmin 서비스에 한해 명명된 연결 서비스의 포트 번호입니다.
httpjms 및 httpsjms 연결 서비스를 구성하려면 부록 C, "HTTP/HTTPS 지원."을 참조하십시오.
정수
0
포트는 포트 매퍼에 의해 동적으로할당됩니다.
imq.service_name.
protocol_type2.hostnamejms, ssljms, admin 및 ssladmin 서비스에 한해, 사용 가능한 호스트가 두 개 이상 있는 경우(예: 컴퓨터에 네트워크 인터페이스 카드가 두 개 이상인 경우) 명명된 연결 서비스를 바인드할 호스트(호스트 이름 또는 IP 주소)입니다.
문자열
상속 위치:
imq.hostnameimq.service_name.
min_threads이 스레드 수에 도달하면 명명된 연결 서비스가 사용할 수 있도록 스레드 풀에서 스레드가 유지 관리됩니다.
기본값은 연결 서비스에 따라 다릅니다.
정수
10 (jms)
10 (ssljms)
10 (httpjms)
10 (httpsjms)
4 (admin)
4 (ssladmin)
imq.service_name.
max_threads이 스레드 수를 초과하면 명명된 연결 서비스가 사용할 수 있는 신규 스레드가 더 이상 스레드 풀에 추가되지 않습니다. 이 수는 0보다 크고 min_threads 값보다 커야 합니다.
기본값은 연결 서비스에 따라 다릅니다.
정수
1000 (jms)
500 (ssljms)
500 (httpjms)
500 (httpsjms)
10 (admin)
10 (ssladmin)
imq.service_name.
threadpool_model명명된 연결 서비스에 대해 스레드가 연결 전용인지(dedicated) 또는 필요에 따라 여러 연결에 의해 공유되는지(shared)를 지정하는 문자열입니다. 공유 모델(스레드 풀 관리)은 브로커가 지원하는 연결 수를 늘리지만, jms 및 admin 연결 서비스에 대해서만 구현됩니다.
기본값은 연결 서비스에 따라 다릅니다.
문자열
dedicated (jms)
dedicated (ssljms)
dedicated (httpjms)
dedicated (httpsjms)
dedicated (admin)
dedicated (ssladmin)
imq.shared.
connectionMonitor_limit공유 스레드 풀 모델에 한해 분산자 스레드가 모니터링할 수 있는 최대 연결 수입니다. (시스템은 모든 연결을 모니터링하기에 충분한 수의 분산자 스레드를 할당). 이 값이 작을수록 시스템은 더 신속하게 스레드에 활성 연결을 지정할 수 있습니다. 값 -1은 제한이 없음을 의미합니다.
기본값은 운영 체제에 따라 다릅니다.
정수
512 (Solaris & Linux)
64 (Windows)
1이 등록 정보는 imqcmd update bkr 명령과 함께 사용할 수 있습니다.
메시지 라우터 등록 정보표 14-3에서는 메시지 라우터 등록 정보를 나열합니다. 첫 번째 열에는 등록 정보 이름이 나와 있습니다. 각 등록 정보 이름에 대해 두 번째 열에서는 등록 정보를 설명하고 세 번째 열에서는 등록 정보의 유형을 지정하며 네 번째 열에서는 기본값을 제공합니다.
대상을 자동으로 작성하도록 메시지 서버 기능을 구성하는 자동 작성 등록 정보는 표 14-4에 나열되어 있습니다.
표 14-3 메시지 라우터 등록 정보
등록 정보 이름
설명
유형
기본값
imq.destination.
DMQ.truncateBody1브로커가 메시지를 사용 불능 메시지 대기열에 저장하기 전에 메시지 본문을 제거할지 여부를 지정하는 부울 값입니다. 값이 true인 경우 브로커는 메시지 헤더와 등록 정보 데이터만 저장합니다. 값이 false인 경우 브로커는 헤더와 본문을 저장합니다.
부울
false
imq.message.
expiration.interval만료된 메시지 재생 이용이 발생하는 간격(초)입니다.
정수
60
imq.system.max_count1
브로커가 보관하는 최대 메시지 수입니다. 추가 메시지가 거부됩니다. 값 -1은 제한이 없음을 의미합니다.
정수
-1
imq.system.max_size1
브로커가 보관하는 최대 전체 메시지 최대 크기(바이트, KB, MB)입니다. 추가 메시지가 거부됩니다. 값 -1은 제한이 없음을 의미합니다.
바이트 문자열2
-1
imq.message.max_size1
메시지 본문의 최대 허용 크기(바이트, KB, MB 단위)입니다. 이 크기를 초과하는 메시지는 거부됩니다. 값 -1은 제한이 없음을 의미합니다.
바이트 문자열2
70m
imq.resource_state.
threshold각 메모리 자원 상태가 트리거되는 메모리 사용률입니다. 자원 상태는 초록, 노랑, 주황 및 빨강으로 표시됩니다.
정수(퍼센트)
0 (green)
80 (yellow)
90(orange)
98 (red)
imq.resource_state.count
시스템 메모리에서 새 메모리 임계값에 도달했는지 여부를 확인하기 전에 일괄 처리에서 허용되는, 받는 메시지의 최대 수입니다. 이 제한은 시스템 메모리가 점점 부족해지면 메시지 생성자를 억제합니다.
정수(퍼센트)
5000 (green)
500 (yellow)
50(orange)
0 (red)
imq.transaction.
autorollbackPREPARED 상태에 있는 분산 트랜잭션이 브로커 시작 시 자동으로 롤백되는지 여부를 지정하는 부울 값입니다. false라면 imqcmd를 사용하여 수동으로 트랜잭션을 완결하거나 롤백해야 합니다(트랜잭션 관리 참조).
부울
false
1이 등록 정보는 imqcmd update bkr 명령과 함께 사용할 수 있습니다.
2바이트 문자열로 입력하는 값은 바이트, KB, MB로 나타낼 수 있습니다. 예를 들어, 1000은 1000바이트를, 7500b는 7500바이트를, 77k는 77KB(77 x 1024 = 78848바이트)를, 17m은 17MB(17 x 1024 x 1024 = 17825792바이트)를 나타냅니다.
표 14-4에서는 대상을 자동으로 작성할 때 브로커가 사용하는 등록 정보를 나열합니다.
표 14-4 자동 작성 구성 등록 정보
등록 정보 이름
설명
유형
기본값
imq.autocreate.destination.
isLocalOnly(브로커 클러스터에만 적용됨). 대상을 다른 브로커에 복제하지 않도록 지정하는 부울 값입니다. 따라서 메시지 전달이 로컬 사용자(대상이 생성되는 브로커에 연결된 사용자)에게만 제한됩니다. 대상이 생성된 이후에는 이 속성을 업데이트할 수 없습니다.
부울
false
imq.autocreate.destination.
limitBehavior메모리 제한 임계값에 도달할 경우에 브로커가 응답하는 방법을 지정하는 문자열입니다. 값은 다음과 같습니다.
이 등록 정보를 REMOVE_OLDEST 또는 REMOVE_LOW_PRIORITY로 설정하고 imq.autocreate.destination.useDMQ를 true로 설정하는 경우 브로커는 초과하는 메시지를 사용 불능 메시지 대기열로 이동합니다.
문자열
REJECT
NEWESTimq.autocreate.destination.
maxBytesPerMsg자동 작성된 대상에 허용되는 단일 메시지의 최대 크기(바이트)입니다. 값이 -1이면 메시지 크기가 제한되지 않습니다.
바이트 문자열1
10k
imq.autocreate.destination.
maxNumMsgs자동 작성된 대상에 허용되는 사용되지 않은 최대 메시지 수입니다. 값이 -1이면 수에 제한이 없습니다.
정수
100,000
imq.autocreate.destination.
maxNumProducers대상에 허용되는 최대 생성자 수입니다. 이 제한에 도달하면 새로운 생성자가 생성되지 않습니다. 값이 -1이면 생성자 수에 제한이 없습니다.
정수
100
imq.autocreate.destination.
maxTotalMsgBytes대상의 사용되지 않은 메시지에 허용되는 최대 메모리 합계(바이트)입니다. 값이 -1이면 메모리에 제한이 없습니다.
바이트 문자열2
10m
imq.autocreate.destination.
useDMQ브로커가 자동 작성된 대상에 대한 사용 불능 메시지를 사용 불능 메시지 대기열로 이동시킬지 여부를 지정하는 부울 값입니다.
부울
true
imq.autocreate.queue2
브로커에 대기열 대상 자동 작성이 허용되는지 여부를 지정하는 부울 값입니다.
부울
true
imq.autocreate.queue.
consumerFlowLimit일괄적으로 사용자에게 전달되는 최대 메시지 수를 지정합니다. 로드 균형 조정된 대기열 전달에서 이 수는 로드 균형 조정을 시작하기 전에 활성 사용자에게 경로 지정되는 초기 대기 메시지 수입니다. 이 제한은 해당 연결에서 대상 사용자에게 지정된 낮은 값으로 대체될 수 있습니다. 값 -1은 무제한을 의미합니다.
정수
1000
imq.autocreate.queue.
localDeliveryPreferred(브로커 클러스터의 로드 균형 조정된 대기열 전달에만 적용됨). 로컬 브로커에 사용자가 없는 경우에만 원격 사용자에게 메시지를 전달하도록 지정하는 부울 값입니다. 자동 작성된 대상을 로컬에만 전달로 제한해서는 안 됩니다(isLocalOnly = false).
부울
false
imq.autocreate.queue.
maxNumActiveConsumers자동 작성된 대기열 대상으로부터의 로드 균형 조정 전달에서 활성 상태가 될 수 있는 최대 사용자 수입니다. 값 -1은 무제한을 의미합니다.
정수
1
imq.autocreate.queue.
maxNumBackupConsumers자동 작성된 대기열 대상으로부터의 로드 균형 조정 전달 중에 오류가 발생할 경우 활성 사용자를 대신할 수 있는 최대 백업 사용자 수입니다. 값 -1은 무제한을 의미합니다.
정수
0
imq.autocreate.topic
브로커에 주제 대상의 자동 작성이 허용되는지 여부를 지정하는 부울 값입니다.
부울
true
imq.autocreate.topic.
consumerFlowLimit일괄적으로 사용자에게 전달되는 최대 메시지 수를 지정합니다. 값 -1은 무제한을 의미합니다.
정수
1000
1바이트 문자열로 입력하는 값은 바이트, KB, MB로 나타낼 수 있습니다. 예를 들어, 1000은 1000바이트를, 7500b는 7500바이트를, 77k는 77KB(77 x 1024 = 78848바이트)를, 17m은 17MB(17 x 1024 x 1024 = 17825792바이트)를 나타냅니다.
2이 등록 정보는 imqcmd update bkr과 함께 사용할 수 있습니다.
지속성 관리자 등록 정보브로커의 지속성 기능을 구성하려면 imq.persist.store 값을 지정하거나 기본값을 적용해야 합니다.
표 14-5 필수 지속성 관리자 등록 정보
등록 정보 이름
설명
유형
기본값
imq.persist.store
브로커가 기본 제공 파일 기반 지속성을 사용하는지 아니면 플러그 인 JDBC 호환 지속성을 사용하는지를 지정하는 문자열입니다.
값은 file 또는 jdbc여야 합니다.
문자열
file
파일 기반 지속성 및 JDBC 기반 지속성을 지원하는 등록 정보는 다음 절에서 설명합니다.
파일 기반 지속성
표 14-6에서는 파일 기반 지속성을 지원하는 등록 정보를 나열합니다. 첫 번째 열에는 등록 정보 이름이 나와 있습니다. 각 등록 정보 이름에 대해 두 번째 열에서는 등록 정보를 설명하고 세 번째 열에서는 등록 정보의 유형을 지정하며 네 번째 열에서는 기본값을 제공합니다.
표 14-6 파일 기반 지속성 등록 정보
등록 정보 이름
설명
유형
기본값
imq.persist.file.sync.
enabled지속성 작업이 메모리 상태에서 물리적 저장 장치와 동기화될 것인지 여부를 지정하는 부울 값입니다. 이 등록 정보가 true로 설정되어 있으면 시스템 충돌로 인한 데이터 손실은 줄어들지만 지속성 작업의 성능이 저하됩니다.
Sun Cluster 및 Sun Cluster Data Service for Message Queue를 실행하는 경우 모든 클러스터 노드의 브로커에 대해 이 등록 정보를 true로 설정합니다.
부울
false
imq.persist.file.message.
max_record_size기본 제공 파일 기반 지속성에 대해 개별 파일에 저장되지 않고 메시지 저장소 파일에 추가될 메시지의 최대 크기입니다.
바이트 문자열1
1m
imq.persist.file.
destination.message.
filepool.limit기본 제공 파일 기반 지속성에 대해 대상 파일 풀에서 재사용 가능한 최대 파일 수입니다. 이 수가 클수록 브로커는 지속성 데이터를 더 빠르게 처리할 수 있습니다. 이 값을 초과하는 사용 가능한 파일은 삭제됩니다. 이 한도를 초과할 경우 브로커는 필요에 따라 추가 파일을 작성하고 삭제합니다.
정수
100
imq.persist.file.message.
filepool.cleanratio기본 제공 파일 기반 지속성에 대해 대상 파일 풀에서 clean 상태(0으로 잘라낸 상태)로 유지되는 사용 가능한 파일의 비율입니다. 이 값이 클수록 작업 중 파일을 지우는 데 필요한 오버헤드가 늘어나지만, 파일 풀에서 필요한 디스크 공간은 줄어듭니다.
정수
0
imq.persist.file.
message.cleanup기본 제공 파일 기반 지속성에 대해 브로커가 종료 시 대상 파일 저장소에서 사용 가능한 파일을 지울 것인지 여부를 지정하는 부울 값입니다. false 값은 브로커 종료 속도를 향상시키지만, 파일 저장소에 더 많은 디스크 공간이 필요합니다.
부울
false
1바이트 문자열로 입력하는 값은 바이트, KB, MB로 나타낼 수 있습니다. 예를 들어, 1000은 1000바이트를, 7500b는 7500바이트를, 77k는 77KB(77 x 1024 = 78848바이트)를, 17m은 17MB(17 x 1024 x 1024 = 17825792바이트)를 나타냅니다.
JDBC 기반 지속성
표 14-7에는 JDBC 기반 지속성을 지원하는 등록 정보가 포함되어 있습니다. 이 표에서는 등록 정보를 나열 및 설명하고 PointBase 제품에서 구성하여 사용하는 방법에 대한 예를 제공합니다.
보안 관리자 등록 정보표 14-8에서는 보안 관리자 등록 정보를 나열합니다. 첫 번째 열에는 등록 정보 이름이 나와 있습니다. 각 등록 정보 이름에 대해 두 번째 열에서는 등록 정보를 설명하고 세 번째 열에서는 등록 정보의 유형을 지정하며 네 번째 열에서는 기본값을 제공합니다.
SSL을 사용하는 경우 다음과 같이 표 14-9에 나열된 키 저장소 구성 등록 정보를 참조하십시오.
표 14-8 보안 관리자 등록 정보
등록 정보 이름
설명
유형
기본값
imq.accesscontrol.file.
enabled브로커가 지원하는 모든 연결 서비스에 대해 액세스 제어를 설정할지 여부를 지정하는 부울 값입니다. 액세스 제어 등록 정보 파일에 지정된 대로 인증된 사용자가 연결 서비스를 사용하거나 특정 대상에 대해 특정 Message Queue 작업을 수행할 권한이 있는가를 시스템이 확인할 것인지 여부를 표시합니다.
부울
true
imq.accesscontrol.file.
filename브로커 인스턴스가 지원하는 모든 연결 서비스에 대한 액세스 제어 등록 정보 파일의 이름입니다. 파일 이름은 액세스 제어 디렉토리에 대한 상대 파일 경로를 지정합니다(부록 A, "운영 체제별 Message Queue 데이터의 위치" 참조).
문자열
accesscontrol.
propertiesimq.audit.enabled
브로커 로그 파일에 대한 감사 로깅(엔터프라이즈판에만 적용)을 시작할지 여부를 지정하는 부울 값입니다.
부울
false
imq.authentication.
basic.user_repository(기본 64 코딩에 대해) 인증에 사용할 사용자 저장소 유형을 파일 기반(file) 또는 LDAP (ldap) 중 하나로 지정하는 문자열입니다.
문자열
file
imq.authentication.
client.response.timeout클라이언트가 브로커로부터의 인증 요청에 응답할 때까지 시스템이 대기할 시간(초)입니다.
정수
180
imq.authentication.type
비밀번호를 기본 64 코딩(basic)으로 전달할지 MD5 다이제스트(digest)로 전달할지 여부를 지정하는 문자열입니다. 브로커가 지원하는 모든 연결 서비스에 대한 인코딩을 설정합니다.
문자열
digest
imq.imqcmd.password
관리 사용자의 비밀번호입니다. imqcmd 명령 유틸리티는 작업을 수행하기 전에 이 비밀번호를 사용하여 명령 사용자를 인증합니다.
문자열
없음
imq.keystore.property_name
SSL 기반 서비스에 대해 SSL 키 저장소와 관련된 보안 등록 정보를 지정하는 문자열입니다. 표 14-9를 참조하십시오.
문자열
없음
imq.passfile.dirpath
passfile이 포함된 디렉토리의 경로입니다(운영 체제에 따라 다름).
문자열
부록 A 참조
imq.passfile.enabled
안전한 통신을 위해 사용자 비밀번호(SSL, LDAP, JDBC™)가 passfile에 설정되는지 여부를 지정하는 부울 값입니다.
부울
false
imq.passfile.name
passfile의 이름입니다.
문자열
passfile
imq.service_name.
accesscontrol.enabled명명된 연결 서비스에 대해 브로커 전체에 대한 설정을 무시하는, 액세스 제어를 설정할지 여부를 지정하는 부울 값입니다. 액세스 제어 등록 정보 파일에 지정된 대로 인증된 사용자가 명명된 연결 서비스를 사용하거나 특정 대상에 대해 특정 Message Queue 작업을 수행할 권한이 있는가를 시스템이 확인할 것인지 여부를 표시합니다.
부울
시스템 전체 등록 정보 imq.
accesscontrol.
enabled에서 상속imq.service_name.
accesscontrol.file.
filename브로커 인스턴스의 명명된 연결 서비스에 대한 액세스 제어 등록 정보 파일의 이름입니다. 파일 이름은 액세스 제어 디렉토리에 대한 상대 파일 경로를 지정합니다
(부록 A, "운영 체제별 Message Queue 데이터의 위치" 참조).기본값은 시스템 전체 등록 정보 imq.accesscontrol.file.filename에서 상속됩니다.
문자열
설명 참조
imq.service_name.
authentication.type비밀번호를 기본 64 코딩(basic)으로 전달할지 MD5 다이제스트(digest)로 전달할지 여부를 지정하는 문자열입니다. 명명된 연결 서비스의 인코딩을 설정하며, 이 값은 브로커 전체에 대한 설정을 무시합니다.
기본값은 시스템 전체 등록 정보 imq.authentication.type에서 상속됩니다.
문자열
설명 참조
imq.user_repository.
ldap.base사용자 항목에 사용되는 디렉토리 기반입니다.
문자열
없음
imq.user_repository.
ldap.gidattr그룹 이름을 값으로 가진 공급자별 속성 식별자입니다.
문자열
없음
imq.user_repository.
ldap.grpbase그룹 항목에 사용되는 디렉토리 기반입니다.
문자열
없음
imq.user_repository.
ldap.grpfiltlerJNDI 검색 필터(논리식으로 표현된 검색 쿼리)입니다. 그룹에 대해 검색 필터를 지정하면 브로커에서 검색 범위를 좁혀 효율을 높일 수 있습니다. 자세한 내용은 다음 위치의 JNDI 자습서를 참조하십시오.
http://java.sun.com/products/jndi/tutorial
이 등록 정보는 설정하지 않아도 됩니다.
문자열
없음
imq.user_repository.
ldap.grpsearch그룹 검색을 사용할지 여부를 지정하는 부울 값입니다. 사용자를 그룹에 연결할 수 있는지 확인하려면 LDAP 공급자가 제공하는 설명서를 참조하십시오.
Message Queue에서는 중첩 그룹이 지원되지 않습니다.
부울
false
imq.user_repository.
ldap.memattr그룹 구성원의 고유 이름을 값으로 가진 그룹 항목 내의 속성 식별자입니다.
문자열
없음
imq.user_repository.
ldap.password브로커에서 사용하는 고유 이름에 연결된 비밀번호입니다.
passfile에서만 이 등록 정보를 지정합니다.
디렉토리 서버가 익명 검색을 허용하는 경우에는 비밀번호가 필요 없습니다.
문자열
없음
imq.user_repository.
ldap.principal브로커가 검색할 디렉토리 서버에 바인드할 때 사용하는 고유 이름입니다. 디렉토리 서버에서 익명 검색을 허용하는 경우에는 이 등록 정보에 값을 할당할 필요가 없습니다.
문자열
없음
imq.user_repository.
ldap.property_name제공 예정
제공
예정제공 예정
imq.user_repository.
ldap.serverLDAP 서버의 host:port입니다. host는 디렉토리 서버를 실행 중인 호스트의 정규화된 DNS 이름을 지정하고 port는 디렉토리 서버에서 통신에 사용하는 포트 번호를 지정합니다.
페일오버 서버 목록을 지정하려면 다음 구문을 사용합니다.
host1:port1 ldap://host2:port2 ldap://host3:port3…
목록의 항목을 공백으로 구분합니다. 각 페일오버 서버 주소는 ldap://로 시작합니다.
SSL을 사용하고 imq.user_repository.ldap.ssl.enabled 등록 정보를 true로 설정한 경우에도 이 형식을 사용합니다. 따라서 주소에 "ldaps"를 지정할 필요가 없습니다.
문자열
없음
imq.user_repository.
ldap.ssl.enabled브로커가 LDAP 서버와 통신할 때 SSL 프로토콜을 사용해야 하는지 여부를 지정하는 부울 값입니다.
부울
false
imq.user_repository.
ldap.timeout검색 시간 제한(초)입니다.
정수
280
imq.user_repository.
ldap.uidattr사용자를 고유하게 식별하는 값을 가진 공급자별 속성 식별자입니다. uid, cn 등이 있습니다.
문자열
없음
imq.user_repository.
ldap.usrfilterJNDI 검색 필터(논리식으로 표현된 검색 쿼리)입니다. 사용자에 대해 검색 필터를 지정하면 브로커에서 검색 범위를 좁혀 효율을 높일 수 있습니다. 자세한 내용은 http://java.sun.com/products/jndi/tutorial에 있는 JNDI 자습서를 참조하십시오.
이 등록 정보는 설정하지 않아도 됩니다.
문자열
없음
Message Queue 키 저장소의 구성 가능한 등록 정보는 표 14-9에 나와 있습니다. 이러한 등록 정보는 SSL에서 사용하십시오.
표 14-9 키 저장소 등록 정보
등록 정보 이름
설명
유형
기본값
imq.keystore.file.dirpath
SSL 기반 서비스에서 키 저장소 파일이 있는 디렉토리의 경로입니다. 기본값: 부록 A, "운영 체제별 Message Queue 데이터의 위치." 참조
문자열
없음
imq.keystore.file.name
SSL 기반 서비스에서 키 저장소 파일의 이름입니다.
문자열
키 저장소
imq.keystore.password
SSL 기반 서비스에서 키 저장소 비밀번호입니다.
passfile에만 이 등록 정보를 지정하십시오.
문자열
없음
모니터링 및 로깅 등록 정보표 14-10에는 모니터링 및 로깅과 관련된 등록 정보가 나열되어 있습니다. 첫 번째 열에는 등록 정보 이름이 나와 있습니다. 각 등록 정보 이름에 대해 두 번째 열에서는 등록 정보를 설명하고 세 번째 열에서는 등록 정보의 유형을 지정하며 네 번째 열에서는 기본값을 제공합니다.
표 14-10 모니터링 서비스 등록 정보
등록 정보 이름
설명
유형
기본값
imq.destination.logDeadMsgs1
브로커가 다음과 같은 이벤트 유형을 기록하는지 여부를 지정하는 부울 값입니다.
부울
false
imq.log.console.output
콘솔에 기록하는 로깅 정보의 범주를 지정하는 문자열입니다. 값은 다음 중 하나가 될 수 있습니다.
문자열
ERROR|WARNING
imq.log.console.stream
콘솔 출력을 stdout(OUT) 또는 stderr(ERR)에 기록할 것인지를 지정하는 문자열입니다.
문자열
ERR
imq.log.file.dirpath
로그 파일이 포함된 디렉토리의 경로입니다(운영 체제에 따라 다름).
문자열
부록 A 참조
imq.log.file.filename
로그 파일의 이름입니다.
문자열
log.txt
imq.log.file.output
콘솔에 기록할 로깅 정보의 범주입니다. 값은 다음 중 하나가 될 수 있습니다.
문자열
ALL
imq.log.file.rolloverbytes1
새 로그 파일로 출력을 롤오버할 로그 파일 크기(바이트)입니다. 값이 -1이면 파일 크기를 기준으로 롤오버를 사용할 수 없습니다.
정수
-1
imq.log.file.rolloversecs1
새 로그 파일로 출력을 롤오버할 로그 파일의 보존 기간(초)입니다. 값이 -1이면 파일 보존 기간을 기준으로 롤오버를 사용할 수 없습니다.
정수
604800
(1주)imq.log.level1
로거 수준, 즉 출력 채널에 기록 가능한 출력 범주를 지정하는 문자열입니다. 지정된 범주 및 모든 상위 범주가 함께 포함됩니다. 값은 내림차순으로 ERROR, WARNING, INFO입니다.
문자열
INFO
imq.log.syslog.facility
(Solaris에만 적용) Message Queue 브로커가 어떤 syslog 기능으로 로깅할 것인지를 지정하는 문자열입니다. 값은 syslog(3C) 설명서 페이지에 있는 값을 미러링합니다. Message Queue에서 사용 가능한 값은 LOG_USER, LOG_DAEMON 그리고 LOG_LOCAL0부터 LOG_LOCAL7까지입니다.
문자열
LOG_DAEMON
imq.log.syslog.identity
(Solaris에만 적용) syslog에 기록되는 모든 메시지의 앞에 추가될 아이디 문자열입니다.
기본값은 imqbrokerd_${imq.instanceName}입니다.
문자열
설명 참조
imq.log.syslog.logconsole
(Solaris에만 적용) 메시지를 syslog에 보낼 수 없을 경우 시스템 콘솔에 메시지를 기록할 것인지 여부를 지정하는 부울 값입니다.
부울
false
imq.log.syslog.logpid
(Solaris에만 적용) 브로커 프로세스 아이디를 메시지와 함께 로깅할 것인지 여부를 지정하는 부울 값입니다(true/false).
부울
true
imq.log.syslog.output
(Solaris에만 적용) syslogd(1M)에 기록하는 로깅 정보의 범주를 지정하는 문자열입니다. 값은 다음 중 하나가 될 수 있습니다.
문자열
ERROR
imq.log.timezone
로그 타임스탬프의 표준 시간대를 표시하는 문자열입니다. 식별자는 java.util.TimeZone.getTimeZone()에 사용되는 식별자와 동일합니다. 예: GMT, , Europe/Rome, Asia/Tokyo.
문자열
지역 표준 시간대
imq.metrics.enabled
메트릭 정보를 로거에 기록할지 여부를 지정하는 부울 값입니다. 메트릭 메시지 생성에는 영향을 미치지 않습니다(imq.metrics.topic.enabled 참조).
부울
true
imq.metrics.interval
메트릭 로깅이 사용 가능한 경우(imq.metrics.enabled=true) 메트릭 정보가 로거에 기록되는 간격(초)입니다. 메트릭 메시지 생성 간격에는 영향을 미치지 않습니다(imq.metrics.topic.interval 참조).
값이 -1이면 기록하지 않습니다.
정수
-1
imq.metrics.topic.enabled
메트릭 메시지 생성을 사용할지 여부를 지정하는 부울 값입니다. false인 경우 메트릭 주제 대상에 가입하려고 하면 클라이언트측 예외가 발생합니다.
부울
true
imq.metrics.topic.interval
메트릭 메시지를 생성하여 메트릭 주제 대상에 보내는 간격(초)입니다.
정수
60
imq.metrics.topic.persist
메트릭 메시지가 지속되는지 여부를 지정하는 부울 값입니다.
부울
false
imq.metrics.topic.timetolive
메트릭 주제 대상에 보낸 메트릭 메시지의 수명(초)입니다.
정수
300
1이 등록 정보는 imqcmd update bkr과 함께 사용할 수 있습니다.
클러스터 구성 등록 정보표 14-11에서는 브로커 클러스터와 관련된 구성 등록 정보를 요약합니다.
표 14-11 클러스터 구성 등록 정보
등록 정보 이름
설명
유형
기본값
imq.cluster.brokerlist
클러스터의 모든 브로커를 식별하는 쉼표로 구분된 host:port 항목 목록이며, 여기서 host는 각 브로커의 호스트 이름, port는 포트 매퍼의 포트 번호입니다.
예:
host1:3000,host2:8000,ctrlhost
클러스터의 모든 브로커가 동일한 값을 가져야 합니다.
문자열
없음
imq.cluster.masterbroker
클러스터 마스터 브로커(있는 경우)의 호스트 이름과 포트 번호입니다.
값의 형식은 host:port입니다. 여기서 host는 마스터 브로커의 호스트 이름이고 port는 포트 매퍼의 포트 번호입니다.
예:
ctrlhost:7676
클러스터의 모든 브로커가 동일한 값을 가져야 합니다.
문자열
없음
imq.cluster.url1
클러스터 구성 파일(있는 경우)의 URL입니다.
예:
http://webserver/imq/cluster.properties
(웹 서버의 파일인 경우)
file:/net/mfsserver/imq/cluster.properties
(공유 드라이브의 파일인 경우)
클러스터의 모든 브로커가 동일한 값을 가져야 합니다.
문자열
없음
imq.cluster.hostname
사용 가능한 호스트가 두 개 이상인 경우(예: 컴퓨터에 네트워크 인터페이스 카드가 두 개 이상 있는 경우) 클러스터 연결 서비스(클러스터의 브로커 간 내부 통신에 사용됨)가 바인드될 호스트 이름 또는 IP 주소입니다.
클러스터의 각 브로커에 대해 독립적으로 지정할 수 있습니다.
문자열
imq.hostname 값에서 상속됨(표 14-2 참조)
imq.cluster.port
클러스터 연결 서비스의 포트 번호입니다.
클러스터의 각 브로커에 대해 독립적으로 지정할 수 있습니다.
정수
0(동적으로 할당됨)
imq.cluster.transport
클러스터 연결 서비스에 사용되는 네트워크 전송 프로토콜입니다. 브로커 간의 암호화된 보안 메시지를 전달하려면 이 등록 정보를 ssl로 설정합니다.
클러스터의 모든 브로커가 동일한 값을 가져야 합니다.
문자열
tcp
1이 등록 정보는 imqcmd update bkr과 함께 사용할 수 있습니다.