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

13장 명령줄 참조

이 장에서는 Message Queue^TM 명령줄 관리 유틸리티 사용에 대한 참조 정보를 제공합니다. 이 장은 다음 내용으로 구성되어 있습니다.

명령줄 구문

Message Queue 명령줄 유틸리티는 쉘 명령입니다. 유틸리티 이름이 명령이고 하위 명령 또는 옵션은 해당 명령에 전달되는 인수입니다. 별도의 명령을 사용하여 유틸리티를 시작하거나 종료할 필요가 없습니다.

모든 명령줄 유틸리티는 다음과 같은 명령 구문을 공유합니다.

   utilityName [subcommand] [commandArgument] [ [-optionName [optionArgument]] … ]

여기서 utilityName은 다음 중 하나입니다.

imqbrokerd(브로커 유틸리티)
imqcmd(명령 유틸리티)
imqobjmgr(객체 관리자 유틸리티)
imqdbmgr(데이터베이스 관리자 유틸리티)
imqusermgr(사용자 관리자 유틸리티)
imqsvcadmin(서비스 관리자 유틸리티)
imqkeytool(키 도구 유틸리티)

하위 명령 및 명령 수준의 인수(있는 경우)는 모든 옵션과 인수 앞에 와야 합니다. 옵션 자체는 임의 순서대로 나타날 수 있습니다. 모든 하위 명령, 명령 인수, 옵션 및 옵션 인수는 공백으로 구분됩니다. 옵션 인수 값에 공백이 포함되어 있는 경우 전체 값을 따옴표로 묶어야 합니다. 일반적으로 속성, 값 쌍을 따옴표로 묶는 것이 가장 안전합니다.

기본 브로커를 시작하는 다음 명령은 하위 명령절이 없는 명령줄의 예입니다.

   imqbrokerd

다음은 전체 명령줄의 예입니다.

   imqcmd  destroy dst  -t q  -n myQueue  -u admin  -f  -s

이 명령은 myQueue라는 대기열 대상(대상 유형 q)을 완전 삭제합니다. 인증은 사용자 이름 admin에 대해 수행됩니다. 비밀번호를 묻는 메시지가 표시됩니다. 이 명령은 확인 메시지를 표시하지 않고(-f 옵션) 자동 모드로 수행되며 어떠한 출력도 표시하지 않습니다(-s 옵션).

브로커 유틸리티

브로커 유틸리티(imqbrokerd)는 브로커를 시작합니다. 명령줄 옵션은 현재 브로커 세션에 대해서만 브로커 구성 파일의 값을 무시합니다.

표 13–1에서는 imqbrokerd 명령 옵션과 각 옵션으로 대체되는 구성 등록 정보(있는 경우)를 보여줍니다.

표 13–1 브로커 유틸리티 옵션


