test

Sun Java System Message Queue 3.7 UR1 관리 설명서

14장 브로커 등록 정보 참조

이 장에서는 메시지 브로커의 구성 등록 정보에 대한 참조 정보를 제공합니다. 이 장은 다음 내용으로 구성되어 있습니다.

연결 등록 정보

표 14–1은 연결 서비스 관련 브로커 등록 정보를 나열합니다.

표 14–1 브로커 연결 등록 정보

등록 정보 

유형 

기본값 

설명 

imq.service.activelist

문자열 

jms,admin

브로커가 시작될 때 활성화될 쉼표로 구분된 연결 서비스 목록

imq.hostname

문자열 

사용 가능한 모든 IP 주소 

모든 연결 서비스의 기본 호스트 이름 또는 IP 주소

imq.portmapper.hostname

문자열 

없음 

포트 매퍼의 호스트 이름 또는 IP 주소

이 등록 정보를 지정한 경우 imq.hostname을 무시합니다.

imq.portmapper.port [imqcmd update bkr 명령과 함께 사용할 수 있습니다.]

정수 

7676

포트 매퍼의 포트 번호 

주 –

여러 브로커 인스턴스가 동일한 호스트에서 실행 중이면 각 호스트마다 고유한 포트 매퍼 포트가 할당되어야 합니다.

imq.serviceName .protocolType.hostname [jms, ssljms, admin 및 ssladmin 서비스에만 해당됩니다. httpjms 및 httpsjms 서비스 구성에 대한 자세한 내용은 부록 C, HTTP/HTTPS 지원을 참조하십시오.]

문자열 

없음 

연결 서비스의 호스트 이름 또는 IP 주소

지정할 경우, 지정된 연결 서비스의 imq.hostname을 무시합니다.

imq.serviceName .protocolType.port

정수 

0

연결 서비스의 포트 번호 

값 0은 포트 번호를 포트 매퍼에서 동적으로 할당하도록 지정합니다.

imq.portmapper.backlog

정수 

50

운영 체제 백로그에서 보류 중인 최대 포트 매퍼 요청 수 

imq.serviceName .threadpool_model [jms 및 admin 서비스에만 해당]

문자열 

dedicated

스레드 풀 관리를 위한 스레딩 모델:  

    dedicated: 연결당 2개의 전용 스레드(받는 메시지와 보내는 메시지에 대해 각각 하나씩)


    shared: 메시지를 보내거나 받을 때 공유 스레드에서 처리되는 연결
     

전용 모델은 지원할 수 있는 연결 수를 제한하지만 보다 뛰어난 성능을 제공합니다. 공유 모델은 사용 가능한 연결 수를 늘리지만 스레드 관리에 필요한 추가 오버헤드로 인해 성능이 다소 저하됩니다.  

imq.serviceName .min_threads

정수 

jms: 10ssljms : 10httpjms: 10 httpsjms: 10 admin: 4ssladmin: 4

연결 서비스의 스레드 풀에서 관리되는 최소 스레드 수 

사용 가능한 스레드 수가 이 임계값을 초과하면 최소 수에 도달할 때까지 스레드를 종료시켜 여유 스레드를 확보합니다.  

기본값은 표시된 대로 연결 서비스에 따라 다릅니다.  

imq.serviceName .max_threads

정수 

jms: 1000 ssljms: 500httpjms: 500httpsjms: 500 admin: 10ssladmin: 10

이 스레드 수를 초과하면 스레드 풀에 명명된 연결 서비스용으로 새 스레드가 더 이상 추가되지 않는 스레드 수 

0보다 크고 imq.serviceName.min_threads 값보다 커야 합니다.

기본값은 표시된 대로 연결 서비스에 따라 다릅니다.  

imq.shared.connectionMonitor_limit [공유 스레딩 모델에만 해당]

정수 

Solaris: 512Linux: 512Windows: 64

분산자 스레드에서 모니터링되는 최대 연결 수 

시스템에서 모든 연결을 모니터하기에 충분한 수의 분산자 스레드를 할당합니다. 이 등록 정보 값이 작을수록 스레드를 활성 연결에 더 빨리 할당할 수 있습니다. 값 -1은 스레드당 무제한 연결 수를 의미합니다.

기본값은 표시된 대로 운영 체제 플랫폼에 따라 다릅니다.  

imq.ping.interval

정수 

120

클라이언트와 브로커 간 연결을 테스트하는 간격(초) 

값 0 또는 -1을 설정하면 연결 테스트를 주기적으로 실행할 수 없습니다.

라우팅 등록 정보

표 14–2은 라우팅 서비스 관련 브로커 등록 정보를 나열합니다. 표 14–3에는 대상 자동 생성을 구성하는 등록 정보가 나열되어 있습니다.

표 14–2 브로커 라우팅 등록 정보

등록 정보 

유형 

기본값 

설명 

imq.system.max_count [imqcmd update bkr 명령과 함께 사용할 수 있습니다.]

정수 

-1

브로커에서 보유하는 최대 메시지 수 

값 -1은 무제한 메시지 수를 의미합니다.

imq.system.max_size

문자열 

-1

브로커에서 보유하는 메시지의 최대 총 크기 

