Sun Java 로고     이전      목차      색인      다음     

Sun 로고
Sun Java System Message Queue 3 2005Q1 관리 설명서 

14장
브로커 등록 정보 참조

이 장에서는 브로커 구성 등록 정보를 나열하고 설명합니다. 첫 번째 절에서는 전체 설명이 나오는 절에 대한 참조와 함께 모든 브로커 등록 정보를 알파벳 순으로 나열합니다. 모든 다른 절에서는 브로커 등록 정보 집합을 기능별로 그룹화하여 자세히 설명합니다.

이 장은 다음 내용으로 구성되어 있습니다.

설명 테이블에서 등록 정보는 imqcmd update bkr 명령을 사용하여 설정 가능한 경우에 표시됩니다.


알파벳 순 등록 정보 목록

표 14-1은 브로커 인스턴스 등록 정보의 알파벳 순 목록입니다. 이 목록에서 등록 정보의 범주를 확인한 다음 범주 설명을 사용하여 이 장의 다른 부분에 있는 전체 등록 정보 설명을 찾을 수 있습니다.

표의 왼쪽 열에는 각 등록 정보가 알파벳 순으로 나열됩니다. 오른쪽 열에는 등록 정보가 속하는 범주와 해당 절에 대한 상호 참조가 표시됩니다.

표 14-1 브로커 인스턴스 구성 등록 정보 

등록 정보 이름

참조

imq.accesscontrol.enabled

보안 관리자 등록 정보

imq.accesscontrol.file.filename

보안 관리자 등록 정보

imq.audit.enabled

보안 관리자 등록 정보

imq.authentication.basic.user_repository

보안 관리자 등록 정보

imq.authentication.client.response.timeout

보안 관리자 등록 정보

imq.authentication.type

보안 관리자 등록 정보

imq.autocreate.destination.isLocalOnly

자동 작성 구성 등록 정보

imq.autocreate.destination.limitBehavior

자동 작성 구성 등록 정보

imq.autocreate.destination.maxBytesPerMsg

자동 작성 구성 등록 정보

imq.autocreate.destination.maxNumMsgs

자동 작성 구성 등록 정보

imq.autocreate.destination.maxNumProducers

자동 작성 구성 등록 정보

imq.autocreate.destination.maxTotalMsgBytes

자동 작성 구성 등록 정보

imq.autocreate.destination.useDMQ

자동 작성 구성 등록 정보

imq.autocreate.queue

자동 작성 구성 등록 정보

imq.autocreate.queue.consumerFlowLimit

자동 작성 구성 등록 정보

imq.autocreate.queue.localDeliveryPreferred

자동 작성 구성 등록 정보

imq.autocreate.queue.maxNumActiveConsumers

자동 작성 구성 등록 정보

imq.autocreate.queue.maxNumBackupConsumers

자동 작성 구성 등록 정보

imq.autocreate.topic

자동 작성 구성 등록 정보

imq.autocreate.topic.consumerFlowLimit

자동 작성 구성 등록 정보

imq.cluster.property_name

클러스터 구성 등록 정보

imq.destination.DMQ.truncateBody

메시지 라우터 등록 정보

imq.destination.logDeadMsgs

모니터링 및 로깅 등록 정보

imq.hostname

연결 서비스 등록 정보

imq.httpjms.http.property_name

표 C-3

imq.httpsjms.https.property_name

표 C-3

imq.imqcmd.password

보안 관리자 등록 정보

imq.keystore.property_name

보안 관리자 등록 정보

imq.log.console.output

모니터링 서비스 등록 정보

imq.log.console.stream

모니터링 서비스 등록 정보

imq.log.file.dirpath

모니터링 서비스 등록 정보

imq.log.file.filename

모니터링 서비스 등록 정보

imq.log.file.output

모니터링 서비스 등록 정보

imq.log.file.rolloverbytes

모니터링 서비스 등록 정보

imq.log.file.rolloversecs

모니터링 서비스 등록 정보

imq.log.level

모니터링 서비스 등록 정보

imq.log.syslog.facility

모니터링 서비스 등록 정보

imq.log.syslog.identity

모니터링 서비스 등록 정보

imq.log.syslog.logconsole

모니터링 서비스 등록 정보

imq.log.syslog.logpid

모니터링 서비스 등록 정보

imq.log.syslog.output

모니터링 서비스 등록 정보

imq.log.timezone

모니터링 서비스 등록 정보

imq.message.expiration.interval

메시지 라우터 등록 정보

imq.message.max_size

메시지 라우터 등록 정보

imq.metrics.enabled

메시지 라우터 등록 정보

imq.metrics.interval

메시지 라우터 등록 정보

imq.metrics.topic.enabled

메시지 라우터 등록 정보