옵션	대체되는 등록 정보	설명
`-name` `instanceName`	`imq.instancename`	브로커의 인스턴스 이름 동일한 호스트에서 실행 중인 여러 브로커 인스턴스에는 서로 다른 인스턴스 이름이 있어야 합니다. 기본값: `imqbroker`
`-port` `portNumber`	`imq.portmapper.port`	브로커의 포트 매퍼 포트 번호 Message Queue 클라이언트는 이 포트 번호를 사용하여 브로커에 연결합니다. 동일한 호스트에서 실행 중인 여러 브로커 인스턴스에는 서로 다른 포트 매퍼 포트 번호가 있어야 합니다. 기본값: `7676`
`-cluster` `broker1` [ [ `,` `broker2` ] … ]	`imq.cluster.brokerlist`	브로커를 클러스터에 연결 [브로커 클러스터에만 적용] 지정된 브로커는 `imq.cluster.brokerlist` 등록 정보의 목록과 병합됩니다. 각 브로커 인수는 다음 형태 중 하나입니다. `hostName:` `portNumber` `hostName` `:portNumber` `hostName`을 생략하는 경우에는 기본값이 `localhost`입니다. `portNumber`를 생략하는 경우에는 기본값이 `7676`입니다.
`-Dproperty=` `value`	인스턴스 구성 파일의 해당 등록 정보	구성 등록 정보 설정 브로커 구성 등록 정보에 대한 자세한 내용은 14 장, 브로커 등록 정보 참조을 참조하십시오. 주의: 이 옵션을 사용하여 설정한 등록 정보의 형식과 맞춤법에 주의하십시오. 잘못된 값은 알림이나 경고 없이 무시됩니다.
`-reset props`	없음	구성 등록 정보 재설정 브로커의 기존 인스턴스 구성 파일 `config.properties`를 빈 파일로 바꿉니다. 모든 등록 정보에 기본값이 설정됩니다.
`-reset store`	없음	영구 데이터 저장소 재설정 데이터 저장소의 모든 영구 데이터(지속성 메시지, 영구 가입 및 트랜잭션 정보 포함)를 삭제하여 빈 상태에서 브로커 인스턴스를 시작할 수 있도록 합니다. 이후에 다시 시작할 때 영구 저장소가 재설정되지 않도록 하려면 `-reset` 옵션을 지정하지 않고 브로커 인스턴스를 다시 시작합니다. 지속성 메시지 또는 영구 가입만 삭제하려면 `-reset` `messages` 또는 `-reset` `durables`를 대신 사용합니다.
`-reset messages`	없음	데이터 저장소에서 지속성 메시지 삭제
`-reset durables`	없음	데이터 저장소에서 영구 가입 삭제
`-backup` `fileName`	없음	구성 변경 레코드를 파일로 백업 자세한 내용은 구성 변경 기록 관리를 참조하십시오.
`-restore` `fileName`	없음	백업 파일에서 구성 변경 레코드 복원 `-backup` 옵션을 사용하여 백업 파일을 미리 작성해 두어야 합니다. 자세한 내용은 구성 변경 기록 관리를 참조하십시오.
`-remove instance`	없음	브로커 인스턴스 제거 [`-force` 옵션을 함께 지정한 경우가 아니면 사용자의 확인이 필요합니다.] 인스턴스 구성 파일, 로그 파일, 영구 저장소 및 인스턴스와 관련된 기타 파일 및 디렉토리를 삭제합니다.
`-password` `keyPassword`	`imq.keystore.password`	SSL 인증서 키 저장소의 비밀번호 [이 옵션은 더 이상 사용되지 않으며 추후에 제거될 것입니다. 비밀번호를 생략하거나(대화식으로 비밀번호를 묻는 메시지 표시) `-passfile` 옵션을 사용하여 비밀번호를 포함하는 파일을 지정합니다. ]
`-dbuser` `userName`	`imq.persist.jdbc.user`	JDBC 기반 영구 데이터 저장소의 사용자 이름
`-dbpassword` `dbPassword`	`imq.persist.jdbc.password`	JDBC 기반 영구 데이터 저장소의 비밀번호
`-ldappassword` `ldapPassword`	`imq.user_repository.ldap.password`	LDAP 사용자 저장소의 비밀번호
`-passfile` `filePath`	`imq.passfile.enabledimq.passfile.dirpathimq.passfile.name`	비밀번호 파일 위치 브로커의 `imq.passfile.enabled` 등록 정보를 `true`로 설정하고 `imq.passfile.dirpath`를 비밀번호 파일을 포함하는 경로로 설정하며 `imq.passfile.name`을 파일 이름 자체로 설정합니다. 자세한 내용은 비밀번호 파일을 참조하십시오.
`-shared`	`imq.jms.threadpool_model`	공유 스레드 풀 모델을 사용하여 `jms` 연결 서비스 구현 연결 간에 예외 스레드가 공유되므로 지원되는 연결 수가 증가합니다. 브로커의 `imq.jms.threadpool_model` 등록 정보를 `shared`로 설정합니다.
`-javahome` `path`	없음	대체 Java Runtime 위치 기본 동작: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다.
`-vmargs` `arg1` [ [ `arg2` ] … ]	없음	인수를 Java 가상 머신에 전달 인수는 공백으로 구분됩니다. 두 개 이상의 인수를 전달하거나 공백을 포함하는 인수를 전달하려면 인수 목록을 따옴표로 묶습니다. VM 인수는 명령줄을 통해서만 전달할 수 있으며, 인스턴스 구성 파일에는 관련 구성 등록 정보가 없습니다.
`-license` [ `licenseName` ]	없음	로드할 사용권이 설치된 Message Queue 제품의 기본값과 다를 경우: `pe`: 기본 기능 사용 플랫폼판 `try`: 엔터프라이즈 기능 사용 플랫폼판(90일 시험 사용) `unl`: 엔터프라이즈판 사용권 이름이 지정되지 않은 경우에는 시스템에 설치된 모든 사용권이 나열됩니다.
`-upgrade-store-nobackup`	없음	Message Queue 3.5 또는 3.5 SP`x`로 업그레이드할 때 호환되지 않는 버전의 이전 데이터 저장소를 자동으로 제거 자세한 내용은 Message Queue 설치 설명서를 참조하십시오.
`-force`	없음	사용자 확인 없이 작업 수행 이 옵션은 일반적으로 확인을 필요로 하는 `-remove` `instance` 및 `-upgrade-store-nobackup` 옵션에만 적용됩니다.
`-loglevel` `level`	`imq.broker.log.level`	로깅 수준: `NONE` `ERROR` `WARNING` `INFO` 기본값: `INFO`
`-metrics` `interval`	`imq.metrics.interval`	브로커 메트릭 로깅 간격(초)
`-tty`	`imq.log.console.output`	모든 메시지를 콘솔에 기록 브로커의 `imq.log.console.output` 등록 정보를 `ALL`로 설정합니다. 지정하지 않을 경우 오류 및 경고 메시지만 기록됩니다.
`-s` \| `-silent`	`imq.log.console.output`	자동 모드(콘솔에 기록하지 않음) 브로커의 `imq.log.console.output` 등록 정보를 `NONE`으로 설정합니다.
`-version`	없음	버전 정보 표시 [명령줄에 지정된 다른 옵션은 무시됩니다. ]
`-h` \| `-help`	없음	사용 도움말 표시