값은 다음 접미사를 사용하여 바이트, 킬로바이트 또는 메가바이트 단위로 표현할 수 있습니다.  

    b: 바이트


    k: 킬로바이트(1024바이트)


    m: 메가바이트(1024 × 1024 = 1,048,576바이트)
     

접미사가 붙지 않은 값은 바이트로 표현됩니다. 값 -1은 무제한 메시지 용량을 의미합니다.

     

예:

    1600: 1600바이트


    1600b: 1600바이트


    16k: 16킬로바이트(= 16,384바이트)


    16m: 16메가바이트(= 16,777,216바이트)


    -1: 제한 없음

imq.message.max_size

문자열 

70m

단일 메시지 본문의 최대 크기 

구문은 imq.system.max_size의 구문과 같습니다(위 항목 참조).

imq.message.expiration.interval

정수 

60

만료된 메시지가 확보되는 간격(초) 

imq.resourceState .threshold

정수 

green: 0 yellow: 80orange: 90red: 98

메모리 자원 상태가 트리거되는 사용률(여기서 resourceState는 green, yellow, orange 또는 red)

imq.resourceState .count

정수 

green: 5000 yellow: 500orange: 50red: 0

메모리 자원 상태 임계값에 도달했는지 여부를 확인하기 전에 일괄 처리에서 허용되는 최대 받는 메시지 수(여기서 resourceState는 green, yellow, orange 또는 red)

이 제한은 시스템 메모리가 점점 부족해지면 메시지 생성자를 억제합니다.  

imq.destination.DMQ.truncateBody

부울 

false

사용 불능 메시지 대기열에 저장하기 전에 메시지 본문을 제거하시겠습니까?  

true이면 메시지 헤더와 등록 정보 데이터가 저장됩니다.

imq.transaction.autorollback

부울 

false

브로커 시작 시 준비된 상태로 있는 분산된 트랜잭션을 자동으로 롤백하시겠습니까?  

false이면 트랜잭션을 수동으로 완결하거나 명령 유틸리티(imqcmd)를 사용하여 롤백해야 합니다.

표 14–3 자동 생성된 대상에 대한 브로커 등록 정보

등록 정보 

유형 

기본값 

설명 

imq.autocreate.queue [imqcmd update bkr 명령과 함께 사용할 수 있습니다.] , [대기열 대상에만 해당]

부울 

true

대기열 대상을 자동으로 생성하시겠습니까?  

imq.autocreate.topic [주제 대상에만 해당]

부울 

true

주제 대상을 자동으로 생성하시겠습니까? 

imq.autocreate.destination.maxNumMsgs

정수 

100000

사용되지 않은 메시지의 최대 개수 

값 -1은 무제한 메시지 수를 의미합니다.

imq.autocreate.destination.maxBytesPerMsg

문자열 

10k

단일 메시지의 최대 크기(바이트) 

값은 다음 접미사를 사용하여 바이트, 킬로바이트 또는 메가바이트 단위로 표현할 수 있습니다.  

    b: 바이트


    k: 킬로바이트(1024바이트)


    m: 메가바이트(1024 × 1024 = 1,048,576바이트)
     

접미사가 붙지 않은 값은 바이트로 표현됩니다. 값 -1은 무제한 메시지 크기를 의미합니다.

     

예:

    1600: 1600바이트


    1600b: 1600바이트


    16k: 16킬로바이트(= 16,384바이트)


    16m: 16메가바이트(= 16,777,216바이트)


    -1: 제한 없음

imq.autocreate.destination.maxTotalMsgBytes

문자열 

10m

사용되지 않은 메시지의 최대 총 메모리(바이트)

구문은 imq.autocreate.destination.maxBytesPerMsg의 구문과 같습니다(위 항목 참조).

imq.autocreate.destination.limitBehavior

문자열 

REJECT_NEWEST

메모리 제한 임계값에 도달했을 때 브로커 동작:  

    FLOW_CONTROL: 생성자 속도 늦추기


    REMOVE_OLDEST: 가장 오래된 메시지 제거


    REMOVE_LOW_PRIORITY: 메시지의 보존 기간을 기준으로 우선 순위가 가장 낮은 메시지 삭제(생성자 클라이언트에 알리지 않음)


    REJECT_NEWEST: 최근 메시지 거부(지속성 메시지의 경우에만 생성자 클라이언트에 예외 알림)
     

값이 REMOVE_OLDEST 또는 REMOVE_LOW_PRIORITY이고 imq.autocreate.destination.useDMQ 등록 정보가 true이면 초과 메시지가 사용 불능 메시지 대기열로 이동됩니다.

imq.autocreate.destination.maxNumProducers

정수 

100

대상에 대한 최대 메시지 생성자 수

이 제한에 도달하면 새로운 생성자가 생성되지 않습니다. 값 -1은 무제한 생성자 수를 의미합니다.

imq.autocreate.queue.maxNumActiveConsumers

정수 

1

대기열 대상에서 로드 균형 조정 전달 시 최대 활성 메시지 사용자 수

값 -1은 무제한 사용자 수를 의미합니다.

imq.autocreate.queue.maxNumBackupConsumers

정수 

0

대기열 대상에서 로드 균형 조정 전달 시 최대 백업 메시지 사용자 수

값 -1은 무제한 사용자 수를 의미합니다.

imq.autocreate.queue.consumerFlowLimit