imq.metrics.topic.interval

메시지 라우터 등록 정보

imq.metrics.topic.persist

메시지 라우터 등록 정보

imq.metrics.topic.timetolive

모니터링 서비스 등록 정보

imq.passfile.dirpath

보안 관리자 등록 정보

imq.passfile.enabled

보안 관리자 등록 정보

imq.passfile.name

보안 관리자 등록 정보

imq.persist.file.destination.message.
filepool.limit

파일 기반 지속성 등록 정보

imq.persist.file.message.cleanup

메시지 라우터 등록 정보

imq.persist.file.message.filepool.cleanratio

메시지 라우터 등록 정보

imq.persist.file.message.max_record_size

메시지 라우터 등록 정보

imq.persist.file.sync.enabled

파일 기반 지속성 등록 정보

imq.persist.jdbc.property_name

지속성 관리자 등록 정보

imq.persist.store

메시지 라우터 등록 정보

imq.ping.interval

연결 서비스 등록 정보

imq.portmapper.backlog

연결 서비스 등록 정보

imq.portmapper.hostname

연결 서비스 등록 정보

imq.portmapper.port

연결 서비스 등록 정보

imq.resource_state.count

메시지 라우터 등록 정보

imq.resource_state.threshold

메시지 라우터 등록 정보

imq.service.activelist

연결 서비스 등록 정보

imq.service_name.accesscontrol.enabled

보안 관리자 등록 정보

imq.service_name.accesscontrol.file.filename

보안 관리자 등록 정보

imq.service_name.authentication.type

보안 관리자 등록 정보

imq.service_name.max_threads

연결 서비스 등록 정보

imq.service_name.min_threads

연결 서비스 등록 정보

imq.service_name.protocol_type.hostname

연결 서비스 등록 정보

imq.service_name.protocol_type.port

연결 서비스 등록 정보

imq.service_name.threadpool_model

연결 서비스 등록 정보

imq.shared.connectionMonitor_limit

연결 서비스 등록 정보

imq.system.max_count

메시지 라우터 등록 정보

imq.system.max_size

메시지 라우터 등록 정보

imq.transaction.autorollback

메시지 라우터 등록 정보

imq.user_repository.ldap.property_name

보안 관리자 등록 정보


연결 서비스 등록 정보

표 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.hostname

imq.portmapper.backlog

포트 매퍼가 요청 거부 전까지 처리할 수 있는 최대 동시 요청 수입니다. 이 등록 정보는 운영 체제 백로그에 저장되어 포트 매퍼의 처리를 대기할 수 있는 요청 수를 설정합니다.

정수

50

imq.service_name.
protocol_type2.port

jms, ssljms, admin 및 ssladmin 서비스에 한해 명명된 연결 서비스의 포트 번호입니다.

httpjms 및 httpsjms 연결 서비스를 구성하려면 부록 C, "HTTP/HTTPS 지원."을 참조하십시오.

정수

0

포트는 포트 매퍼에 의해 동적으로할당됩니다.

imq.service_name.
protocol_type2.hostname

jms, ssljms, admin 및 ssladmin 서비스에 한해, 사용 가능한 호스트가 두 개 이상 있는 경우(예: 컴퓨터에 네트워크 인터페이스 카드가 두 개 이상인 경우) 명명된 연결 서비스를 바인드할 호스트(호스트 이름 또는 IP 주소)입니다.

문자열

상속 위치:
imq.hostname

imq.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 명령과 함께 사용할 수 있습니다.

2protocol_type은 표 4-2에 지정되어 있습니다.


메시지 라우터 등록 정보

표 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.
autorollback

PREPARED 상태에 있는 분산 트랜잭션이 브로커 시작 시 자동으로 롤백되는지 여부를 지정하는 부울 값입니다. 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

메모리 제한 임계값에 도달할 경우에 브로커가 응답하는 방법을 지정하는 문자열입니다. 값은 다음과 같습니다.

  • FLOW_CONTROL — 생성자 수를 조금씩 줄입니다.
  • REMOVE_OLDEST — 가장 오래된 메시지를 삭제합니다.
  • REMOVE_LOW_PRIORITY — 메시지 보존 기간을 기준으로 우선 순위가 가장 낮은 메시지를 삭제합니다.
  • REJECT_NEWEST — 최신 메시지를 거부합니다. 생성자 클라이언트는 지속성 메시지가 거부되는 경우에만 예외 메시지를 받습니다. 이 제한 동작을 비지속성 메시지와 함께 사용하려면 imqAckOnProduce 연결 팩토리 속성을 설정합니다.

이 등록 정보를 REMOVE_OLDEST 또는 REMOVE_LOW_PRIORITY로 설정하고 imq.autocreate.destination.useDMQ를 true로 설정하는 경우 브로커는 초과하는 메시지를 사용 불능 메시지 대기열로 이동합니다.