명령 유틸리티

명령 유틸리티(imqcmd)는 브로커, 연결 서비스, 연결, 물리적 대상, 영구 가입 및 트랜잭션을 관리하는 데 사용됩니다.

모든 imqcmd 명령은 하위 명령을 포함해야 합니다. 단, -v 또는 -h 옵션을 사용하여 제품 버전 정보 또는 사용 도움말을 표시하는 경우는 제외됩니다. 다음은 사용 가능한 하위 명령 목록이며 각각의 하위 명령에 대해서는 다음 절에서 자세히 설명합니다. 모든 경우에 하위 명령에서 브로커 주소(-b 옵션)를 받으며 호스트 이름 또는 포트 번호가 지정되지 않으면 값 localhost 및 7676을 기본값으로 간주합니다.

브로커 관리
`shutdown bkr`	브로커 종료
`restart bkr`	브로커 다시 작동
`pause bkr`	브로커 일시 중지
`resume bkr`	브로커 다시 시작
`update bkr`	브로커 등록 정보 설정
`reload cls`	클러스터 구성 다시 로드
`query bkr`	브로커 등록 정보 값 나열
`metrics bkr`	브로커 메트릭 표시
연결 서비스 관리
`pause svc`	연결 서비스 일시 중지
`resume svc`	연결 서비스 다시 시작
`update svc`	연결 서비스 등록 정보 설정
`list svc`	브로커에서 사용할 수 있는 연결 서비스 나열
`query svc`	연결 서비스 등록 정보 값 나열
`metrics svc`	연결 서비스 메트릭 표시
연결 관리
`list cxn`	브로커 연결 나열
`query cxn`	연결 정보 표시
물리적 대상 관리
`create dst`	물리적 대상 작성
`destroy dst`	물리적 대상 완전 삭제
`pause dst`	물리적 대상에 대한 메시지 전달 일시 중지
`resume dst`	물리적 대상에 대한 메시지 전달 다시 시작
`update dst`	물리적 대상 등록 정보 설정
`purge dst`	물리적 대상에서 모든 메시지 제거
`compact dst`	물리적 대상 압축
`list dst`	물리적 대상 나열
`query dst`	물리적 대상 등록 정보 값 나열
`metrics dst`	물리적 대상 메트릭 표시
영구 가입 관리
`destroy dur`	영구 가입 완전 삭제
`purge dur`	영구 가입에 대한 모든 메시지 제거
`list dur`	주제에대한 영구 가입 나열
트랜잭션 관리
`commit txn`	트랜잭션 완결
`rollback txn`	트랜잭션 롤백
`list txn`	브로커에서 추적 중인 트랜잭션 나열
`query txn`	트랜잭션 정보 표시

브로커 관리

명령 유틸리티를 사용하여 브로커를 시작할 수 없습니다. 대신, 브로커 유틸리티(imqbrokerd)를 사용하십시오. 브로커가 시작된 후에는 표 13–2에 나열된 imqcmd 하위 명령을 사용하여 브로커를 관리 및 제어할 수 있습니다.

표 13–2 브로커 관리에 대한 명령 유틸리티 하위 명령


