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

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

14장
브로커 등록 정보 참조

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


연결 등록 정보

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

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

등록 정보

유형

기본값

설명

imq.service.activelist

문자열

jms,admin

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

imq.hostname

문자열

사용 가능한 모든 IP 주소

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

imq.portmapper.hostname

문자열

없음

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

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

imq.portmapper.port1

정수

7676

포트 매퍼의 포트 번호

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

imq.serviceName.protocolType.hostname

문자열

없음

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

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

imq.serviceName.protocolType.port

정수

0

연결 서비스의 포트 번호2

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

imq.portmapper.backlog

정수

50

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

imq.serviceName.threadpool_model

문자열

dedicated

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

  dedicated  연결당 받는 메시지와 보내는 메시지에 하나씩 두 개의 전용 스레드

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

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

imq.serviceName.min_threads

정수

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

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

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

기본값은 표시된 바와 같이 연결 서비스에 따라 다릅니다.

imq.serviceName.max_threads

정수

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

이 스레드 수를 초과하면 명명된 연결 서비스가 사용할 수 있는 신규 스레드가 더 이상 스레드 풀에 추가되지 않습니다. 이 수는 0보다 크고 min_threads 값보다 커야 합니다.

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

imq.shared.connectionMonitor_limit

정수

Solaris: 512
Linux: 512
Windows: 64

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

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

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

imq.ping.interval

정수

120

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

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

1imqcmd update bkr 명령과 함께 사용할 수 있습니다.

2jms, ssljms, admin 및 ssladmin 서비스에만 해당. httpjms 및 httpsjms 서비스 구성에 대한 자세한 내용은 부록 C, "HTTP/HTTPS 지원"을 참조하십시오.

3jms 및 admin 서비스에만 해당

4공유 스레딩 모델에만 해당


라우팅 등록 정보

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

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

등록 정보

유형

기본값

설명

imq.system.max_count1

정수

-1

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

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

imq.system.max_size1

문자열

-1

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

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

  b  바이트
  k  킬로바이트(1024바이트)
  m  메가바이트(1024 x 1024 = 1,048,576바이트)

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

예를 들면 다음과 같습니다.

  1600   1600바이트
  1600b  1600바이트
  16k    16킬로바이트(= 16,384바이트)
  16m    16메가바이트(= 16,777,216바이트)
  -1     제한 없음

imq.message.max_size1

문자열

70m

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

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

imq.message.expiration.interval

정수

60

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

imq.resourceState.threshold

정수

green:     0

yellow:   80

orange:   90

red:      98

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

imq.resourceState.count

정수

green:  5000

yellow:  500

orange:   50

red:       0

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

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

imq.destination.DMQ.truncateBody1

부울

false

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

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

imq.transaction.autorollback

부울

false

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

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

1imqcmd update bkr 명령과 함께 사용할 수 있습니다.

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

등록 정보

유형

기본값

설명

imq.autocreate.queue1,2

부울

true

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

imq.autocreate.topic3

부울

true

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

imq.autocreate.destination.maxNumMsgs

정수

100000

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

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

imq.autocreate.destination.maxBytesPerMsg

문자열

10k

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

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

  b  바이트
  k  킬로바이트(1024바이트)
  m  메가바이트(1024 x 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.maxNumActiveConsumers2

정수

1

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

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

imq.autocreate.queue.maxNumBackupConsumers2

정수

0

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

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

imq.autocreate.queue.consumerFlowLimit2

정수

1000

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

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

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

imq.autocreate.topic.consumerFlowLimit3

정수

1000

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

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

imq.autocreate.destination.isLocalOnly

부울

false

로컬에만 전달합니까?

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

imq.autocreate.queue.localDeliveryPreferred2

부울

false

로컬 전달을 선호합니까?

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

imq.autocreate.destination.useDMQ

부울

true

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

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

1imqcmd update bkr 명령과 함께 사용할 수 있습니다.

2대기열 대상에만 해당

3주제 대상에만 해당


지속성 등록 정보

Message Queue는 영구 데이터 저장소의 파일 기반 및 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 x 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로 설정하면 시스템 충돌로 인한 데이터 손실이 없어지지만 성능이 저하됩니다.

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

JDBC 기반 지속성

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

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

등록 정보

설명

예

imq.persist.jdbc.brokerid

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

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

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

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

이 등록 정보는 Message Queue 데이터베이스 관리자 유틸리티(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

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

이 등록 정보는 비밀번호 파일에만 지정해야 합니다.

 

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),
   
primaryKey(DID))