문자열

REJECT
NEWEST

imq.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-7 JDBC 기반 지속성 등록 정보 

등록 정보 이름

설명

예

imq.persist.store

파일 기반 또는 JDBC 기반 데이터 저장소를 지정하는 문자열입니다.

jdbc

imq.persist.jdbc.brokerid

(선택 사항) 같은 데이터베이스를 영구 데이터 저장소로 사용하고 있는 브로커 인스턴스가 두 개 이상인 경우 데이터베이스 테이블 이름에 추가하여 고유한 이름으로 만들어 주는 브로커 인스턴스 식별자입니다.

보통 한 브로커 인스턴스에 대해서만 데이터를 저장하는 내장 데이터베이스에는 이 속성이 필요 없습니다.

식별자는 데이터베이스에 허용되는 최대 테이블 이름 길이에서 12를 뺀 길이를 넘지 않는 영문자 및 숫자 문자열이어야 합니다.

(PointBase 내장 버전에는 필요하지 않음)

imq.persist.jdbc.driver

데이터베이스에 연결할 JDBC 드라이버의 Java 클래스 이름입니다.

com.pointbase.jdbc.
   jdbcUniversalDriver

imq.persist.jdbc.opendburl

기존 데이터베이스에 대한 연결을 여는 데이터베이스 URL입니다.

jdbc:pointbase:embedded:
   dbName;database.home= …/instances/instanceName/
  dbstore

imq.persist.jdbc.createdburl

(선택 사항) 데이터베이스를 만들기 위해 연결을 여는 데이터베이스 URL입니다.

imqdbmgr을 사용하여 데이터베이스를 만드는 경우에만 이 속성을 지정합니다.

jdbc:pointbase:
   embedded
:dbName;new,
   database.home=    
/instances/instanceName/
   dbstore

imq.persist.jdbc.closedburl

(선택 사항) 브로커를 종료할 때 현재 데이터베이스 연결을 종료하는 데이터베이스 URL입니다.

PointBase에는 필요하지 않음

imq.persist.jdbc.user

(선택 사항) 필요한 경우 데이터베이스 연결을 열 때 사용되는 사용자 아이디입니다. 보안상의 이유로 명령줄 옵션을 사용해서 값을 지정할 수도 있습니다.
imqbrokerd -dbuser 및 imqdbmgr -u

 

imq.persist.jdbc.needpassword

(선택 사항) 브로커에 액세스할 때 데이터베이스에 비밀번호가 필요한지 여부를 지정하는 부울 값입니다. 값이 true이면 비밀번호가 필요합니다.

이 옵션을 설정한 경우 -passfile 옵션을 사용하여 비밀번호가 들어 있는 파일을 지정하지 않으면 imqbrokerd 및 imqdbmgr 명령에서 비밀번호를 묻는 프롬프트를 표시합니다.

 

imq.persist.jdbc.password

(선택 사항) 필요한 경우 데이터베이스 연결을 열 때 사용하는 비밀번호입니다.

passfile에만 이 등록 정보를 지정합니다.

 

imq.persist.jdbc.table.IMQSV35

버전 테이블을 만들 때 사용하는 SQL 명령입니다.

CREATE TABLE ${name}    (STOREVERSION INTEGER NOT    NULL, BROKERID    VARCHAR(100))

imq.persist.jdbc.table.
IMQCCREC35

구성 변경 레코드 테이블을 만들 때 사용하는 SQL 명령입니다.

CREATE TABLE ${name}    (RECORDTIME BIGINT NOT    NULL, RECORD BLOB(10k))

imq.persist.jdbc.table.
IMQDEST35

대상 테이블을 만들 때 사용하는 SQL 명령입니다.

CREATE TABLE ${name} (DID    VARCHAR(100) NOT NULL,    DEST BLOB(10k), primary    key(DID))

imq.persist.jdbc.table.IMQINT3

인터레스트 테이블을 만들 때 사용하는 SQL 명령입니다.

CREATE TABLE ${name} (CUID    BIGINT NOT NULL, INTEREST    BLOB(10k), primary    key(CUID))

imq.persist.jdbc.table.IMQMSG35

메시지 테이블을 만들 때 사용하는 SQL 명령입니다.

MSG 열의 기본 최대 길이는 1MB (1m)입니다. 이보다 큰 메시지가 있을 것으로 예상되면 이 길이를 알맞게 설정합니다. 이미 만든 테이블이 있는 경우 변경 사항을 적용하려면 테이블을 다시 만들어야 합니다.

CREATE TABLE ${name} (MID    VARCHAR(100) NOT NULL,    DID VARCHAR(100), MSGSIZE    BIGINT, MSG BLOB(1m),    primary key(MID))