구문	설명
`shutdown bkr` [`-b` `hostName` `:portNumber`]	브로커 종료
`restart bkr` [`-b` `hostName` `:portNumber`]	브로커 다시 시작 브로커를 종료하고 처음 시작했을 때 지정했던 것과 동일한 옵션을 사용하여 다시 시작합니다.
`pause bkr` [`-b` `hostName` `:portNumber`]	브로커 일시 중지 자세한 내용은 브로커 일시 중지를 참조하십시오.
`resume bkr` [`-b` `hostName` `:portNumber`]	브로커 다시 시작
`update bkr` [`-b` `hostName` `:portNumber`] `-o` `property1=` `value1` [ [`-o` `property2` `=value2`] … ]	브로커 등록 정보 설정 브로커 등록 정보에 대한 자세한 내용은 14 장, 브로커 등록 정보 참조을 참조하십시오.
`reload cls`	클러스터 구성 다시 로드 [브로커 클러스터에만 적용] 모든 지속성 정보를 최신 상태로 유지합니다.
`query bkr` `-b` `hostName` `:portNumber`	브로커 등록 정보 값 나열 또한 클러스터 내 지정된 브로커에 연결된 모든 실행 중인 브로커를 나열합니다.
`metrics bkr` [`-b` `hostName` `:portNumber`] [`-m` `metricType`] [`-int` `interval`] [`-msp` `numSamples`]	브로커 메트릭 표시 `-m` 옵션은 표시할 메트릭 유형을 지정합니다. `ttl`: 브로커에 유입 및 유출되는 메시지와 패킷 `rts`: 브로커에 유입 및 유출되는 메시지와 패킷의 초당 속도 `cxn`: 연결, 가상 메모리 힙 및 스레드 기본값: `ttl` `-int` 옵션은 메트릭 표시 간격(초)을 지정합니다. 기본값: `5` `-msp` 옵션은 표시할 샘플 수를 지정합니다. 기본값: 무제한(지정되지 않음)

연결 서비스 관리

표 13–3에서는 연결 서비스를 관리하기 위한 imqcmd 하위 명령을 나열합니다.

표 13–3 연결 서비스 관리에 대한 명령 유틸리티 하위 명령


구문	설명
`pause svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`]	연결 서비스 일시 중지 `admin` 연결 서비스는 일시 중지할 수 없습니다.
`resume svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`]	연결 서비스 다시 시작
`update svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`] `-o` `property1=` `value1` [ [`-o` `property2` `=value2`] … ]	연결 서비스 등록 정보 설정 연결 서비스 등록 정보에 대한 자세한 내용은 연결 등록 정보를 참조하십시오.
`list svc` [`-b` `hostName` `:portNumber`]	브로커에서 사용할 수 있는 연결 서비스 나열
`query svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`]	연결 서비스 등록 정보 값 나열
`metrics svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`] [`-m` `metricType`] [`-int` `interval`] [`-msp` `numSamples`]	연결 서비스 메트릭 표시 `-m` 옵션은 표시할 메트릭 유형을 지정합니다. `ttl`: 브로커에 유입 및 유출되는 메시지와 패킷의 메트릭을 지정된 연결 서비스를 통해 표시 `rts`: 브로커에 메시지와 패킷이 유입 및 유출되는 초당 속도를 지정된 연결 방식으로 표시 `cxn`: 연결, 가상 메모리 힙 및 스레드 기본값: `ttl` `-int` 옵션은 메트릭 표시 간격(초)을 지정합니다. 기본값: `5` `-msp` 옵션은 표시할 샘플 수를 지정합니다. 기본값: 무제한(지정되지 않음)

연결 관리

표 13–4에서는 연결을 관리하기 위한 imqcmd 하위 명령을 나열합니다.

표 13–4 연결 서비스 관리에 대한 명령 유틸리티 하위 명령


구문	설명
`list cxn` [`-svn` `serviceName`] [`-b` `hostName:` `portNumber`]	브로커에 대한 연결 나열 지정된 연결 서비스에 대한 브로커의 모든 연결을 나열합니다. 연결 서비스를 지정하지 않는 경우 모든 연결이 나열됩니다.
`query cxn` `-n` `connectionID` [`-b` `hostName:` `portNumber`]	연결 정보 표시

물리적 대상 관리

표 13–5에서는 물리적 대상을 관리하기 위한 imqcmd 하위 명령을 나열합니다. -t(대상 유형) 옵션은 언제나 두 가지 값 중 하나를 사용할 수 있습니다.