정수 

1000

단일 일괄 처리에서 대기열 사용자에게 전달되는 최대 메시지 수

로드 균형 조정된 대기열 전달에서 이 수는 로드 균형 조정을 시작하기 전에 활성 사용자에게 라우팅되는 초기 대기 메시지 수입니다. 대상 사용자는 연결에 대해 낮은 값을 지정하여 이 제한을 무시할 수 있습니다.  

값 -1은 무제한 메시지 수를 의미합니다.

imq.autocreate.topic.consumerFlowLimit

정수 

1000

단일 일괄 처리에서 주제 사용자에게 전달되는 최대 메시지 수

값 -1은 무제한 사용자 수를 의미합니다.

imq.autocreate.destination.isLocalOnly

부울 

false

로컬 전달만 하시겠습니까?  

이 등록 정보는 브로커 클러스터의 대상에만 적용되며 대상을 만들고 나면 변경할 수 없습니다. 이 값이 true이면 대상을 다른 브로커에 복사하지 않으므로 메시지 전달이 로컬 사용자(대상이 생성된 브로커에 연결된 사용자)에게만 제한됩니다.

imq.autocreate.queue.localDeliveryPreferred

부울 

false

로컬 전달을 선호합니까?  

이 등록 정보는 브로커 클러스터의 로드 균형 조정된 대기열 전달에만 적용됩니다. 이 값이 true이면 로컬 브로커에 사용자가 없는 경우에만 메시지가 원격 사용자에게 전달됩니다. 대상이 로컬 전용 전달로 제한되지 않아야 합니다(imq.autocreate.destination.isLocalOnly가 false여야 함).

imq.autocreate.destination.useDMQ

부울 

true

사용 불능 메시지를 사용 불능 메시지 대기열로 보내겠습니까?  

false이면 사용 불능 메시지가 삭제됩니다.

지속성 등록 정보

Message QueueTM는 영구 데이터 저장소의 파일 기반 및 JDBC 기반 모델을 모두 지원합니다. 브로커 등록 정보 imq.persist.store(표 14–4)는 사용할 모델을 지정합니다. 다음 절에서는 두 모델의 브로커 구성 등록 정보에 대해 설명합니다.

표 14–4 전역 브로커 지속성 등록 정보

등록 정보 

유형 

기본값 

설명 

imq.persist.store

문자열 

file

영구 데이터 저장소 모델:  

    file: 파일 기반 지속성


    jdbc: JDBC 기반 지속성

파일 기반 지속성

표 14–5는 파일 기반 지속성 관련 브로커 등록 정보를 나열합니다.

표 14–5 파일 기반 지속성에 대한 브로커 등록 정보

등록 정보 

유형 

기본값 

설명 

imq.persist.file.message.max_record_size

문자열 

1m

메시지 저장소 파일에 추가할 최대 크기 메시지 

이 크기를 초과하는 모든 메시지는 고유의 개별 파일에 저장됩니다.  

값은 다음 접미사를 사용하여 바이트, 킬로바이트 또는 메가바이트 단위로 표현할 수 있습니다.  

    b: 바이트


    k: 킬로바이트(1024바이트)


    m: 메가바이트(1024 × 1024 = 1,048,576바이트)


접미사가 붙지 않는 값은 바이트로 표현됩니다.  

예:

    1600: 1600바이트


    1600b: 1600바이트


    16k: 16킬로바이트(= 16,384바이트)


    16m: 16메가바이트(= 16,777,216바이트)

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

정수 

100

대상 파일 풀에서 재사용할 수 있는 최대 사용 가능 파일 수 

이 제한을 초과하는 사용 가능 파일은 삭제됩니다. 이 제한을 초과할 경우 브로커는 필요에 따라 추가 파일을 작성하고 삭제합니다.  

이 제한이 클수록 브로커에서 영구 데이터를 더 빠르게 처리할 수 있습니다.  

imq.persist.file.message.filepool.cleanratio

정수 

0

빈 상태로 유지 관리할 사용 가능 파일 풀의 파일 비율 

이 값이 클수록 작업 중 파일을 지우는 데 필요한 오버헤드가 늘어나지만, 파일 풀에 필요한 디스크 공간은 줄어듭니다.  

imq.persist.file.message.cleanup

부울 

false

종료 시 사용 가능 파일 풀의 파일을 지우겠습니까?  

이 등록 정보를 true로 설정하면 파일 저장소에 필요한 디스크 공간을 절약할 수 있지만 브로커 종료가 느려집니다.

imq.persist.file.sync.enabled

부울 

false

메모리 상태를 물리적 저장소 장치와 동기화하시겠습니까? 

이 등록 정보를 true로 설정하면 시스템 충돌로 인한 데이터 손실이 없어지지만 성능이 저하됩니다.

주 –

Sun Cluster 및 Sun Cluster Data Service for Message Queue를 실행하는 경우 모든 클러스터 노드의 브로커에 대해 이 등록 정보를 true로 설정합니다.

JDBC 기반 지속성

표 14–6은 JDBC 기반 지속성 관련 브로커 등록 정보를 나열합니다. 다음은 DataMirror Mobile Solutions, Inc.의 데이터베이스 제품 중 PointBase® 제품군에 대한 예입니다.