imq.persist.jdbc.table.
IMQPROPS35

등록 정보 테이블을 만들 때 사용하는 SQL 명령입니다.

CREATE TABLE ${name}    (PROPNAME VARCHAR(100)    NOT NULL, PROPVALUE    BLOB(10k), primary    key(PROPNAME))

imq.persist.jdbc.table.
IMQILIST35

인터레스트 상태 테이블을 만들 때 사용하는 SQL 명령입니다.

CREATE TABLE ${name} (MID    VARCHAR(100) NOT NULL,    CUID BIGINT, DID    VARCHAR(100), STATE    INTEGER, primary key(MID,    CUID))

imq.persist.jdbc.table.IMQTXN35

트랜잭션 테이블을 만들 때 사용하는 SQL 명령입니다.

CREATE TABLE ${name} (TUID    BIGINT NOT NULL, STATE    INTEGER, TSTATEOBJ    BLOB(10K), primary    key(TUID))

imq.persist.jdbc.table.
IMQTACK35

트랜잭션 확인 테이블을 만들 때 사용하는 SQL 명령입니다.

CREATE TABLE ${name} (TUID    BIGINT NOT NULL, TXNACK    BLOB(10k))


보안 관리자 등록 정보

표 14-8에서는 보안 관리자 등록 정보를 나열합니다. 첫 번째 열에는 등록 정보 이름이 나와 있습니다. 각 등록 정보 이름에 대해 두 번째 열에서는 등록 정보를 설명하고 세 번째 열에서는 등록 정보의 유형을 지정하며 네 번째 열에서는 기본값을 제공합니다.

SSL을 사용하는 경우 다음과 같이 표 14-9에 나열된 키 저장소 구성 등록 정보를 참조하십시오.

표 14-8 보안 관리자 등록 정보 

등록 정보 이름

설명

유형

기본값

imq.accesscontrol.file.
enabled

브로커가 지원하는 모든 연결 서비스에 대해 액세스 제어를 설정할지 여부를 지정하는 부울 값입니다. 액세스 제어 등록 정보 파일에 지정된 대로 인증된 사용자가 연결 서비스를 사용하거나 특정 대상에 대해 특정 Message Queue 작업을 수행할 권한이 있는가를 시스템이 확인할 것인지 여부를 표시합니다.

부울

true

imq.accesscontrol.file.
filename

브로커 인스턴스가 지원하는 모든 연결 서비스에 대한 액세스 제어 등록 정보 파일의 이름입니다. 파일 이름은 액세스 제어 디렉토리에 대한 상대 파일 경로를 지정합니다(부록 A, "운영 체제별 Message Queue 데이터의 위치" 참조).

문자열

accesscontrol.
properties

imq.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.grpfiltler

JNDI 검색 필터(논리식으로 표현된 검색 쿼리)입니다. 그룹에 대해 검색 필터를 지정하면 브로커에서 검색 범위를 좁혀 효율을 높일 수 있습니다. 자세한 내용은 다음 위치의 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.server

LDAP 서버의 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.usrfilter

JNDI 검색 필터(논리식으로 표현된 검색 쿼리)입니다. 사용자에 대해 검색 필터를 지정하면 브로커에서 검색 범위를 좁혀 효율을 높일 수 있습니다. 자세한 내용은 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

콘솔에 기록하는 로깅 정보의 범주를 지정하는 문자열입니다. 값은 다음 중 하나가 될 수 있습니다.

  • ALL
  • NONE
  • ERROR, WARNING, INFO 값 중 하나 이상이며 세로 막대(|)로 구분합니다. 로그 메시지의 각 범주를 개별적으로 지정합니다. 메시지 범주에는 다른 범주가 포함되지 않습니다.

문자열

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
  • NONE
  • ERROR, WARNING, INFO 값 중 하나 이상이며 세로 막대(|)로 구분합니다. 로그 메시지의 각 범주를 개별적으로 지정합니다. 메시지 범주에는 다른 범주가 포함되지 않습니다.

문자열

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)에 기록하는 로깅 정보의 범주를 지정하는 문자열입니다. 값은 다음 중 하나가 될 수 있습니다.

  • ALL
  • NONE
  • ERROR, WARNING, INFO 값 중 하나 이상이며 세로 막대(|)로 구분합니다. 로그 메시지의 각 범주를 개별적으로 지정합니다. 메시지 범주에는 다른 범주가 포함되지 않습니다.

문자열

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과 함께 사용할 수 있습니다.



이전      목차      색인      다음     


부품 번호: 819-2218.   Copyright 2005 Sun Microsystems, Inc. 모든 권리는 저작권자의 소유입니다.