q: 대기열 대상

t: 주제 대상

표 13–5 물리적 대상 관리에 대한 명령 유틸리티 하위 명령


구문	설명
`create dst` `-t` `destType` `-n` `destName` [`-o` `property1` `=value1`] [ [ `-o` `property2` `=value2`] … ]	물리적 대상 작성 [마스터 브로커를 일시적으로 사용할 수 없는 클러스터에서는 수행할 수 없습니다.] 대상 이름 `destName`에는 영숫자 문자(공백 없음)만 사용할 수 있으며 영문자, 밑줄 문자(`_`) 또는 달러 기호(`$`) 문자로 시작해야 합니다. 대상 이름은 `mq`로 시작할 수 없습니다.
`destroy dst` `-t` `destType` `-n` `destName`	물리적 대상 완전 삭제 이 작업은 사용 불능 메시지 대기열처럼 시스템에서 생성된 대상에는 적용할 수 없습니다.
`pause dst` [`-t` `destType` `-n` `destName`] [`-pst` `pauseType`]	물리적 대상에 대한 메시지 전달 일시 중지 `-t` 및 `-n` 옵션에서 지정한 물리적 대상에 대해 메시지 전달을 일시 중지합니다. 이 옵션을 지정하지 않으면 모든 대상이 일시 중지됩니다. `-pst` 옵션은 일시 중지할 메시지 전달의 유형을 지정합니다. `CONSUMERS`: 메시지 사용자로의 전달 일시 중지 `PRODUCERS`: 메시지 생성자로의 전달 일시 중지 `ALL`: 모든 메시지 전달 일시 중지 기본값: `ALL`
`resume dst` [`-t` `destType` `-ndestName`]	물리적 대상에 대한 메시지 전달 다시 시작 `-t` 및 `-n` 옵션을 통해 지정한 물리적 대상에 대해 메시지 전달을 다시 시작합니다. 이 옵션을 지정하지 않을 경우 모든 대상이 다시 시작됩니다.
`update dst` `-t` `destType` `-n` `destName` `-o` `property1=` `value1` [ [ `-o` `property2` `=value2`] … ]	물리적 대상 등록 정보 설정 물리적 대상 등록 정보에 대한 자세한 내용은 15 장, 물리적 대상 등록 정보 참조을 참조하십시오.
`purge dst` `-t` `destType` `-n` `destName`	물리적 대상에서 모든 메시지 제거
`compact dst` [`-t` `destType` `-n` `destName`]	물리적 대상 압축 `-t` 및 `-n` 옵션을 통해 지정하는 물리적 대상에 대한 파일 기반 영구 데이터 저장소를 압축합니다. 이 옵션을 지정하지 않을 경우 모든 대상이 압축됩니다. 대상을 압축하려면 먼저 대상을 일시 중지해야 합니다.
`list dst` [`-t` `destType`] [`-tmp`]	물리적 대상 나열 `-t` 옵션을 통해 지정된 유형의 모든 물리적 대상을 나열합니다. 대상 유형을 지정하지 않을 경우 대기열 및 주제 대상이 모두 나열됩니다. `-tmp` 옵션을 지정하는 경우 임시 대상도 나열됩니다.
`query dst` `-t` `destType` `-n` `destName`	물리적 대상 등록 정보 값 나열
`metrics dst` `-t` `destType` `-n` `destName` [`-m` `metricType`] [`-int` `interval`] [`-msp` `numSamples`]	물리적 대상 메트릭 표시 `-m` 옵션은 표시할 메트릭 유형을 지정합니다. `ttl`: 대상에 유입 및 유출되고 메모리에 있는 메시지와 패킷 `rts`: 브로커에 유입 및 유출되는 메시지와 패킷의 초당 속도(기타 속도 정보와 함께 표시) `con`: 메시지 사용자 관련 메트릭 `dsk`: 디스크 사용량 기본값: `ttl` `-int` 옵션은 메트릭 표시 간격(초)을 지정합니다. 기본값: `5` `-msp` 옵션은 표시할 샘플 수를 지정합니다. 기본값: 무제한(지정되지 않음)

영구 가입 관리

표 13–6에서는 영구 가입을 관리하기 위한 imqcmd 하위 명령을 나열합니다.

표 13–6 영구 가입 관리에 대한 명령 유틸리티 하위 명령