표 14–6 JDBC 기반 지속성에 대한 브로커 등록 정보

등록 정보 

예 

설명 

imq.persist.jdbc.brokerid

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

(선택 사항) 브로커 인스턴스 식별자

n - 12자 이하의 영숫자 문자열이어야 합니다. 여기서 n은 데이터베이스에서 허용되는 최대 테이블 이름 길이입니다.

두 개 이상의 브로커 인스턴스가 영구 데이터 저장소로 같은 데이터베이스를 사용 중인 경우에는 데이터베이스 테이블 이름에 이 식별자가 추가되어 해당 이름을 고유하게 나타냅니다. 보통 한 브로커 인스턴스에 대해서만 데이터를 저장하는 내장 데이터베이스에는 이 식별자가 필요하지 않습니다.  

imq.persist.jdbc.driver

com.pointbase.jdbc.jdbcUniversalDriver

데이터베이스에 연결하기 위한 JDBC 드라이버의 Java 클래스 이름

imq.persist.jdbc.opendburl

jdbc:pointbase:embedded:dbName ; 

    database.home=

       .../instances/instanceName/dbstore

기존 데이터베이스로의 연결을 여는 데 필요한 URL

imq.persist.jdbc.createdburl

jdbc:pointbase:embedded:dbName ; 

    new,database.home=

       .../instances/instanceName/dbstore

(선택 사항) 새 데이터베이스를 작성하는 데 필요한 URL

Message Queue 데이터베이스 관리자 유틸리티(imqdbmgr)를 사용하여 데이터베이스를 만드는 경우에만 필요합니다.

imq.persist.jdbc.closedburl

PointBase에는 필요하지 않음 

(선택 사항) 데이터베이스 연결을 닫는 데 필요한 URL

imq.persist.jdbc.user

 

(선택 사항) 필요할 경우 데이터베이스 연결을 여는 데 필요한 사용자 이름

보안상의 이유로 imqbrokerd -dbuser 및 imqdbmgr - u 명령줄 옵션을 사용해서 값을 지정할 수도 있습니다.

imq.persist.jdbc.needpassword

 

(선택 사항) 브로커에서 데이터베이스에 액세스하려면 비밀번호가 필요합니까?

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

imq.persist.jdbc.password [비밀번호 파일에만 사용해야 합니다.]

 

(선택 사항) 데이터베이스 연결을 여는 데 필요한 비밀번호

imq.persist.jdbc.table.IMQSV35

CREATE TABLE ${name} 

    (STOREVERSION INTEGER NOT NULL,

     BROKERID VARCHAR(100))

버전 테이블을 작성하는 SQL 명령

imq.persist.jdbc.table.IMQCCREC35

CREATE TABLE ${name} 

    (RECORDTIME BIGINT NOT NULL,

     RECORD BLOB(10k))

구성 변경 레코드 테이블을 작성하는 SQL 명령

imq.persist.jdbc.table.IMQDEST35

CREATE TABLE ${name} 

    (DID VARCHAR(100) NOT NULL,

     DEST BLOB(10k),

     primaryKey(DID))

대상 테이블을 작성하는 SQL 명령

imq.persist.jdbc.table.IMQINT35

CREATE TABLE ${name} 

    (CUID BIGINT NOT NULL,

     INTEREST BLOB(10k),

     primaryKey(CUID))

인터레스트 테이블을 작성하는 SQL 명령

imq.persist.jdbc.table.IMQMSG35

CREATE TABLE ${name} 

    (MID VARCHAR(100) NOT NULL,

     DID VARCHAR(100),

     MSGSIZE BIGINT,

     MSG BLOB(1m),

     primaryKey(MID))

메시지 테이블을 작성하는 SQL 명령

MSG 열의 기본 최대 길이는 1메가바이트(1m)입니다. 이보다 더 긴 메시지가 있을 것으로 예상되면 길이를 해당 크기에 맞게 설정합니다. 테이블이 이미 작성된 경우에는 해당 테이블을 다시 작성하여 최대 메시지 길이를 변경해야 합니다.

imq.persist.jdbc.table.IMQPROPS35

CREATE TABLE ${name} 

    (PROPNAME VARCHAR(100) NOT NULL,

     PROPVALUE BLOB(10k),

     primaryKey(PROPNAME))

등록 정보 테이블을 작성하는 SQL 명령

imq.persist.jdbc.table.IMQILIST35

CREATE TABLE ${name} 

    (MID VARCHAR(100) NOT NULL,

     CUID BIGINT,

     DID VARCHAR(100),

     STATE INTEGER,

     primaryKey(MID, CUID))

인터레스트 상태 테이블을 작성하는 SQL 명령

imq.persist.jdbc.table.IMQTXN35

CREATE TABLE ${name} 

    (TUID BIGINT NOT NULL,

     STATE INTEGER,

     TSTATEOBJ BLOB(10K),

     primaryKey(TUID))

트랜잭션 테이블을 작성하는 SQL 명령

imq.persist.jdbc.table.IMQTACK35

CREATE TABLE ${name} 

    (TUID BIGINT NOT NULL,

     TXNACK BLOB(10k))

트랜잭션 확인 테이블을 작성하는 SQL 명령

보안 등록 정보

표 14–7은 보안 서비스 관련 브로커 등록 정보를 나열합니다.