imq.persist.jdbc.table.IMQINT35

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

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

imq.persist.jdbc.table.IMQMSG35

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

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

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

imq.persist.jdbc.table.IMQPROPS35

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

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

imq.persist.jdbc.table.IMQILIST35

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

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

imq.persist.jdbc.table.IMQTXN35

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

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

imq.persist.jdbc.table.IMQTACK35

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

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


보안 등록 정보

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

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

등록 정보

유형

기본값

설명

imq.accesscontrol.enabled

부울

true

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

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

imq.serviceName.accesscontrol.enabled

부울

없음

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

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

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

imq.accesscontrol.file.filename

문자열

accesscontrol.properties

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

파일 이름은 액세스 제어 디렉토리의 상대 경로를 지정합니다(부록 A 참조).

imq.serviceName.accesscontrol.file.filename

문자열

없음

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

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

파일 이름은 액세스 제어 디렉토리의 상대 경로를 지정합니다(부록 A 참조).

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 참조

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

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 참조

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

imq.keystore.file.name

문자열

키 저장소

키 저장소 파일의 이름

imq.keystore.password

문자열

없음

키 저장소 파일의 비밀번호

이 등록 정보는 비밀번호 파일에만 지정해야 합니다.

imq.audit.enabled

부울

false

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

이 옵션은 Message Queue 엔터프라이즈판에만 적용됩니다.


모니터링 등록 정보

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

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

등록 정보

유형

기본값

설명

imq.log.level1

문자열

INFO

로깅 수준

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

  ERROR
  WARNING
  INFO

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

imq.destination.logDeadMsgs1

부울

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 참조

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

imq.log.file.filename

문자열

log.txt

로그 파일의 이름

imq.log.file.output

문자열

ALL

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

  NONE
  ERROR
  WARNING
  INFO
  ALL

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

imq.log.file.rolloverbytes1

정수

-1

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

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

imq.log.file.rolloversecs1

정수

604800(1주)

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

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

imq.log.syslog.output2

문자열

ERROR

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

  NONE
  ERROR
  WARNING
  INFO
  ALL

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

imq.log.syslog.facility2

문자열

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.identity2

문자열

imqbrokerd_${imq.instanceName}

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

imq.log.syslog.logpid2

부울

true

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

imq.log.syslog.logconsole2

부울

false

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

imq.log.timezone

문자열

지역 표준 시간대

로그 타임스탬프의 시간대

가능한 값은 java.util.TimeZone.getTimeZone 메소드에서 사용되는 것과 동일한 값입니다. 예를 들면 다음과 같습니다.

  GMT
  GMT-8:00
  
미국/LA
  유럽/로마
  아시아/도쿄

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

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

1imqcmd update bkr 명령과 함께 사용할 수 있습니다.

2Solaris 플랫폼에만 해당


클러스터 구성 등록 정보

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

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

등록 정보

유형

기본값

설명

imq.cluster.brokerlist1

문자열

없음

브로커 주소 목록

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

  host1:3000,host2:8000,ctrlhost

imq.cluster.hostname2

문자열

없음

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

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

imq.cluster.port2

정수

0

cluster 연결 서비스의 포트 번호

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

imq.cluster.transport1

문자열

tcp

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

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

imq.cluster.url1,3

문자열

없음

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

예를 들면 다음과 같습니다.

  http://webserver/imq/cluster.properties

(웹 서버의 파일인 경우)

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

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

imq.cluster.masterbroker1

문자열

없음

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

값의 형식은 hostName:portNumber입니다. 여기서 hostName은 마스터 브로커의 호스트 이름이고 portNumber는 포트 매퍼의 포트 번호입니다. 예를 들면 다음과 같습니다.

  ctrlhost:7676

1클러스터의 모든 브로커 값이 동일해야 합니다.

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

3imqcmd update bkr 명령과 함께 사용할 수 있습니다.


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

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

표 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



이전      목차      색인      다음     


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