구문	설명
`destroy dur` `-c` `clientID` `-n` `subscriberName`	영구 가입 완전 삭제 [마스터 브로커를 일시적으로 사용할 수 없는 클러스터에서는 수행할 수 없습니다.]
`purge dur` `-c` `clientID` `-n` `subscriberName`	영구 가입에 대한 모든 메시지 제거
`list dur` `-d` `topicName`	주제에 대한 영구 가입 나열

트랜잭션 관리

표 13–7에서는 트랜잭션을 관리하기 위한 imqcmd 하위 명령을 나열합니다.

표 13–7 트랜잭션 관리에 대한 명령 유틸리티 하위 명령


구문	설명
`commit txn` `-n` `transactionID`	트랜잭션 완결
`rollback txn` `-n` `transactionID`	트랜잭션 롤백
`list txn`	브로커에서 추적 중인 트랜잭션 나열
`query txn` `-n` `transactionID`	트랜잭션 정보 표시

일반 명령 유틸리티 옵션

표 13–8에 나열된 추가 옵션은 imqcmd 명령의 모든 하위 명령에 적용할 수 있습니다.

표 13–8 일반 명령 유틸리티 옵션


옵션	설명
`-secure`	`ssladmin` 연결 서비스를 사용하는 브로커에 보안 연결 사용
`-u` `userName`	인증에 사용되는 사용자 이름 이 옵션을 생략하면 명령 유틸리티에서 대화식으로 사용자 이름을 묻는 메시지를 표시합니다.
`-p` `password`	인증에 사용되는 비밀번호 [이 옵션은 더 이상 사용되지 않으며 추후에 제거될 것입니다. 비밀번호를 생략하거나(대화식으로 비밀번호를 묻는 메시지 표시) `-passfile` 옵션을 사용하여 비밀번호를 포함하는 파일을 지정합니다. ]
`-passfile` `path`	비밀번호 파일의 위치 자세한 내용은 비밀번호 파일을 참조하십시오.
`-rtm` `timeoutInterval`	초기 시간 초과 간격(초) 요청을 다시 시도하기 전에 명령 유틸리티가 브로커로부터 응답을 기다리는 초기 시간 길이입니다. 각 후속 재시도에서는 이 초기 간격의 배수가 되는 시간 초과 간격을 사용합니다. 기본값: `10`
`-rtr` `numRetries`	브로커 요청 시간이 초과된 후 시도할 재시도 횟수 기본값: `5`
`-javahome` `path`	대체 Java Runtime 위치 기본 동작: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다.
`-f`	사용자 확인 없이 작업 수행
`-s`	자동 모드(출력이 표시되지 않음)
`-v`	버전 정보 표시 [명령줄에 지정된 다른 옵션은 무시됩니다. ] ^, [사용자 이름과 비밀번호가 필요하지 않음]
`-h`	사용 도움말 표시^,
`-H`	속성 목록과 예를 포함하여 자세한 사용 도움말을 표시합니다.^,

객체 관리자 유틸리티

객체 관리자 유틸리티(imqobjmgr)는 Message Queue 관리 대상 객체를 만들고 관리합니다. 표 13–9에서는 사용 가능한 하위 명령을 나열합니다.

표 13–9 객체 관리자 하위 명령


하위 명령	설명
`add`	객체 저장소에 관리 객체 추가
`delete`	객체 저장소에서 관리 객체 삭제
`list`	객체 저장소의 관리 객체 나열
`query`	관리 객체 정보 표시
`update`	관리 객체 수정

표 13–10에서는 imqobjmgr 명령에 대한 옵션을 나열합니다.

표 13–10 객체 관리자 옵션