표 14–7 브로커 보안 등록 정보

등록 정보 

유형 

기본값 

설명 

imq.accesscontrol.enabled

부울 

true

액세스 제어를 사용합니까?

true이면 시스템에서 액세스 제어 등록 정보 파일을 확인하여 인증된 사용자에게 연결 서비스를 사용하거나 특정 대상과 관련된 특정 작업을 수행할 수 있는 권한이 부여되었는지 확인합니다.

imq.serviceName.accesscontrol.enabled

부울 

없음 

연결 서비스에 대해 액세스 제어를 사용합니까?  

이 등록 정보를 지정할 경우 지정된 연결 서비스의 imq.accesscontrol.enabled를 무시합니다.

true이면 시스템에서 액세스 제어 등록 정보 파일을 확인하여 인증된 사용자에게 지정된 연결 서비스를 사용하거나 특정 대상과 관련된 특정 작업을 수행할 수 있는 권한이 부여되었는지 확인합니다.

imq.accesscontrol.file.filename

문자열 

accesscontrol.properties

액세스 제어 등록 정보 파일 이름 

파일 이름은 액세스 제어 디렉토리의 상대 경로를 지정합니다(부록 A, 플랫폼별 Message QueueTM 데이터 위치 참조).

imq.serviceName .accesscontrol.file.filename

문자열 

없음 

연결 서비스의 액세스 제어 등록 정보 파일 이름 

이 등록 정보를 지정할 경우 지정된 연결 서비스의 imq.accesscontrol.file.filename을 무시합니다.

파일 이름은 액세스 제어 디렉토리의 상대 경로를 지정합니다(부록 A, 플랫폼별 Message QueueTM 데이터 위치 참조).

imq.authentication.type

문자열 

digest

비밀번호 인코딩 방법:

    basic: 기본 64


    digest: MD5

imq.serviceName .authentication.type

문자열 

없음 

연결 서비스에 대한 비밀번호 인코딩 방법:

    basic: 기본 64


    digest: MD5


이 등록 정보를 지정한 경우 지정된 연결 서비스에 대해 imq.authentication.type을 무시합니다.

imq.authentication.basic.user_repository

문자열 

file

기본 64 인증에 대한 사용자 저장소 유형:  

    file: 파일 기반


    ldap: LDAP

imq.authentication.client.response.timeout

정수 

180

인증 요청에 대한 클라이언트 응답 대기 시간 간격(초) 

imq.passfile.enabled

부울 

false

비밀번호 파일에서 비밀번호를 가져옵니까?  

imq.passfile.dirpath

문자열 

부록 A, 플랫폼별 Message QueueTM 데이터 위치 참조

비밀번호 파일을 포함하는 디렉토리 경로 

imq.passfile.name

문자열 

passfile

비밀번호 파일 이름

imq.imqcmd.password

문자열 

없음 

관리자의 비밀번호 

명령 유틸리티(imqcmd)에서는 이 비밀번호를 사용하여 명령을 실행하기 전에 사용자를 인증합니다.

imq.user_repository.ldap.server

문자열 

없음 

LDAP 서버의 호스트 이름 및 포트 번호

값은 다음 형태로 구성됩니다.  

    hostName: port


여기서 hostName은 LDAP 서버를 실행하는 호스트의 정규화된 DNS 이름이고 port는 서버에서 사용하는 포트 번호입니다.

     

페일오버 서버 목록을 지정하려면 다음 구문을 사용합니다.  

    host1: port1


    ldap://host2 : port2


    ldap://host3 :port3


    …
     

목록의 항목을 공백으로 구분합니다. 각 페일오버 서버 주소의 접두어는 ldap://입니다. SSL을 사용하고 imq.user_repository.ldap.ssl.enabled 등록 정보를 true로 설정한 경우에도 이 형식을 사용합니다. 주소에 ldaps를 지정할 필요는 없습니다.

imq.user_repository.ldap.principal

문자열 

없음 

LDAP 사용자 저장소에 바인드할 때 사용하는 고유 이름

LDAP 서버에서 익명 검색을 허용하는 경우에는 필요하지 않습니다.

imq.user_repository.ldap.password [비밀번호 파일에만 사용해야 합니다.]

문자열 

없음 

LDAP 사용자 저장소에 바인드할 때 사용하는 비밀번호

LDAP 서버에서 익명 검색을 허용하는 경우에는 필요하지 않습니다.

imq.user_repository.ldap.propertyName

제공 예정 

제공 예정 

제공 예정 

imq.user_repository.ldap.base

문자열 

없음 

LDAP 사용자 항목에 사용되는 디렉토리 기반

imq.user_repository.ldap.uidattr

문자열 

없음 

LDAP 사용자 이름에 대한 공급자별 속성 식별자

imq.user_repository.ldap.usrfilter

문자열 

없음 

(선택 사항) LDAP 사용자 검색에 사용할 JNDI 필터

imq.user_repository.ldap.grpsearch

부울 

false

LDAP 그룹 검색을 사용하시겠습니까?

주 –

Message Queue에서는 중첩 그룹을 지원하지 않습니다.

imq.user_repository.ldap.grpbase

문자열 

없음 

LDAP 그룹 항목에 사용되는 디렉토리 기반

imq.user_repository.ldap.gidattr

문자열 