옵션	설명
`-l` `lookupName`	관리 대상 객체의 JNDI 조회 이름
`-j` `attribute=` `value`	JNDI 객체 저장소 속성( 객체 저장소 참조)
`-t` `objectType`	관리 객체 유형: `q`: 대기열 대상 `t`: 주제 대상 `cf`: 연결 팩토리 `qf`: 대기열 연결 팩토리 `tf`: 주제 연결 팩토리 `xcf`: 분산 트랜잭션의 연결 팩토리 `xqf`: 배포 트랜잭션의 대기열 연결 팩토리 `xtf`: 분산 트랜잭션의 주제 연결 팩토리 `e`: SOAP 종점(Java 클라이언트용 Message Queue 개발 안내서 참조)
`-o` `attribute=` `value`	관리 대상 객체 속성( 관리 객체 속성 및 16 장, 관리 객체 속성 참조 참조)
`-r` `readOnlyState`	관리 객체가 읽기 전용입니까? 값이 `true`이면 클라이언트에서 객체 속성을 수정할 수 없습니다. 기본값: `false`
`-i` `fileName`	하위 명령절 전체 또는 일부를 포함하는 명령 파일의 이름
`-pre`	명령을 수행하지 않고 결과 미리 보기 이 옵션은 기본 속성의 값을 확인할 때 유용합니다.
`-javahome` `path`	대체 Java Runtime 위치 기본 동작: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다.
`-f`	사용자 확인 없이 작업 수행
`-s`	자동 모드(출력이 표시되지 않음)
`-v`	버전 정보 표시 [명령줄에 지정된 다른 옵션은 무시됩니다. ]
`-h`	사용 도움말 표시
`-H`	속성 목록과 예를 포함하여 자세한 사용 도움말 표시

데이터베이스 관리자 유틸리티

데이터베이스 관리자 유틸리티(imqdbmgr)는 JDBC 기반 영구 데이터 저장소의 데이터베이스 스키마를 설정합니다. 이 유틸리티를 사용하여 손상된 Message Queue 데이터베이스 테이블을 삭제하거나 데이터 저장소를 변경할 수 있습니다. 표 13–11에서는 사용 가능한 하위 명령을 나열합니다.

표 13–11 데이터베이스 관리자 하위 명령


하위 명령	설명
`create all`	새 데이터베이스와 영구 저장소 스키마 만들기 내장 데이터베이스 시스템에 사용됩니다. 브로커 등록 정보 `imq.persist.jdbc.createdburl`을 지정해야 합니다.
`create tbl`	기존 데이터베이스의 영구 저장소 스키마 만들기 외부 데이터베이스 시스템에 사용됩니다.
`delete tbl`	현재 영구 저장소에서 Message Queue 데이터베이스 테이블 삭제
`delete oldtbl`	이전 버전 영구 저장소에서 Message Queue 데이터베이스 테이블 삭제 영구 저장소가 현재 버전의 Message Queue로 자동 마이그레이션된 후에 사용됩니다.
`recreate tbl`	영구 저장소 스키마 다시 만들기 현재의 영구 저장소에서 모든 기존 Message Queue 데이터베이스 테이블을 삭제하고 스키마를 다시 만듭니다.
`reset lck`	영구 저장소 잠금 재설정 영구 저장소 데이터베이스를 다른 프로세스에서 사용할 수 있도록 잠금을 재설정합니다.

표 13–12에서는 imqdbmgr 명령에 대한 옵션을 나열합니다.

표 13–12 데이터베이스 관리자 옵션


옵션	설명
`-b` `instanceName`	브로커의 인스턴스 이름
`-Dproperty=` `value`	브로커 구성 등록 정보 설정 지속성 관련 브로커 구성 등록 정보에 대한 자세한 내용은 지속성 등록 정보를 참조하십시오. 주의: 이 옵션을 사용하여 설정한 등록 정보의 형식과 맞춤법에 주의하십시오. 잘못된 값은 알림이나 경고 없이 무시됩니다.
`-u` `name`	인증에 사용되는 사용자 이름
`-p` `password`	인증에 사용되는 비밀번호 [이 옵션은 더 이상 사용되지 않으며 추후에 제거될 것입니다. 비밀번호를 생략하거나(대화식으로 비밀번호를 묻는 메시지 표시) `-passfile` 옵션을 사용하여 비밀번호를 포함하는 파일을 지정합니다. ]
`-passfile` `path`	비밀번호 파일의 위치 자세한 내용은 비밀번호 파일을 참조하십시오.
`-v`	버전 정보 표시 [명령줄에 지정된 다른 옵션은 무시됩니다. ]
`-h`	사용 도움말 표시

사용자 관리자 유틸리티

사용자 관리자 유틸리티(imqusermgr)는 플랫 파일 사용자 저장소를 채우거나 편집하는 데 사용됩니다. 이 유틸리티는 브로커가 설치된 위치와 동일한 호스트에서 실행되어야 합니다. 브로커별 사용자 저장소가 아직 없으면 먼저 해당 브로커 인스턴스를 시작하여 사용자 저장소를 만들어야 합니다. 또한 저장소에 쓸 수 있는 적절한 권한도 필요합니다. 즉, Solaris 및 Linux 플랫폼의 경우에는 해당 브로커 인스턴스를 처음으로 만든 사용자나 루트 사용자여야 합니다.