없음 

LDAP 그룹 이름에 대한 공급자별 속성 식별자

imq.user_repository.ldap.memattr

문자열 

없음 

LDAP 그룹의 사용자 이름에 대한 공급자별 속성 식별자

imq.user_repository.ldap.grpfilter

문자열 

없음 

(선택 사항) LDAP 그룹 검색에 사용할 JNDI 필터

imq.user_repository.ldap.timeout

정수 

280

LDAP 검색 시간 제한(초)

imq.user_repository.ldap.ssl.enabled

부울 

false

LDAP 서버와 통신할 때 SSL을 사용합니까?

imq.keystore.file.dirpath

문자열 

부록 A, 플랫폼별 Message QueueTM 데이터 위치 참조

키 저장소 파일을 포함하는 디렉토리 경로 

imq.keystore.file.name

문자열 

keystore

키 저장소 파일의 이름 

imq.keystore.password

문자열 

없음 

키 저장소 파일의 비밀번호 

imq.audit.enabled [Message Queue 엔터프라이즈판에만 적용]

부울 

false

브로커 로그 파일에 대한 감사 로깅을 시작하시겠습니까?  

모니터링 등록 정보

표 14–8은 모니터링 서비스 관련 브로커 등록 정보를 나열합니다.

표 14–8 브로커 모니터링 등록 정보

등록 정보 

유형 

기본값 

설명 

imq.log.level [imqcmd update bkr 명령과 함께 사용할 수 있습니다.]

문자열 

INFO

로깅 수준 

출력 채널에 기록할 수 있는 로깅 정보 범주를 지정합니다. 가능한 값은 내림차순으로 다음과 같습니다.  

    ERROR


    WARNING


    INFO


각 수준에는 상위 수준이 포함됩니다(예: WARNING에는 ERROR가 포함됨).

imq.destination.logDeadMsgs

부울 

false

사용 불능 메시지에 대한 정보를 기록하시겠습니까?  

true이면 다음 이벤트가 기록됩니다.

  • 대상이 최대 크기 또는 최대 메시지 수에 도달하여 꽉 찼습니다.

  • 브로커가 관리 명령 또는 전달 확인 이외의 메시지를 제거합니다.

  • 브로커가 메시지를 사용 불능 메시지 대기열로 이동합니다.

imq.log.console.stream

문자열 

ERR

콘솔 출력 대상:  

    OUT: stdout


    ERR: stderr


imq.log.console.output

문자열 

ERROR|WARNING

콘솔에 기록할 로깅 정보 범주:  

    NONE


    ERROR


    WARNING


    INFO


    ALL


ERROR, WARNING 및 INFO 범주는 상위 범주를 포함하지 않습니다. 따라서 필요에 따라 각각의 범주를 명시적으로 지정해야 합니다. 여러 범주를 조합하여 지정할 수 있으며, 이 때 각 범주는 세로 막대(|)로 구분합니다.

imq.log.file.dirpath

문자열 

부록 A, 플랫폼별 Message QueueTM 데이터 위치 참조

로그 파일을 포함하는 디렉토리 경로 

imq.log.file.filename

문자열 

log.txt

로그 파일의 이름 

imq.log.file.output

문자열 

ALL

로그 파일에 기록할 로깅 정보의 범주:  

    NONE


    ERROR


    WARNING


    INFO


    ALL


ERROR, WARNING 및 INFO 범주는 상위 범주를 포함하지 않습니다. 따라서 필요에 따라 각각의 범주를 명시적으로 지정해야 합니다. 여러 범주를 조합하여 지정할 수 있으며, 이 때 각 범주는 세로 막대(|)로 구분합니다.

imq.log.file.rolloverbytes

정수 

-1

새 로그 파일로 출력을 롤오버할 때 파일 길이(바이트) 

값 -1은 무제한 바이트 수(롤오버 시 파일 길이와 상관 없음)를 의미합니다.

imq.log.file.rolloversecs

정수 

604800(1주)

새 로그 파일로 출력을 롤오버할 때 파일의 표시 시간(초) 

값 -1은 무제한(롤오버 시 파일 표시 시간과 상관 없음)을 의미합니다.

imq.log.syslog.output [Solaris 플랫폼에만 해당]

문자열 

ERROR

syslogd(1M)에 기록할 로깅 정보 범주:

    NONE


    ERROR


    WARNING


    INFO


    ALL


ERROR, WARNING 및 INFO 범주는 상위 범주를 포함하지 않습니다. 따라서 필요에 따라 각각의 범주를 명시적으로 지정해야 합니다. 여러 범주를 조합하여 지정할 수 있으며, 이 때 각 범주는 세로 막대(|)로 구분합니다.

imq.log.syslog.facility

문자열 

LOG_DAEMON

메시지 로깅을 위한 syslog 기능

가능한 값은 syslog(3C) 설명서 페이지에 나열된 값을 미러링합니다. Message Queue에서 사용 가능한 값은 다음과 같습니다.

    LOG_USER


    LOG_DAEMON


    LOG_LOCAL0


    LOG_LOCAL1


    LOG_LOCAL2


    LOG_LOCAL3


    LOG_LOCAL4


    LOG_LOCAL5


    LOG_LOCAL6


    LOG_LOCAL7


imq.log.syslog.identity

문자열 

imqbrokerd_${imq.instanceName }

syslog에 기록될 모든 메시지에 접두사로 사용할 아이디 문자열

imq.log.syslog.logpid

부울 

true

메시지와 함께 브로커 프로세스 아이디를 기록하시겠습니까?  

imq.log.syslog.logconsole

부울 

false

메시지를 syslog로 전송할 수 없는 경우 시스템 콘솔에 기록하시겠습니까?

imq.log.timezone

문자열 

지역 표준 시간대 

로그 타임스탬프의 표준 시간대 

가능한 값은 java.util.TimeZone.getTimeZone 메소드에서 사용되는 것과 동일한 값입니다.

예:

    GMT


    GMT-8:00


    America/LosAngeles


    Europe/Rome


    Asia/Tokyo


imq.metrics.enabled

부울 

true

로거에 메트릭 정보를 기록하시겠습니까?

메트릭 메시지 생성( imq.metrics.topic.enabled를 통해 제어됨)에는 영향을 미치지 않습니다.

imq.metrics.interval

정수 

-1

메트릭 정보를 로거에 기록하는 시간 간격(초) 

메트릭 메시지 생성 간격( imq.metrics.topic.interval를 통해 제어됨)에는 영향을 미치지 않습니다.

값 -1은 무기한 간격(메트릭 정보를 로거에 기록하지 않음)을 의미합니다.

imq.metrics.topic.enabled

부울 

true

메트릭 메시지를 메트릭 주제 대상에 생성하시겠습니까?  

false인 경우 메트릭 주제 대상에 가입하려고 하면 클라이언트측 예외가 발생합니다.

imq.metrics.topic.interval

정수 

60

메트릭 메시지를 메트릭 주제 대상에 생성하는 시간 간격(초) 

imq.metrics.topic.persist

부울 

false

메트릭 주제 대상으로 보낸 메트릭 메시지가 지속적입니까?  

imq.metrics.topic.timetolive

정수 

300

메트릭 주제 대상으로 보낸 메트릭 메시지의 수명(초) 

클러스터 구성 등록 정보

표 14–9는 브로커 클러스터 관련 구성 등록 정보를 나열합니다.

표 14–9 클러스터 구성에 대한 브로커 등록 정보

등록 정보 

유형 

기본값 

설명 

imq.cluster.brokerlist [클러스터의 모든 브로커 값이 동일해야 합니다.]

문자열 

없음 

브로커 주소 목록 

이 목록은 쉼표로 구분된 하나 이상의 주소로 구성됩니다. 각 주소는 hostName: portNumber의 형태로 클러스터 내 브로커의 호스트 이름과 포트 매퍼 포트 번호를 지정합니다.

예:

    host1:3000,host2:8000,ctrlhost


imq.cluster.hostname [클러스터의 각 브로커에 대해 독립적으로 지정할 수 있습니다.]

문자열 

없음 

cluster 연결 서비스에 대한 호스트 이름 또는 IP 주소

이 등록 정보를 지정할 경우 cluster 연결 서비스의 imq.hostname을 무시합니다(표 14–1 참조).

imq.cluster.port

정수 

0

cluster 연결 서비스에 대한 포트 번호

값 0은 포트 번호를 포트 매퍼에서 동적으로 할당하도록 지정합니다.

imq.cluster.transport

문자열 

tcp

cluster 연결 서비스에 대한 네트워크 전송 프로토콜

브로커 간의 암호화된 보안 메시지를 전달하려면 이 등록 정보를 ssl로 설정합니다.

imq.cluster.url, [imqcmd update bkr 명령과 함께 사용할 수 있습니다.]

문자열 

없음 

cluster 구성 파일의 URL(있는 경우)

예:

    http://webserver/imq/cluster.properties


    (웹 서버의 파일인 경우)


    

    

    
file:/net/mfsserver/imq/cluster.properties

    


    

    (공유 드라이브의 파일인 경우)
    


    













imq.cluster.masterbroker





문자열 




없음 




클러스터 마스터 브로커(있는 경우)의 호스트 이름과 포트 번호 


값의 형식은 hostName: portNumber입니다. 여기서 hostName은 마스터 브로커의 호스트 이름이고 portNumber는 포트 매퍼의 포트 번호입니다. 



예: 




    

    
ctrlhost:7676

    


    












 

알파벳 순 브로커 등록 정보 목록



 알파벳 순 브로커 등록 정보 목록은 알파벳 순 브로커 구성 등록 정보 목록이며, 이 장에서 관련 표에 대한 상호 참조를 제공합니다. 

표 14–10  알파벳 순 브로커 등록 정보 목록









등록 정보 




표 













imq.accesscontrol.enabled






표 14–7












imq.accesscontrol.file.filename






표 14–7












imq.audit.enabled






표 14–7












imq.authentication.basic.user_repository






표 14–7












imq.authentication.client.response.timeout






표 14–7












imq.authentication.type






표 14–7












imq.autocreate.destination.isLocalOnly






표 14–3












imq.autocreate.destination.limitBehavior






표 14–3












imq.autocreate.destination.maxBytesPerMsg






표 14–3












imq.autocreate.destination.maxNumMsgs






표 14–3












imq.autocreate.destination.maxNumProducers






표 14–3