표 13–13에서는 imqusermgr 명령에 사용 가능한 하위 명령을 나열합니다. 이 경우, -i 옵션은 명령의 사용자 저장소가 적용되는 브로커의 인스턴스 이름을 지정합니다. 지정하지 않을 경우 기본 이름 imqbroker가 사용됩니다.

표 13–13 사용자 관리자 하위 명령


구문	설명
`add` [`-i` `instanceName`] `-u` `userName` `-p` `password` [`-g` `group`]	사용자 및 비밀번호를 저장소에 추가 선택적 `-g` 옵션은 현재 사용자를 할당할 그룹을 지정합니다. `admin` `user` `anonymous`
`delete` [`-i` `instanceName`] `-u` `userName`	저장소에서 사용자 삭제
`update` [`-i` `instanceName`] `-u` `userName` `-p` `password` [`-a` `activeState`] `update` [`-i` `instanceName`] `-u` `userName` `-a` `activeState` [`-p` `password`]	사용자의 비밀번호 또는 활성 상태 설정(또는 모두) `-a` 옵션은 사용자를 활성화할지(`true`) 비활성화할지(`false`) 여부를 지정하는 부울 값을 사용합니다. 기본값: `true`
`list` [`-i` `instanceName`] [`-u` `userName`]	사용자 정보 표시 사용자 이름을 지정하지 않을 경우 저장소의 모든 사용자가 나열됩니다.

또한 표 13–14에 나열된 옵션은 imqusermgr 명령의 모든 하위 명령에 적용할 수 있습니다.

표 13–14 일반 사용자 관리자 옵션


옵션	설명
`-f`	사용자 확인 없이 작업 수행
`-s`	자동 모드(출력이 표시되지 않음)
`-v`	버전 정보 표시 [명령줄에 지정된 다른 옵션은 무시됩니다. ]
`-h`	사용 도움말 표시

서비스 관리자 유틸리티

서비스 관리자 유틸리티(imqsvcadmin)는 브로커를 Windows 서비스로 설치합니다. 표 13–15에서는 사용 가능한 하위 명령을 나열합니다.

표 13–15 서비스 관리자 하위 명령


하위 명령	설명
`install`	서비스 설치
`remove`	서비스 제거
`query`	시작 옵션 표시 시작 옵션에는 서비스의 수동 또는 자동 시작, 위치, Java Runtime 위치, 시작할 때 브로커에 전달되는 인수 값이 포함됩니다(표 13–16 참조).

표 13–16에서는 imqsvcadmin 명령에 대한 옵션을 나열합니다.

표 13–16 서비스 관리자 옵션


옵션	설명
`-javahome` `path`	대체 Java Runtime 위치 기본 동작: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다.
`-jrehome` `path`	대체 JRE(Java Runtime Environment) 위치
`-vmargs` `arg1` [ [`arg2` ] … ]	브로커 서비스를 실행 중인 Java 가상 머신(JVM)에 전달할 추가 인수 [이러한 인수는 서비스의 등록 정보 창(Windows 관리 도구 제어판의 서비스 도구)에 있는 일반 탭의 시작 매개 변수 필드에서도 지정할 수 있습니다. ] 예: `imqsvcadmin install -vmargs "-Xms16m -Xmx128m"`
`-args` `arg1` [ [`arg2`] … ]	브로커 서비스에 전달할 추가 명령줄 인수 예: `imqsvcadmin install -args "-passfile` `d:\\imqpassfile"` 브로커 명령줄 인수에 대한 자세한 내용은 브로커 유틸리티를 참조하십시오.
`-h`	사용 도움말 표시 [명령줄에 지정된 다른 옵션은 무시됩니다. ]

-javahome, -vmargs 및 -args 옵션을 사용하여 지정한 모든 정보는 Windows 레지스트리의 다음 경로에 있는 JREHome, JVMArgs 및 ServiceArgs 키 아래에 저장됩니다.

   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\iMQ_Broker\Parameters

키 도구 유틸리티

키 도구 유틸리티(imqkeytool)는 브로커에 대해 자체 서명한 인증서를 생성합니다. 이 인증서는 ssljms, ssladmin 또는 cluster 연결 서비스에 사용할 수 있습니다. 구문은 다음과 같습니다.

   imqkeytool -broker

UNIX 시스템의 경우 superuser(root) 계정에서 이 유틸리티를 실행해야 할 수도 있습니다.