imq.autocreate.destination.maxTotalMsgBytes






표 14–3












imq.autocreate.destination.useDMQ






표 14–3












imq.autocreate.queue






표 14–3












imq.autocreate.queue.consumerFlowLimit






표 14–3












imq.autocreate.queue.localDeliveryPreferred






표 14–3












imq.autocreate.queue.maxNumActiveConsumers






표 14–3












imq.autocreate.queue.maxNumBackupConsumers






표 14–3












imq.autocreate.topic






표 14–3












imq.autocreate.topic.consumerFlowLimit






표 14–3












imq.cluster.brokerlist






표 14–9












imq.cluster.hostname






표 14–9












imq.cluster.masterbroker






표 14–9












imq.cluster.port






표 14–9












imq.cluster.transport






표 14–9












imq.cluster.url






표 14–9












imq.destination.DMQ.truncateBody






표 14–2












imq.destination.logDeadMsgs






표 14–8












imq.hostname






표 14–1












imq.imqcmd.password






표 14–7












imq.keystore.file.dirpath






표 14–7












imq.keystore.file.name






표 14–7












imq.keystore.password






표 14–7












imq.keystore.propertyName






표 14–7












imq.log.console.output






표 14–8












imq.log.console.stream






표 14–8












imq.log.file.dirpath






표 14–8












imq.log.file.filename






표 14–8












imq.log.file.output






표 14–8












imq.log.file.rolloverbytes






표 14–8












imq.log.file.rolloversecs






표 14–8












imq.log.level






표 14–8












imq.log.syslog.facility






표 14–8












imq.log.syslog.identity






표 14–8












imq.log.syslog.logconsole






표 14–8












imq.log.syslog.logpid






표 14–8












imq.log.syslog.output






표 14–8












imq.log.timezone






표 14–8












imq.message.expiration.interval






표 14–2












imq.message.max_size






표 14–2












imq.metrics.enabled






표 14–8












imq.metrics.interval






표 14–8












imq.metrics.topic.enabled






표 14–8












imq.metrics.topic.interval






표 14–8












imq.metrics.topic.persist






표 14–8












imq.metrics.topic.timetolive






표 14–8












imq.passfile.dirpath






표 14–7












imq.passfile.enabled






표 14–7












imq.passfile.name






표 14–7












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






표 14–5












imq.persist.file.message.cleanup






표 14–5












imq.persist.file.message.filepool.cleanratio






표 14–5












imq.persist.file.message.max_record_size






표 14–5












imq.persist.file.sync.enabled






표 14–5












imq.persist.jdbc.brokerid






표 14–6












imq.persist.jdbc.closedburl






표 14–6












imq.persist.jdbc.createdburl






표 14–6












imq.persist.jdbc.driver






표 14–6












imq.persist.jdbc.needpassword






표 14–6












imq.persist.jdbc.opendburl






표 14–6












imq.persist.jdbc.password






표 14–6












imq.persist.jdbc.table.IMQCCREC35






표 14–6












imq.persist.jdbc.table.IMQDEST35






표 14–6












imq.persist.jdbc.table.IMQILIST35






표 14–6












imq.persist.jdbc.table.IMQINT35






표 14–6












imq.persist.jdbc.table.IMQMSG35






표 14–6












imq.persist.jdbc.table.IMQPROPS35






표 14–6












imq.persist.jdbc.table.IMQSV35






표 14–6












imq.persist.jdbc.table.IMQTACK35






표 14–6












imq.persist.jdbc.table.IMQTXN35






표 14–6












imq.persist.jdbc.user






표 14–6












imq.persist.store






표 14–4












imq.ping.interval






표 14–1












imq.portmapper.backlog






표 14–1












imq.portmapper.hostname






표 14–1












imq.portmapper.port






표 14–1












imq.resourceState .count






표 14–2












imq.resourceState .threshold






표 14–2












imq.service.activelist






표 14–1












imq.serviceName .accesscontrol.enabled






표 14–7












imq.serviceName .accesscontrol.file.filename






표 14–7












imq.serviceName .authentication.type






표 14–7












imq.serviceName .max_threads






표 14–1












imq.serviceName .min_threads






표 14–1












imq.serviceName .protocolType.hostname






표 14–1












imq.serviceName .protocolType.port






표 14–1












imq.serviceName .threadpool_model






표 14–1












imq.shared.connectionMonitor_limit






표 14–1












imq.system.max_count






표 14–2












imq.system.max_size






표 14–2












imq.transaction.autorollback






표 14–2












imq.user_repository.ldap.base






표 14–7












imq.user_repository.ldap.gidattr






표 14–7












imq.user_repository.ldap.grpbase






표 14–7












imq.user_repository.ldap.grpfilter






표 14–7












imq.user_repository.ldap.grpsearch






표 14–7












imq.user_repository.ldap.memattr






표 14–7












imq.user_repository.ldap.password






표 14–7












imq.user_repository.ldap.principal






표 14–7












imq.user_repository.ldap.propertyName 






표 14–7












imq.user_repository.ldap.server






표 14–7












imq.user_repository.ldap.ssl.enabled






표 14–7












imq.user_repository.ldap.timeout






표 14–7












imq.user_repository.ldap.uidattr






표 14–7












imq.user_repository.ldap.usrfilter






표 14–7